Reading responses

​

Field names

​

Timestamps

• Fields that hold an instant end in At: createdAt, graduatedAt, updatedAt.
• Some records name the instant directly: a trade’s timestamp, a candle’s time.

{ "createdAt": 1723180800000 }

const created = new Date(token.createdAt);

​

Money

{ "price": { "native": "0.000000121", "usd": "0.0000216" } }

​

Decimals

from decimal import Decimal

usd = token["price"]["usd"]
price = Decimal(usd) if usd is not None else None

import Big from "big.js";

const price = token.price.usd === null ? null : new Big(token.price.usd);

​

Candles are numbers

​

Percentages

{ "priceChangePct": "-2.5", "top10Pct": "31.7" }

​

Trailing windows

{
  "stats": {
    "1h": {
      "priceChangePct": "1.8",
      "volume": { "native": "4120.5", "usd": "735509" },
      "buyCount": 2210,
      "sellCount": 1984,
      "buyVolume": { "native": "2101.2", "usd": "375064" },
      "sellVolume": { "native": "2019.3", "usd": "360445" }
    }
  }
}

​

Missing values

• Most values that are not known yet are null. For example, graduatedAt is null until a token leaves its launchpad.
• A few fields use an empty value instead. A trade’s name and symbol are empty strings until the token’s metadata arrives.
• A list that would be empty may be left out. On a token, platforms and annotations are left out when empty. On a trade, flags, platforms and identities are left out when empty. Treat a missing list as empty.