Tariff

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.

FieldMeaning
size, sizeSol, bandThe size asked for, and the range of trade sizes (SOL) counted for it.
from, toThe week covered, as Unix seconds.
countedSwaps counted this week across all apps and sizes.
apps[].swapsSwaps counted for this app at this size.
apps[].rank1 is cheapest; null until the app has minSwaps swaps.
apps[].appFeeBps, priorityBps, tipBps, slipBpsMedian of each part, in basis points of the trade (100 = 1%).
apps[].totalBps, totalSolMedian total cost per swap, as basis points and as SOL at sizeSol.
apps[].slipMeasuredHow 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.

FieldMeaning
report.scanned, swapsTransactions read, and how many were swaps through a counted app.
report.apps[].volumeSOL traded through the app, in lamports.
report.apps[].appFee, priority, tip, slip, totalSums in lamports. Slippage is only summed for swaps where it could be measured.
report.apps[].bpsTotal cost as basis points of volume.
report.truncatedTrue 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.