API
The same numbers as the site, as JSON. Every request needs an active plan key from the SOL plan.
Authentication
Send your key in the x-api-key header (or as Authorization: Bearer). Each key allows 60 requests a minute.
curl -H "x-api-key: $TARIFF_KEY" "/api/v1/table?size=1"
Weekly table
GET /api/v1/table?size=0.1|1|10
The median cost of one swap through each app over the last seven days, for the chosen trade size. Ranked apps come first, cheapest first.
| Field | Meaning |
|---|---|
| size, sizeSol, band | The size asked for, and the range of trade sizes (SOL) counted for it. |
| from, to | The week covered, as Unix seconds. |
| counted | Swaps counted this week across all apps and sizes. |
| apps[].swaps | Swaps counted for this app at this size. |
| apps[].rank | 1 is cheapest; null until the app has minSwaps swaps. |
| apps[].appFeeBps, priorityBps, tipBps, slipBps | Median of each part, in basis points of the trade (100 = 1%). |
| apps[].totalBps, totalSol | Median total cost per swap, as basis points and as SOL at sizeSol. |
| apps[].slipMeasured | How many of the swaps had enough nearby trades to measure slippage. |
Wallet
GET /api/v1/wallet/{address}
Reads the wallet's own transactions from the last 30 days (up to the most recent 300) and adds up what it paid per app. A first read can take up to a minute; while it is still running you get status 202 with status: "running". Ask again with the same address.
| Field | Meaning |
|---|---|
| report.scanned, swaps | Transactions read, and how many were swaps through a counted app. |
| report.apps[].volume | SOL traded through the app, in lamports. |
| report.apps[].appFee, priority, tip, slip, total | Sums in lamports. Slippage is only summed for swaps where it could be measured. |
| report.apps[].bps | Total cost as basis points of volume. |
| report.truncated | True when the wallet had more transactions than were read. |
Errors
401 no active key, 400 bad size or address, 429 over the rate limit, 503 chain reading not switched on yet.