Tokens
One token on one chain: its price and where that price came from, what Tickwise knows about it, and the pools that hold it.
GET /v1/tokens/{chainId}/{address} — 2 units
curl -s "https://api.tickwise.xyz/v1/tokens/1/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48?limit=5" \
-H "KC-APIKey: $TICKWISE_API_KEY"Path and query parameters
| Parameter | Default | Meaning |
|---|---|---|
| chainId | required | Path. 1, 42161, 43114, 4663, 5042, 999, 4326, 7777777, 42220, 57073, 4217, 137 or 130. Any other chain is a 400. |
| address | required | Path. The token contract, 0x plus 40 hex, any case. The chain's native token is 0x0000000000000000000000000000000000000000. Anything else is a 400. |
| protocol | uniswap-v4 | The only value served; anything else is a 400. |
| sort | tvl | Order of pools: tvl, volume, fees, fee_apr or age, as on GET /v1/pools. |
| page / limit | 1 / 20 | Pages through pools. limit is 1–100. |
| includeRisky | false | Admits pools with no reliable price, as on the pools list. While a chain's token indexes are still being built, it is refused with a 400 for a token held by 10,000 or more pools on that chain (a native token, a major stablecoin). |
| view / fields | full | Shape each pool row as on GET /v1/pools. token, price and trust always come back whole. |
Response
{
"chainId": 1,
"protocol": "uniswap-v4",
"address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"token": { "symbol": "USDC", "name": null, "decimals": 6, "logoURI": "https://…", "assetClass": null },
"price": {
"usd": 0.99989,
"source": "stable-anchor",
"providers": ["defillama", "geckoterminal", "dia"],
"confidence": "anchor",
"pricedAt": "2026-11-18T20:08:02.130Z"
},
"trust": {
"anchor": "stable",
"listed": true,
"security": null,
"identity": null,
"issuerSpoof": false,
"dexMarket": true
},
"pools": [ { "rank": 1, "poolId": "0x21c6…", "token0": { "symbol": "ETH", … }, "token1": { "symbol": "USDC", … }, … } ],
"pagination": { "page": 1, "limit": 5, "total": 3846, "totalPages": 770, "hasMore": true }
}price
The USD price Tickwise values positions and pools with. source is stable-anchor, native-anchor or trusted-anchor for a token the chain's configuration anchors, otherwise external (a price aggregator). providers names the aggregators behind the stored price and pricedAt says when it was written. When there is no price Tickwise would use, usd is null and unavailableReason says why:
no-price: never priced.stale-price: last priced more than 24 hours ago (pricedAtis kept).untrusted-token: it uses a major token's symbol at another contract, or claims to be an issued stock token it is not.no-market: not a token the API trusts (a config anchor or on CoinGecko's list) and no active DEX market is confirmed for it: none was seen, or it has not been checked yet.unavailable: the price could not be read for this answer. The response carriespartial: trueand is not charged; ask again.
trust and risk
trust.anchor is the anchor class (stable, native, trusted) or null. listed says whether the contract is on the CoinGecko list for the chain (null on a chain with no list). security holds the GoPlus signals as last checked (honeypot, blacklist, taxes, and a spam verdict), or null when the token was never checked: anchors and listed tokens are not. identity flags a spoofed or phishing symbol, issuerSpoof a fake stock token, and dexMarket whether an active DEX market was seen. risk.flags, when present, uses the same values as pool and position rows (symbol-spoof, phishing-symbol, excluded-token).
pools
The pools holding the token as token0 or token1, exactly as GET /v1/pools rows, with the same pagination. Pools paired with a spam or no-market token are left out. A token that is itself on the spam list keeps its own pools, each flagged excluded-token.
Errors and charges
- 404: Tickwise has no record of the address on that chain and no pool holds it. Not charged.
- 200 with an empty
pools: a token Tickwise knows with no pool to show (none, or only risky ones whileincludeRiskyis off). Charged. - 400: a malformed address, an unsupported chain or protocol, or a bad
sort,page,limit,vieworfields. Not charged. - One flat charge per answer (2 units), the same as a pools list page. A successful answer may be reused for 15 seconds (
Cache-Control: private, max-age=15).