Coins and balances

Coin details, USD prices, candles, holders, trades, pools and safety checks, and the balances any wallet holds.

When to use it

Show a coin page: supply, price, holders and where it trades.
Price a portfolio in USD, with the time of each price.
Check a coin before you list or swap it.

Quickstart

Replace YOUR_API_KEY with your key from the developer portal, or drop the key header to use the keyless tier. See Quickstart.

1. Get a coin

Metadata, supply, price and market data for a coin type.

curl "https://api.tide.ad/v1/coins/0xdeeb7a4662eec9f2f3def03fb937a663dddaa2e215b8078a284d026b7946c270::deep::DEEP" \
  -H "x-api-key: YOUR_API_KEY"

2. Price many coins

One call for a list of coin types.

curl -X POST "https://api.tide.ad/v1/prices" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
  "coinTypes": [
    "0x2::sui::SUI",
    "0xdeeb7a4662eec9f2f3def03fb937a663dddaa2e215b8078a284d026b7946c270::deep::DEEP",
    "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC"
  ]
}'

3. List the top holders

Holders ranked by balance. For holders at a past date, see History.

curl "https://api.tide.ad/v1/coins/0xdeeb7a4662eec9f2f3def03fb937a663dddaa2e215b8078a284d026b7946c270::deep::DEEP/holders?limit=10" \
  -H "x-api-key: YOUR_API_KEY"

4. Read a wallet's balances

Every coin a wallet holds, with USD value.

curl "https://api.tide.ad/v1/wallet/0x671f7079e238edf837ae8d4fe8274f3337e1b20bbc08e2e9b9b7f5fcee9566e2/balances?limit=10" \
  -H "x-api-key: YOUR_API_KEY"

API reference

Method	What it does	Credits
coins.getGET /v1/coins/:type	One coin: metadata, supply, price, market cap, volume, liquidity, holders and who holds the TreasuryCap.	1
coins.pricesPOST /v1/prices	USD prices for up to 100 coins, now or at a past time.	varies
coins.candlesGET /v1/coins/:type/candles	OHLCV candles for a coin at 1 second to 1 week intervals.	2
coins.holdersGET /v1/coins/:type/holders	Top holders of a coin, ranked by balance, with the USD value of each.	5
coins.tradesGET /v1/coins/:type/trades	Recent DEX trades of a coin, newest first.	2
coins.poolsGET /v1/coins/:type/pools	The busiest liquidity pools for a coin, with TVL and 24 hour volume.	2
coins.securityGET /v1/coins/:type/security	Launch safety for a coin: TreasuryCap and deny list status, honeypot flag, and a list of checks.	2
markets.topGET /v1/markets	Ranked coin lists: trending, top, new, gainers, losers, bonding and graduated.	2
wallet.balancesGET /v1/wallet/:wallet/balances	Every coin a wallet holds now, with USD value, sorted by value.	10

Full lists: Coins. Every method page has its parameters, credits and an example response.