Added

2026.07.28 - Release Blockchain Metrics API, Wallet Tags Tracker Details API, and x402 Batch Endpoint Expansion

Add two new APIs for blockchain market metrics and Wallet Tags Tracker drilldowns, plus expand x402 coverage to 12 additional batch and multi-item endpoints.

Features

Blockchain Market Metrics

GET /market/v1/blockchain-metrics

  • Retrieve blockchain-level market metrics aggregated by time bucket
  • Return trading volume, trade count, active trading tokens, and stablecoin market capitalization
  • Support Solana chain requests
  • Support Lite API access

Parameters

ParameterTypeRequiredDefaultDescription
x-chainstringNosolanaChain header. This release currently supports Solana requests.
time_framestringYes-Aggregation interval for the market metrics series.
reference_timestampintegerNonowReference Unix timestamp used to anchor the returned time buckets.
directionstringNobeforeTime traversal direction relative to the reference timestamp.
limitintegerNo10Number of time buckets to return. Maximum 10.

Wallet Tags Tracker Details

GET /token/v1/wallet-tags-tracker/details

  • Drill into Wallet Tags Tracker buckets and list the tagged wallets active in each candle
  • Return per-wallet buy/sell volume and transaction counts for the selected time range
  • Support filtering by wallet tags, specific wallet addresses, minimum USD volume, and top-10-holder view
  • Support Solana-only requests
  • Support Lite API access

Parameters

ParameterTypeRequiredDefaultDescription
x-chainstringNosolanaChain header. This endpoint is currently Solana-only.
token_addressstringYes-Token mint address.
time_fromintegerYes-Start of the range as a Unix timestamp in seconds.
time_tointegerNonowEnd of the range as a Unix timestamp in seconds. Must be greater than time_from.
time_framestringYes-Size of each time bucket. Must match the Wallet Tags Tracker bucket being inspected.
tagsstring[]NoallComma-separated wallet tags to restrict the response to.
walletsstring[]No-Comma-separated wallet addresses to restrict the response to. Supports up to 100 addresses.
min_volume_usdnumberNo0Only include wallets whose USD volume in a bucket is at least this value.
top_10_holderbooleanNofalseSet to true to restrict results to wallets in the token's top 10 holder set.
sort_bystringNovolumeSort field for wallet activity inside each bucket.
sort_typestringNodescSort direction: asc or desc.
offsetintegerNo0Pagination offset for wallets inside each bucket.
limitintegerNo10Number of wallet rows to return per bucket.

x402 Batch Endpoint Expansion

Birdeye x402 now supports 12 additional batch and multi-item endpoints so AI agents and programmatic clients can pay per request for more bulk DeFi and wallet data workflows without API keys.

New x402-Supported Endpoints

MethodPath
GET, POST/x402/defi/multi_price
POST/x402/defi/price_volume/multi
GET/x402/defi/v3/token/meta-data/multiple
GET/x402/defi/v3/token/trade-data/multiple
GET/x402/defi/v3/token/market-data/multiple
GET/x402/defi/v3/pair/overview/multiple
POST/x402/defi/v3/all-time/trades/multiple
GET/x402/defi/v3/token/exit-liquidity/multiple
POST/x402/defi/v3/price/stats/multiple
GET/x402/wallet/v2/pnl/multiple
POST/x402/wallet/v2/token-balance
POST/x402/defi/v3/liquidity/latest/token

Notes

  • All x402 endpoints remain prefixed with /x402
  • Wallet and token endpoints under this release keep their existing route-level validation and request shapes
  • Solana-only behavior continues to apply where required by the underlying endpoint