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 }), totalLp (both sides of every DEX pool holding the coin, read from chain and valued now, with pools: how many), the holder count, who published it and when, and the control summary (field authority): whether someone can still mint more at will (mintable), who can mint and when (mint: status fixed, launchpad, owner, contract or unknown, the holder and a one sentence note; launchpad means only the launchpad's own contract mints, for example once at graduation), 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::deep::DEEP" \
  -H "x-api-key: YOUR_API_KEY"

TypeScript

const res = await fetch("https://api.tide.ad/v1/coins/0xdeeb7a4662eec9f2f3def03fb937a663dddaa2e215b8078a284d026b7946c270::deep::DEEP", {
  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": "9964401790856890",
      "amount": 9964401790.85689
    },
    "circulating": {
      "amountRaw": "2500878450033991",
      "amount": 2500878450.033991
    },
    "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.014725816611962352,
    "priceAsOf": "2026-11-06T04:29:31.747Z",
    "change": {
      "m5": -0.033550106611246466,
      "h1": -0.9517495043475765,
      "h6": 1.323614457203104,
      "h24": -7.317991483726605
    }
  },
  "marketCap": {
    "usd": 36827477.42,
    "priceAsOf": "2026-11-06T04:29:31.747Z"
  },
  "fullyDilutedValue": {
    "usd": 146733953.42,
    "priceAsOf": "2026-11-06T04:29:31.747Z"
  },
  "volume24h": {
    "usd": 2013869.59,
    "priceAsOf": "2026-11-06T04:29:31.747Z"
  },
  "liquidity": {
    "usd": 1234758.33,
    "priceAsOf": "2026-11-06T04:29:31.747Z"
  },
  "totalLp": {
    "usd": 1362682,
    "priceAsOf": "2026-11-06T04:29:31.747Z",
    "pools": 86
  },
  "holders": 94079,
  "publisher": {
    "address": "0x1db00e5da11cda6ff2dc3b8b95ee99dd603e19789037083104cf70ae9240dcaa",
    "name": null,
    "label": "DEEP deployer"
  },
  "publishedAt": {
    "timestamp": "2024-03-28T13:18:43.560Z",
    "checkpoint": 29959289,
    "digest": "AsY9kNb6XKxh8QS2okYZqPSS72SQQbJsmSscu5AAbQYd"
  },
  "authority": {
    "mintable": false,
    "mint": {
      "status": "fixed",
      "holder": {
        "kind": "object",
        "name": null,
        "address": null,
        "objectId": "0x032abf8948dda67a271bcc18e776dbbcfb0d58c8d288a700ff0d5521e57a1ffe"
      },
      "note": "Supply can only go down: the TreasuryCap of DEEP is locked inside the ProtectedTreasury object 0x032a…1ffe, whose contract can only burn, and the package can no longer be upgraded."
    },
    "treasuryCap": "wrapped",
    "regulated": false,
    "metadataMutable": false
  },
  "partial": false,
  "asOf": {
    "checkpoint": 342153958,
    "timestamp": "2026-11-06T04:29:29.742Z",
    "lagMs": 2018
  }
}