Quickstart
Every route is a GET request that returns JSON. These examples use https://api.sonaintel.com as the base URL.
1. List the chains
curl -s "https://api.sonaintel.com/v1/chains"This route is free, takes no query string and returns the chains Sona serves.
{
"data": {
"kind": "chains",
"chains": [
{ "id": "eip155:1", "name": "Ethereum", "symbol": "ETH", "decimals": 18, "block_time_ms": 12000 },
{ "id": "eip155:143", "name": "Monad", "symbol": "MON", "decimals": 18, "block_time_ms": 300 },
{ "id": "eip155:5042", "name": "Arc", "symbol": "USDC", "decimals": 18, "block_time_ms": 500 }
]
},
"meta": { "finality": "none", "as_of": {}, "partial": false, "missing": [] },
"links": { "self": "/v1/chains" }
}2. Read the envelope
Every successful answer has the same three parts.
| Field | Meaning |
|---|---|
data | What you asked for. Its kind field names its shape. |
meta | How to read it: finality, as_of, partial and missing. |
links.self | The canonical path of what you fetched. |
Responses and errors describes each field.
3. One request per area
Explorer
Fetch the newest block of Ethereum. A block costs 1 credit.
curl -s "https://api.sonaintel.com/v1/chains/eip155:1/blocks/latest"Look up an address on every chain at once with the evm: prefix. This costs 2 credits.
curl -s "https://api.sonaintel.com/v1/addresses/evm:0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"x402 payments
List the newest payments on Monad.
curl -s "https://api.sonaintel.com/v1/chains/eip155:143/x402/payments?limit=2"Perpl risk
List the Perpl markets with their open interest and funding.
curl -s "https://api.sonaintel.com/v1/chains/eip155:143/perpl/markets"Prediction markets
Rank the top Polymarket wallets by profit.
curl -s "https://api.sonaintel.com/v1/pm/leaderboards/pnl?limit=3"Polymarket history answers carry a coverage object with the attribution line Polymarket history: Envio, CC-BY-4.0 and a modified notice. Keep both wherever you show the data.
Tokens
Search tokens by symbol or name. This route is free.
curl -s "https://api.sonaintel.com/v1/tokens/search?q=usdc&limit=3"DeFi and markets
Read the daily total value locked on Ethereum.
curl -s "https://api.sonaintel.com/v1/chains/eip155:1/defi/tvl"4. Read the headers
Add -i to see the headers. Answers that depend on you carry your credit balance.
curl -si "https://api.sonaintel.com/v1/chains/eip155:1/blocks/latest"X-Sona-Credits-Used: 1
X-Sona-Credits-Remaining: 499
RateLimit-Policy: "public";q=5;w=5
RateLimit: "public";r=4;t=1Limits and credits explains each header.
Next steps
- Chains and IDs shows the ID formats each route accepts.
- Pagination and caching shows how to page through lists and skip unchanged answers.
- API reference documents every endpoint.