Quickstart

The fastest way to see Willow is to run a verified query against data that’s already indexed. You’ll need a free account — the free tier doesn’t require a card.

1. Query in the browser

1. Sign up for a free account at the dashboard and sign in.
2. Go to Subgroves and pick one — for example the Uniswap V3 ETH/USDC indexing subgrove.
3. Run a SQL or GraphQL query, or open one of the instant charts.
4. Look for the ✓ Willow verified line under the result — that means the data came with Merkle proofs and they checked out against the network’s committed state.

That’s the whole idea: a result you can verify, not just trust.

2. Query from code

Create an API key in the dashboard, then install a client — the same proofs are verified locally for you. Reads are authenticated with your key and metered against your plan.

npm install @willow-network/sdk

import { WillowClient } from '@willow-network/sdk';

const client = new WillowClient({
  apiUrl: 'https://api.willow.tech',
  apiKey: process.env.WILLOW_API_KEY,
});

// Read a record — the SDK verifies the Merkle proof before returning it.
const data = await client.get('my-subgrove', 'users', 'user-1');
console.log(data);

If the proof doesn’t verify, the SDK throws instead of handing you unverified data — verification is on by default.

3. Index your own data

When you’re ready to create your own dataset, head to Create a subgrove.

Endpoints

Environment	API endpoint
Hosted	https://api.willow.tech
Local devnet	http://localhost:3031

See the SDKs overview for clients in Rust, Python, Go, Swift, and React.