- Breaking: every read names what it reads with comma-separated
tokens,walletsandchainsquery 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 nowGET /v1/tokens, for 1 to 100 tokens.GET /v1/tokens/{chain}/{address}/ohlcvis nowGET /v1/ohlcv, andGET /v1/tokens/{chain}/{address}/holdersis nowGET /v1/holders, each for 1 to 10 tokens. The holders read no longer takestrader; read one wallet’s trades withwalletsonGET /v1/trades.GET /v1/tokens/{chain}/{address}/tradesis merged intoGET /v1/trades, which reads bytokens, bywallets, by both, or by anidentityfeed.traderis replaced bywallets, andsidekeeps one side of a wallet’s trades.GET /v1/wallets/balancesis nowGET /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
chainandaddress. An unknown token returns an empty list, not a404. - Breaking: the balance, discovery, trending and native-price reads also return a JSON array, without the
balances,columns,deltasandnativePriceswrappers. - Breaking:
baseandarcare no longer supported chains, and returnUNSUPPORTED_CHAIN. - New endpoint:
GET /v1/portfolioreturns the summed spot value of up to 100 wallets per chain, with each wallet’s share, and PnL stats underinclude=stats.
- Breaking: the token object’s
logoUrlis replaced bylogo, with asmall(16×16),medium(60×60) andlargeURL. Each URL returns404while no logo is available. This applies toGET /v1/tokens/{chain}/{address},POST /v1/discovery,POST /v1/trending,spot.tokensandspot.trending. The position token keepslogoUrl. - Discovery board items no longer include
decimalsorsupply. Fields the boards do not use are sent with their zero,false,nullor empty value. Request Token details for the full token. - New chain:
elysium, with HYPE as its native unit. Wallet balances can report aHYPEasset. - New trending window:
1m, onPOST /v1/trendingandspot.trending. - New fields:
devFunding.amountanddevFunding.fundedAton the token object. - New values: the
marketplacewallet flag on trades and holders, thearkhamidentity source and thedex_protocol_feefee kind. - An unknown filter name in
filtersonPOST /v1/discoveryandPOST /v1/trendingreturns400 VALIDATION_ERROR.
- New endpoint:
POST /v1/trendingreturns tokens ranked by trending score across one or more chains. - New channel:
spot.trendingsends the full board after subscribing, then each change. Each subscription uses one unit of the address limit. - New Rust SDK method:
trending_board, and theSpotTrendingFilterstream filter. - New annotation:
tax_vaultmarks a token that pays its tax into a revenue vault.
- New field:
logoUrlon the token object, inGET /v1/tokens/{chain}/{address},POST /v1/discoveryandspot.tokens. It is anhttporhttpsURL, ornullwhen the token has no logo. - Renamed: the position token’s
imageis nowlogoUrl, inGET /v1/positionsandspot.positions. It follows the same rule.
- New endpoint:
GET /v1/native-pricesreturns the latest USD price of each chain’s gas asset. - New channel:
chain.nativePricesstreams 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 theNativePricesFilterstream filter. - Every field and parameter in the REST reference has a description.
- New endpoint:
POST /v1/session-tokenscreates a short-lived session token, so a browser can call the API without your API key. - A browser opens the stream with
metastreams.v1and a session token as WebSocket subprotocols. - New error codes:
403 FORBIDDENand403 ORIGIN_NOT_ALLOWED. See Error codes. - The
401message 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
1008on 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:
spot.transfersstreams transfers between wallets, filtered by token, wallet, sender, recipient, amount or token state. spot.candlesaccepts 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.candlesupdate names itschain,token,poolandtimeframe. spot.candlestakesmetricanddenominationbesidefilters, and acceptsthrottleMsandclosedOnly.spot.candlesrejects thechain+token+timeframefilter. See Unsupported filters.- A
spot.candlesfilter 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 code4402. See Credits.
- New endpoint:
GET /v1/tokens/{chain}/{address}/holdersreturns a token’s current holders, sorted by largest balance first, with each wallet’s trading figures for the token. - New channel:
spot.holdersstreams a holder’s row each time it changes. - The
periodparameter selects the span the figures cover:lifetime(the default) orcycle(the open round trip).
spot.tokensandspot.tradesaccept a filter language.{}matches every token or trade on every chain.spot.tradesrejects thechain+token,chain+walletandidentityfilters. See Unsupported filters.spot.tokensrejectschainandtoken; usechainsandtokensinstead. See Unsupported filters.- Streamed trades include
flags,platformsandidentitieson every subscription. spot.tokenssends anexitframe when a token stops matching, and acceptsthrottleMs.- New channels:
wallet.balancesandspot.positions. - New endpoints:
GET /v1/wallets/balancesandGET /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
401response no longer includesX-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,proTraderCountandglobalFeesPaidNative.
- Added the
arcchain to every token, trade, candle, discovery and stream path. Arc pays gas in USDC, sonativeandusdvalues on Arc are nearly identical.