Tokens
Tokens Data by Token Addresses
This endpoint allows you to query multiple tokens data based on the provided token contract addresses on a network
get/networks/{network}/tokens/multi/{addresses}
Request
- Base URL: https://api.geckoterminal.com/api/v2
- URL: https://api.geckoterminal.com/api/v2/networks/{network}/tokens/multi/{addresses}
- Auth: none declared
Path parameters
networkstring required
Example:eth
network ID<br>*refers to /networks
addressesstring required
token contract address, comma-separated if more than one token contract address (up to 30 addresses)
Query parameters
include_inactive_sourceboolean
include inactive pools when sourcing for token's top pool
attributes to include, comma-separated if more than one to include<br><br><b>Available values:</b> top_pools
include_compositionboolean
include pool composition
Response
Get multiple tokens on a network
Example response
{
"data": [
{
"id": "eth_0x44ff8620b8ca30902395a7bd3f2407e1a091bf73",
"type": "token",
"attributes": {
"address": "0x44ff8620b8ca30902395a7bd3f2407e1a091bf73",
"name": "Virtual Protocol",
"symbol": "VIRTUAL",
"decimals": 18,
"image_url": "https://coin-images.coingecko.com/coins/images/34057/large/LOGOMARK.png?1708356054",
"banner_image_url": null,
"coingecko_coin_id": "virtual-protocol",
"total_supply": "1000000000000000000000000000.0",
"normalized_total_supply": "1000000000.0",
"price_usd": "1.2360509143",
"fdv_usd": "1236049062.71205",
"total_reserve_in_usd": "1057431.7464185216625800287534040469",
"volume_usd": {
"h24": "38713.9260903249"
},
"market_cap_usd": "810357802.002085"
},
"relationships": {
"top_pools": {
"data": [
{
"id": "eth_0x95a45a87dd4d3a1803039072f37e075f37b23d75",
"type": "pool"
}
]
}
}
}
],
"included": [
{
"id": "eth_0x95a45a87dd4d3a1803039072f37e075f37b23d75",
"type": "pool",
"attributes": {
"base_token_price_usd": "1.23605091431632",
"base_token_price_native_currency": "0.000276634218716478",
"base_token_balance": "632455.064963526",
"base_token_liquidity_usd": "781765.7043993239",
"quote_token_price_usd": "4468.28678620552",
"quote_token_price_native_currency": "1.0",
"quote_token_balance": "47.9170335228147",
"quote_token_liquidity_usd": "214107.04772415984",
"base_token_price_quote_token": "0.0002766342187",
"quote_token_price_base_token": "3614.881790979",
"address": "0x95a45a87dd4d3a1803039072f37e075f37b23d75",
"name": "VIRTUAL / WETH 1%",
"pool_created_at": "2023-12-24T15:16:59Z",
"fdv_usd": "1236049062.69573",
"market_cap_usd": "810357802.002085",
"price_change_percentage": {
"m5": "0",
"m15": "0",
"m30": "-0.01",
"h1": "-0.033",
"h6": "-1.177",
"h24": "-3.945"
},
"transactions": {
"m5": {
"buys": 0,
"sells": 0,
"buyers": 0,
"sellers": 0
},
"m15": {
"buys": 0,
"sells": 0,
"buyers": 0,
"sellers": 0
},
"m30": {
"buys": 0,
"sells": 4,
"buyers": 0,
"sellers": 4
},
"h1": {
"buys": 0,
"sells": 12,
"buyers": 0,
"sellers": 8
},
"h6": {
"buys": 5,
"sells": 39,
"buyers": 4,
"sellers": 26
},
"h24": {
"buys": 17,
"sells": 68,
"buyers": 13,
"sellers": 44
}
},
"volume_usd": {
"m5": "0.0",
"m15": "0.0",
"m30": "124.147451535",
"h1": "349.000957995",
"h6": "15478.0378042767",
"h24": "21703.1874601209"
},
"reserve_in_usd": "995880.9039"
},
"relationships": {
"base_token": {
"data": {
"id": "eth_0x44ff8620b8ca30902395a7bd3f2407e1a091bf73",
"type": "token"
}
},
"quote_token": {
"data": {
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"type": "token"
}
},
"dex": {
"data": {
"id": "uniswap_v3",
"type": "dex"
}
}
}
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.