Skip to main content
This page lists changes to the API, newest first.
Breaking endpoint changes and a new endpoint
  • Breaking: every read names what it reads with comma-separated tokens, wallets and chains query lists, and no path carries a chain or an address. One request reads many tokens or wallets, and costs one credit for each one it names.
    • GET /v1/tokens/{chain}/{address} is now GET /v1/tokens, for 1 to 100 tokens.
    • GET /v1/tokens/{chain}/{address}/ohlcv is now GET /v1/ohlcv, and GET /v1/tokens/{chain}/{address}/holders is now GET /v1/holders, each for 1 to 10 tokens. The holders read no longer takes trader; read one wallet’s trades with wallets on GET /v1/trades.
    • GET /v1/tokens/{chain}/{address}/trades is merged into GET /v1/trades, which reads by tokens, by wallets, by both, or by an identity feed. trader is replaced by wallets, and side keeps one side of a wallet’s trades.
    • GET /v1/wallets/balances is now GET /v1/balances.
  • Breaking: the token, candle and holder reads return a JSON array, with one element per chain that holds each requested token. Each element carries its chain and address. An unknown token returns an empty list, not a 404.
  • Breaking: the balance, discovery, trending and native-price reads also return a JSON array, without the balances, columns, deltas and nativePrices wrappers.
  • Breaking: base and arc are no longer supported chains, and return UNSUPPORTED_CHAIN.
  • New endpoint: GET /v1/portfolio returns the summed spot value of up to 100 wallets per chain, with each wallet’s share, and PnL stats under include=stats.
Breaking field change, new chain and new values
  • Breaking: the token object’s logoUrl is replaced by logo, with a small (16×16), medium (60×60) and large URL. Each URL returns 404 while no logo is available. This applies to GET /v1/tokens/{chain}/{address}, POST /v1/discovery, POST /v1/trending, spot.tokens and spot.trending. The position token keeps logoUrl.
  • Discovery board items no longer include decimals or supply. Fields the boards do not use are sent with their zero, false, null or empty value. Request Token details for the full token.
  • New chain: elysium, with HYPE as its native unit. Wallet balances can report a HYPE asset.
  • New trending window: 1m, on POST /v1/trending and spot.trending.
  • New fields: devFunding.amount and devFunding.fundedAt on the token object.
  • New values: the marketplace wallet flag on trades and holders, the arkham identity source and the dex_protocol_fee fee kind.
  • An unknown filter name in filters on POST /v1/discovery and POST /v1/trending returns 400 VALIDATION_ERROR.
New field and a renamed field
New endpoint and channel
  • New endpoint: GET /v1/native-prices returns the latest USD price of each chain’s gas asset.
  • New channel: chain.nativePrices streams each new price, about every 10 seconds per chain. Each subscription uses one unit of the address limit.
  • New Rust SDK method: native_prices, and the NativePricesFilter stream filter.
  • Every field and parameter in the REST reference has a description.
New endpoint, error codes and SDK
  • New endpoint: POST /v1/session-tokens creates a short-lived session token, so a browser can call the API without your API key.
  • A browser opens the stream with metastreams.v1 and a session token as WebSocket subprotocols.
  • New error codes: 403 FORBIDDEN and 403 ORIGIN_NOT_ALLOWED. See Error codes.
  • The 401 message names a credential: an API key or a session token.
  • API keys no longer expire. A key stays valid until it is revoked, and close code 1008 on a key’s stream means the key was revoked.
  • Every key belongs to an organization, which can have up to 10 active keys.
  • New: the Rust SDK, a typed client for every REST endpoint and the stream.
New channel, filters and error code
  • New channel: spot.transfers streams transfers between wallets, filtered by token, wallet, sender, recipient, amount or token state.
  • spot.candles accepts the filter language. One subscription can follow many tokens, pools and timeframes, and filter buckets by volume, trade count, price change or token state.
  • Each spot.candles update names its chain, token, pool and timeframe.
  • spot.candles takes metric and denomination beside filters, and accepts throttleMs and closedOnly.
  • spot.candles rejects the chain + token + timeframe filter. See Unsupported filters.
  • A spot.candles filter that names addresses costs one unit of the address limit per address.
  • An organization that has used its plan’s credits for the billing period receives 402 CREDITS_EXHAUSTED, and its open streams close with code 4402. See Credits.
New endpoint and channel
  • New endpoint: GET /v1/tokens/{chain}/{address}/holders returns a token’s current holders, sorted by largest balance first, with each wallet’s trading figures for the token.
  • New channel: spot.holders streams a holder’s row each time it changes.
  • The period parameter selects the span the figures cover: lifetime (the default) or cycle (the open round trip).
New filters, channels and endpoints
  • spot.tokens and spot.trades accept a filter language. {} matches every token or trade on every chain.
  • spot.trades rejects the chain + token, chain + wallet and identity filters. See Unsupported filters.
  • spot.tokens rejects chain and token; use chains and tokens instead. See Unsupported filters.
  • Streamed trades include flags, platforms and identities on every subscription.
  • spot.tokens sends an exit frame when a token stops matching, and accepts throttleMs.
  • New channels: wallet.balances and spot.positions.
  • New endpoints: GET /v1/wallets/balances and GET /v1/positions.
  • Stream limits are 20 connections, 20 subscriptions and 2,000 addresses per key, down from 100 connections and 100 subscriptions per connection.
  • The request limit is 10 per second, shared by every key of one organization, unless your plan sets another rate. It replaces 12,000 per minute per key, and no limit is counted per IP address.
  • A 401 response no longer includes X-RateLimit-Remaining.
  • A client frame larger than 1 MiB closes the connection.
  • A revoked or expired key closes its open streams with code 1008.
  • Discovery accepts dexPaid, excludeAnnotations, bundlerSupplyPercent, insiderSupplyPercent, proTraderCount and globalFeesPaidNative.
New chain
  • Added the arc chain to every token, trade, candle, discovery and stream path. Arc pays gas in USDC, so native and usd values on Arc are nearly identical.
First release
  • Token details, OHLCV candles, token trades, identity trades and discovery boards.
  • Live streams: spot.trades, spot.candles and spot.tokens.
  • Bearer API keys on every request and on the stream handshake.
  • Chains: solana, base, bsc and robinhood.