Skip to main content
GET
/
simple
/
networks
/
{network}
/
token_price
/
{addresses}
Token Price by Token Addresses
curl --request GET \
  --url https://api.coingecko.com/api/v3/onchain/simple/networks/{network}/token_price/{addresses} \
  --header 'x-cg-demo-api-key: <api-key>'
{
  "data": {
    "id": "1ba898f0-eda2-4291-9491-9a5b323f66ef",
    "type": "simple_token_price",
    "attributes": {
      "token_prices": {
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "2289.33"
      },
      "market_cap_usd": {
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "6692452895.779648"
      },
      "h24_volume_usd": {
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "965988358.733808"
      },
      "h24_price_change_percentage": {
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "3.3870290336"
      },
      "total_reserve_in_usd": {
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "1576179559.94669772339136684208"
      },
      "last_trade_timestamp": {
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": 1712534400
      }
    }
  }
}

Authorizations

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

Path Parameters

network
string
default:eth
required

network ID *refers to /networks

Example:

"eth"

addresses
string
default:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
required

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

Query Parameters

include_market_cap
boolean

include market capitalization, default: false

mcap_fdv_fallback
boolean

return FDV if market cap is not available, default: false

include_24hr_vol
boolean

include 24hr volume, default: false

include_24hr_price_change
boolean

include 24hr price change, default: false

include_total_reserve_in_usd
boolean

include total reserve in USD, default: false

include_inactive_source
boolean
default:false

include token price data from inactive pools using the most recent swap, default: false

Response

200 - application/json

Get current USD prices of multiple tokens on a network

data
object