token_addresses input is limited to a maximum of 5 addresses per subscription.
Credit Cost
1 per minute
Supported Chains
BASE_MAINNETBSC_MAINNETETH_MAINNETHYPEREVM_MAINNETMEGAETH_MAINNETMONAD_MAINNETPOLYGON_MAINNETROBINHOOD_MAINNETSOLANA_MAINNET
Estimate your monthly cost for this API using the Pricing Calculator.
Parameters
Array of token addresses on supported DEXes and chains to track
Subscription
You can subscribe to theupdateTokens endpoint to receive real-time swap updates for the highest-volume pool of each token.
subscription {
updateTokens(
chain_name: BASE_MAINNET
token_addresses: ["0x0b3e328455c4059EEb9e3f84b5543F74E24e7E1b"]
) {
trader
liquidity
pair_address
base_token {
contract_name
contract_address
contract_decimals
contract_ticker_symbol
}
last_5m {
volume {
previous_value
pct_change
current_value
}
unique_sellers {
previous_value
pct_change
current_value
}
sell_count {
previous_value
pct_change
current_value
}
price {
previous_value
pct_change
current_value
}
buy_count {
previous_value
pct_change
current_value
}
sell_volume {
previous_value
pct_change
current_value
}
volume_usd {
previous_value
pct_change
current_value
}
buy_volume {
previous_value
pct_change
current_value
}
swap_count {
previous_value
pct_change
current_value
}
unique_buyers {
previous_value
pct_change
current_value
}
}
last_6hr {
volume {
previous_value
pct_change
current_value
}
unique_sellers {
previous_value
pct_change
current_value
}
sell_count {
previous_value
pct_change
current_value
}
price {
previous_value
pct_change
current_value
}
buy_count {
previous_value
pct_change
current_value
}
sell_volume {
previous_value
pct_change
current_value
}
volume_usd {
previous_value
pct_change
current_value
}
buy_volume {
previous_value
pct_change
current_value
}
swap_count {
previous_value
pct_change
current_value
}
unique_buyers {
previous_value
pct_change
current_value
}
}
market_cap
quote_rate
last_24hr {
volume {
previous_value
pct_change
current_value
}
unique_sellers {
previous_value
pct_change
current_value
}
sell_count {
previous_value
pct_change
current_value
}
price {
previous_value
pct_change
current_value
}
buy_count {
previous_value
pct_change
current_value
}
sell_volume {
previous_value
pct_change
current_value
}
volume_usd {
previous_value
pct_change
current_value
}
buy_volume {
previous_value
pct_change
current_value
}
swap_count {
previous_value
pct_change
current_value
}
unique_buyers {
previous_value
pct_change
current_value
}
}
last_1hr {
volume {
previous_value
pct_change
current_value
}
unique_sellers {
previous_value
pct_change
current_value
}
sell_count {
previous_value
pct_change
current_value
}
price {
previous_value
pct_change
current_value
}
buy_count {
previous_value
pct_change
current_value
}
sell_volume {
previous_value
pct_change
current_value
}
volume_usd {
previous_value
pct_change
current_value
}
buy_volume {
previous_value
pct_change
current_value
}
swap_count {
previous_value
pct_change
current_value
}
unique_buyers {
previous_value
pct_change
current_value
}
}
quote_rate_usd
sender
quote_token {
contract_name
contract_address
contract_decimals
contract_ticker_symbol
}
id
chain_name
direction
timestamp
}
}
Response Format
Here’s an example of the response data structure:{
"data": {
"updateTokens": {
"chain_name": "BASE_MAINNET",
"pair_address": "0x9c087Eb773291e50CF6c6a90ef0F4500e349B903",
"timestamp": "2025-06-28T14:30:00Z",
"direction": "buy",
"trader": "0xd2216ed62a5c84f285a051839e808902fe8fc90b",
"sender": "0x198ef79f1f515f02dfe9e3115ed9fc07183f02fc",
"quote_rate": 0.0002962,
"quote_rate_usd": 1.39,
"volume": 0.2079461510855417,
"volume_usd": 975.515187,
"market_cap": 1390000,
"liquidity": 450000,
"base_token": {
"contract_name": "Virtual Protocol",
"contract_address": "0x0b3e328455c4059EEb9e3f84b5543F74E24e7E1b",
"contract_decimals": 18,
"contract_ticker_symbol": "VIRTUAL"
},
"quote_token": {
"contract_name": "Wrapped Ether",
"contract_address": "0x4200000000000000000000000000000000000006",
"contract_decimals": 18,
"contract_ticker_symbol": "WETH"
},
"last_5m": {
"price_delta": { "current_value": 1.39, "previous_value": 1.38, "pct_change": 0.72 },
"swap_count": { "current_value": 12, "previous_value": 8, "pct_change": 50 },
"buy_volume": { "current_value": 500.25, "previous_value": 320.10, "pct_change": 56.3 },
"sell_volume": { "current_value": 475.26, "previous_value": 290.50, "pct_change": 63.6 },
"unique_traders": { "current_value": 5, "previous_value": 3, "pct_change": 66.7 },
"total_buy_txns": { "current_value": 7, "previous_value": 5, "pct_change": 40 },
"total_sell_txns": { "current_value": 5, "previous_value": 3, "pct_change": 66.7 }
}
}
}
}
Field Descriptions
Address of the trader who initiated the swap
Total liquidity in the pool
The address of the DEX pair
Information about the base token in the pairType:
TokenContractMetadataAggregated trading metrics for the last 5 minutesType:
TimeframeMetricsShow properties
Show properties
Total volume in native/quote token (buy + sell)Type:
MetricValueNumber of unique seller addressesType:
MetricValueNumber of sell transactionsType:
MetricValuePrice: current_value = current price, previous_value = price at window startType:
MetricValueNumber of buy transactionsType:
MetricValueTotal sell volume in USDType:
MetricValueTotal volume in USD (buy + sell)Type:
MetricValueTotal buy volume in USDType:
MetricValueTotal number of swapsType:
MetricValueNumber of unique buyer addressesType:
MetricValueAggregated trading metrics for the last 6 hoursType:
TimeframeMetricsShow properties
Show properties
Total volume in native/quote token (buy + sell)Type:
MetricValueNumber of unique seller addressesType:
MetricValueNumber of sell transactionsType:
MetricValuePrice: current_value = current price, previous_value = price at window startType:
MetricValueNumber of buy transactionsType:
MetricValueTotal sell volume in USDType:
MetricValueTotal volume in USD (buy + sell)Type:
MetricValueTotal buy volume in USDType:
MetricValueTotal number of swapsType:
MetricValueNumber of unique buyer addressesType:
MetricValueMarket capitalization of the token pair
Exchange rate between base and quote tokens
Aggregated trading metrics for the last 24 hoursType:
TimeframeMetricsShow properties
Show properties
Total volume in native/quote token (buy + sell)Type:
MetricValueNumber of unique seller addressesType:
MetricValueNumber of sell transactionsType:
MetricValuePrice: current_value = current price, previous_value = price at window startType:
MetricValueNumber of buy transactionsType:
MetricValueTotal sell volume in USDType:
MetricValueTotal volume in USD (buy + sell)Type:
MetricValueTotal buy volume in USDType:
MetricValueTotal number of swapsType:
MetricValueNumber of unique buyer addressesType:
MetricValueAggregated trading metrics for the last 1 hourType:
TimeframeMetricsShow properties
Show properties
Total volume in native/quote token (buy + sell)Type:
MetricValueNumber of unique seller addressesType:
MetricValueNumber of sell transactionsType:
MetricValuePrice: current_value = current price, previous_value = price at window startType:
MetricValueNumber of buy transactionsType:
MetricValueTotal sell volume in USDType:
MetricValueTotal volume in USD (buy + sell)Type:
MetricValueTotal buy volume in USDType:
MetricValueTotal number of swapsType:
MetricValueNumber of unique buyer addressesType:
MetricValueExchange rate between base and quote tokens in USD
Address that sent the transaction
Information about the quote token in the pairType:
TokenContractMetadataUnique identifier for this swap event
Swap direction: buy or sell
Timestamp of the latest swap (ISO-8601)