> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coingecko.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Token Price by Token Addresses across Networks
> To get token prices based on the provided token contract addresses across multiple networks in a single request
export const CacheInfo = ({publicRate, paidRate, rate}) => {
const fmt = v => v === 0 ? 'Real-time (Cacheless)' : `Every ${v}`;
if (rate !== undefined) {
return
Cache / Update Frequency:
{fmt(rate)}
;
}
if (publicRate !== undefined && paidRate !== undefined) {
return
Cache / Update Frequency:- {fmt(paidRate)} (Paid API)
- {fmt(publicRate)} (Demo / Keyless API)
;
}
return null;
};
export const PlanExclusivity = ({tier}) => {
if (tier === "enterprise") {
return
Enterprise Only
This endpoint is exclusively available to Enterprise plan.
→ Contact sales
;
}
if (tier === "analyst_above") {
return
Analyst Plan and Above
This endpoint is only available to Analyst, Lite, Pro, and Enterprise plan.
→ View pricing
;
}
if (tier === "basic_above") {
return
Basic Plan and Above
This endpoint is only available to Basic, Analyst, Lite, Pro, and Enterprise plan.
→ View pricing
;
}
throw new Error(`PlanExclusivity: invalid tier "${tier}". Use "basic_above", "analyst_above", or "enterprise".`);
};
#### Notes
* Each `tokens` entry pairs a network ID with a token contract address, separated by `:`
* For example, `eth:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2,solana:6NwarBvDkXhByqVp2Qkq5i9XbtA2B3Bwe8SWGu9vpump`.
* Networks can be mixed freely in one request, up to **50 pairs**.
* Responses are keyed by the same pairs, so a token address that appears on several networks stays unambiguous.
* Unverified token market cap returns `null`. Use `mcap_fdv_fallback=true` to return FDV value (as seen on [GeckoTerminal](https://www.geckoterminal.com/)) when market cap data is unavailable.
* GeckoTerminal's routing selects the best pool for pricing based on liquidity and activity. For full control, use [Specific Pool Data](/reference/pool-address) with a specific pool address.
* Set `include_inactive_source=true` to expand the search to recently active pools (up to 1 year) if no top pool is found.
An unknown network ID fails the whole request, while an unknown token address does not.
* An unsupported `network_id` returns a `400` naming the offending IDs.
* A token address that cannot be resolved on a supported network is omitted from the response.
## OpenAPI
````yaml openapi-specs/pro-api.json get /onchain/simple/token_price/multi
openapi: 3.0.0
info:
title: CoinGecko Pro API
version: 3.0.0
servers:
- url: https://pro-api.coingecko.com/api/v3
security:
- headerAuth: []
- queryAuth: []
paths:
/onchain/simple/token_price/multi:
get:
summary: Token Price by Token Addresses across Networks
description: >-
To get token prices based on the provided token contract addresses
across multiple networks in a single request
operationId: onchain-simple-price-multi
parameters:
- name: tokens
in: query
required: true
description: >-
Network ID and token contract address pairs in
`network_id:token_address` format, comma-separated if more than
one.
Maximum: 50
*refers to [`/onchain/networks`](/reference/networks-list).
schema:
type: string
default: >-
eth:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2,solana:6NwarBvDkXhByqVp2Qkq5i9XbtA2B3Bwe8SWGu9vpump
- name: include_market_cap
in: query
required: false
description: |-
Include market capitalization.
Default: `false`
schema:
type: boolean
- name: mcap_fdv_fallback
in: query
required: false
description: |-
Return FDV if market cap is not available.
Default: `false`
schema:
type: boolean
- name: include_24hr_vol
in: query
required: false
description: |-
Include 24hr volume.
Default: `false`
schema:
type: boolean
- name: include_24hr_price_change
in: query
required: false
description: |-
Include 24hr price change.
Default: `false`
schema:
type: boolean
- name: include_total_reserve_in_usd
in: query
required: false
description: |-
Include total reserve in USD.
Default: `false`
schema:
type: boolean
- name: include_inactive_source
in: query
required: false
description: >-
Include token price data from inactive pools using the most recent
swap.
Default: `false`
schema:
type: boolean
responses:
'200':
description: Token price data across networks
content:
application/json:
schema:
$ref: '#/components/schemas/OnchainSimplePriceMulti'
example:
data:
id: 1965b339-94a3-4a77-9475-2c3248081bcf
type: simple_token_price
attributes:
token_prices:
solana:6NwarBvDkXhByqVp2Qkq5i9XbtA2B3Bwe8SWGu9vpump: >-
0.00725052986758138039267632966543134822451730159307662487006330525
eth:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2: '2472.55'
market_cap_usd:
solana:6NwarBvDkXhByqVp2Qkq5i9XbtA2B3Bwe8SWGu9vpump: '7247388.521391886'
eth:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2: '5102178003.805862'
h24_volume_usd:
solana:6NwarBvDkXhByqVp2Qkq5i9XbtA2B3Bwe8SWGu9vpump: '675469.233689449'
eth:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2: '375011671.541306'
h24_price_change_percentage:
solana:6NwarBvDkXhByqVp2Qkq5i9XbtA2B3Bwe8SWGu9vpump: '-25.041400507465255'
eth:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2: '-1.7249945348675306'
total_reserve_in_usd:
solana:6NwarBvDkXhByqVp2Qkq5i9XbtA2B3Bwe8SWGu9vpump: '269041.15769788764465650874159'
eth:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2: >-
897342937.857452743743894395950846065408962664417022104817193141774571367472718031454441201623527425
last_trade_timestamp:
solana:6NwarBvDkXhByqVp2Qkq5i9XbtA2B3Bwe8SWGu9vpump: '1789028068'
eth:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2: '1789027367'
components:
schemas:
OnchainSimplePriceMulti:
type: object
required:
- data
properties:
data:
type: object
required:
- id
- type
- attributes
properties:
id:
type: string
description: Request ID
type:
type: string
description: Response type
attributes:
type: object
required:
- token_prices
properties:
token_prices:
type: object
description: Token prices keyed by network ID and contract address
additionalProperties:
type: string
market_cap_usd:
type: object
description: Market cap in USD keyed by network ID and contract address
additionalProperties:
type: string
h24_volume_usd:
type: object
description: 24hr volume in USD keyed by network ID and contract address
additionalProperties:
type: string
h24_price_change_percentage:
type: object
description: >-
24hr price change percentage keyed by network ID and
contract address
additionalProperties:
type: string
total_reserve_in_usd:
type: object
description: >-
Total reserve in USD keyed by network ID and contract
address
additionalProperties:
type: string
last_trade_timestamp:
type: object
description: >-
Last trade timestamp keyed by network ID and contract
address
additionalProperties:
type: string
securitySchemes:
headerAuth:
type: apiKey
in: header
name: x-cg-pro-api-key
description: >-
Learn how to [set up your API
key](https://docs.coingecko.com/docs/setting-up-your-api-key)
queryAuth:
type: apiKey
in: query
name: x_cg_pro_api_key
description: >-
Learn how to [set up your API
key](https://docs.coingecko.com/docs/setting-up-your-api-key)
````