Coins

coins.get

One coin: metadata, supply, price, market cap, volume, liquidity, holders and who holds the TreasuryCap.

Details

Endpoint: GET /v1/coins/:type
Credits: 1
Rate class: Light. Counts against your light requests per second.

Returns the coin's name, symbol, decimals and icon, total and circulating supply, the USD price with its time (with lowLiquidity: true when it is the last trade of a coin with no pool of $1,000 or more; market cap and fully diluted value are null then), market cap, fully diluted value, 24 hour volume and liquidity (each USD value as { usd, priceAsOf }), the holder count, who published it and when, and the control summary (field authority): whether the TreasuryCap can still mint more, whether the deny list can block addresses, and whether the metadata can still change. Amounts are decimal numbers with the raw integer beside them (amountRaw). Use it first when you need to know what a coin is.

Parameters

Name	Type	Description
typerequired	string	Move coin type, URL-encoded in the path, for example 0x2::sui::SUI or 0xdeeb7a46...::deep::DEEP.

Request

Send your key in the x-api-key header, or leave it out to use the keyless tier.

curl

curl "https://api.tide.ad/v1/coins/0xdeeb7a4662eec9f2f3def03fb937a663dddaa2e215b8078a284d026b7946c270%3A%3Adeep%3A%3ADEEP" \
  -H "x-api-key: YOUR_API_KEY"

TypeScript

const res = await fetch("https://api.tide.ad/v1/coins/0xdeeb7a4662eec9f2f3def03fb937a663dddaa2e215b8078a284d026b7946c270%3A%3Adeep%3A%3ADEEP", {
  headers: {
    "x-api-key": process.env.TIDE_API_KEY!,
  },
});
const data = await res.json();

Response

JSON

{
  "coinType": "0xdeeb7a4662eec9f2f3def03fb937a663dddaa2e215b8078a284d026b7946c270::deep::DEEP",
  "symbol": "DEEP",
  "name": "DeepBook Token",
  "decimals": 6,
  "description": "The DEEP token secures the DeepBook protocol, the premier wholesale liquidity venue for on-chain trading.",
  "iconUrl": "https://images.deepbook.tech/icon.svg",
  "verified": true,
  "project": "DeepBook",
  "links": [
    {
      "label": "X",
      "url": "https://x.com/DeepBookonSui"
    },
    {
      "label": "Website",
      "url": "https://deepbook.tech/"
    }
  ],
  "supply": {
    "total": {
      "amountRaw": "9964444880575678",
      "amount": 9964444880.575678
    },
    "circulating": {
      "amountRaw": "2500260969546302",
      "amount": 2500260969.546302
    },
    "circulatingMethod": "Circulating supply as market cap divided by price. Locked, vested and team-held balances are excluded; it is not computed on chain."
  },
  "price": {
    "usd": 0.016078251464945126,
    "priceAsOf": "2026-11-04T09:27:25.238Z",
    "change": {
      "m5": -0.00959624680239024,
      "h1": -0.15349117897297537,
      "h6": 5.066037406877344,
      "h24": 5.4245124746844064
    }
  },
  "marketCap": {
    "usd": 40199824.6,
    "priceAsOf": "2026-11-04T09:27:25.238Z"
  },
  "fullyDilutedValue": {
    "usd": 160210850.5,
    "priceAsOf": "2026-11-04T09:27:25.238Z"
  },
  "volume24h": {
    "usd": 2839771.78,
    "priceAsOf": "2026-11-04T09:27:25.238Z"
  },
  "liquidity": {
    "usd": 1433504.24,
    "priceAsOf": "2026-11-04T09:27:25.238Z"
  },
  "holders": 93905,
  "publisher": {
    "address": "0x1db00e5da11cda6ff2dc3b8b95ee99dd603e19789037083104cf70ae9240dcaa",
    "name": null,
    "label": "DEEP deployer"
  },
  "publishedAt": {
    "timestamp": "2024-03-28T13:18:43.560Z",
    "checkpoint": 29959289,
    "digest": "AsY9kNb6XKxh8QS2okYZqPSS72SQQbJsmSscu5AAbQYd"
  },
  "authority": {
    "mintable": true,
    "treasuryCap": "wrapped",
    "regulated": false,
    "metadataMutable": false
  },
  "partial": false,
  "asOf": {
    "checkpoint": 341512768,
    "timestamp": "2026-11-04T09:27:24.387Z",
    "lagMs": 733
  }
}