Skip to main content
GET
/
onchain
/
networks
/
{network}
/
tokens
/
multi
/
{addresses}
Tokens Data by Token Addresses
curl --request GET \
  --url https://api.coingecko.com/api/v3/onchain/networks/{network}/tokens/multi/{addresses} \
  --header 'x-cg-demo-api-key: <api-key>'
{
  "data": [
    {
      "id": "solana_6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN",
      "type": "token",
      "attributes": {
        "address": "6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN",
        "name": "OFFICIAL TRUMP",
        "symbol": "TRUMP",
        "decimals": 6,
        "image_url": "https://coin-images.coingecko.com/coins/images/53746/large/trump.png?1737171561",
        "coingecko_coin_id": "official-trump",
        "total_supply": "999999108407137.0",
        "normalized_total_supply": "999999108.407137",
        "price_usd": "2.0174050182",
        "fdv_usd": "2017403219.4789",
        "total_reserve_in_usd": "38853273.6350283264033294",
        "volume_usd": {
          "h24": "2099707.5067169"
        },
        "market_cap_usd": "478960276.377951"
      },
      "relationships": {
        "top_pools": {
          "data": [
            {
              "id": "solana_9d9mb8kooFfaD3SctgZtkxQypkshx6ezhbKio89ixyy2",
              "type": "pool"
            }
          ]
        }
      }
    },
    {
      "id": "solana_2g4LS3y2myPe6vj9wTvoBE1wKqxvhnZPoZA9QU9upump",
      "type": "token",
      "attributes": {
        "address": "2g4LS3y2myPe6vj9wTvoBE1wKqxvhnZPoZA9QU9upump",
        "name": "SORACAT",
        "symbol": "SORACAT",
        "decimals": 6,
        "image_url": "https://assets.geckoterminal.com/o6djbxjg7ne8k1swjpybmdvtu11s",
        "coingecko_coin_id": null,
        "total_supply": "1000000000000000.0",
        "normalized_total_supply": "1000000000.0",
        "price_usd": null,
        "fdv_usd": null,
        "total_reserve_in_usd": "5234.61248798976042147487629165",
        "volume_usd": {
          "h24": "0.0"
        },
        "market_cap_usd": null,
        "launchpad_details": {
          "graduation_percentage": 2.16,
          "completed": false,
          "completed_at": null,
          "migrated_destination_pool_address": null
        }
      },
      "relationships": {
        "top_pools": {
          "data": []
        }
      }
    }
  ],
  "included": [
    {
      "id": "solana_9d9mb8kooFfaD3SctgZtkxQypkshx6ezhbKio89ixyy2",
      "type": "pool",
      "attributes": {
        "base_token_price_usd": "2.01740501818281139006336492319318380811954562178395002842369476",
        "base_token_price_native_currency": "0.0239250580677484",
        "quote_token_price_usd": "0.999569304917712897234320781454435071561674967628724909109738",
        "quote_token_price_native_currency": "0.0118488106949705",
        "base_token_price_quote_token": "2.0191948951",
        "quote_token_price_base_token": "0.4952468939",
        "address": "9d9mb8kooFfaD3SctgZtkxQypkshx6ezhbKio89ixyy2",
        "name": "TRUMP / USDC",
        "pool_created_at": "2025-01-18T10:39:31Z",
        "fdv_usd": "2017403219.49608",
        "market_cap_usd": "478960276.377951",
        "price_change_percentage": {
          "m5": "0",
          "m15": "-0.065",
          "m30": "-0.321",
          "h1": "0.023",
          "h6": "0.217",
          "h24": "-0.584"
        },
        "transactions": {
          "m5": {
            "buys": 0,
            "sells": 0,
            "buyers": 0,
            "sellers": 0
          },
          "m15": {
            "buys": 0,
            "sells": 2,
            "buyers": 0,
            "sellers": 2
          },
          "m30": {
            "buys": 4,
            "sells": 5,
            "buyers": 3,
            "sellers": 2
          },
          "h1": {
            "buys": 10,
            "sells": 22,
            "buyers": 6,
            "sellers": 7
          },
          "h6": {
            "buys": 61,
            "sells": 90,
            "buyers": 26,
            "sellers": 25
          },
          "h24": {
            "buys": 252,
            "sells": 327,
            "buyers": 64,
            "sellers": 60
          }
        },
        "volume_usd": {
          "m5": "0.0",
          "m15": "597.6697876563",
          "m30": "11191.1430985437",
          "h1": "22383.1305344185",
          "h6": "149655.009727483",
          "h24": "524824.856290105"
        },
        "reserve_in_usd": "34848559.9613"
      },
      "relationships": {
        "base_token": {
          "data": {
            "id": "solana_6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN",
            "type": "token"
          }
        },
        "quote_token": {
          "data": {
            "id": "solana_EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
            "type": "token"
          }
        },
        "dex": {
          "data": {
            "id": "meteora",
            "type": "dex"
          }
        }
      }
    }
  ]
}

​
Notes

  • Addresses not found in GeckoTerminal will be ignored.
  • Supports up to 30 contract addresses per request. Analyst plan or above supports up to 50.
  • Returns the top most liquid pool per token.
  • total_reserve_in_usd represents the total reserve of the requested token only across all its pools, not both tokens in a pair.
  • Unverified token market cap returns null — the displayed value on GeckoTerminal may match FDV and might not be accurate. Verified market cap is sourced from CoinGecko and may exceed FDV if it includes tokens on other networks.
  • Use include=top_pools to include top pools data. Add include_composition=true to surface balance and liquidity of base and quote tokens (requires include=top_pools).
  • Bonding curve tokens (non-graduated launchpad tokens) include a launchpad_details object with graduation status.
For token metadata (socials, websites, description), use Token Info instead.

​
SDK Examples

const response = await client.onchain.networks.tokens.multi.getAddresses('6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN,2g4LS3y2myPe6vj9wTvoBE1wKqxvhnZPoZA9QU9upump', {
  network: 'solana',
});

console.log(JSON.stringify(response, null, 2));

Authorizations

​
x-cg-demo-api-key
string
header
required

Path Parameters

​
network
string
default:solana
required

Network ID. *refers to /onchain/networks.

​
addresses
string
default:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN,2g4LS3y2myPe6vj9wTvoBE1wKqxvhnZPoZA9QU9upump
required

Token contract address, comma-separated if more than one token contract address.

Query Parameters

​
include
enum<string>

Attributes to include.

Available options:
top_pools
​
include_composition
boolean

Include pool composition. Default: false

​
include_inactive_source
boolean

Include tokens from inactive pools using the most recent swap. Default: false

Response

200 - application/json

Multiple tokens data

​
data
object[]
required
​
included
object[]

Included top pool data, present when include=top_pools is specified