---
title: "Token Price by Token Addresses"
method: GET
path: "/onchain/simple/networks/{network}/token_price/{addresses}"
---

# Token Price by Token Addresses

`GET /onchain/simple/networks/{network}/token_price/{addresses}`

## Request

- Base URL: `https://api.coingecko.com/api/v3`
- URL: `https://api.coingecko.com/api/v3/onchain/simple/networks/{network}/token_price/{addresses}`
- Auth: one of:
  - API key in header `x-cg-pro-api-key`
  - API key in query parameter `x_cg_pro_api_key`

To get token price based on the provided token contract address on a network

## Path parameters

- `network` string, required
- `addresses` string, required

## Query parameters

- `include_market_cap` boolean
- `mcap_fdv_fallback` boolean
- `include_24hr_vol` boolean
- `include_24hr_price_change` boolean
- `include_total_reserve_in_usd` boolean
- `include_inactive_source` boolean

## Response `200`

Token price data

- OnchainSimplePrice
  - `data` object, required
    - `id` string, required: Request ID
    - `type` string, required: Response type
    - `attributes` object, required
      - `token_prices` object, required: Token prices keyed by contract address
      - `market_cap_usd` object: Market cap in USD keyed by contract address
      - `h24_volume_usd` object: 24hr volume in USD keyed by contract address
      - `h24_price_change_percentage` object: 24hr price change percentage keyed by contract address
      - `total_reserve_in_usd` object: Total reserve in USD keyed by contract address
      - `last_trade_timestamp` object: Last trade timestamp keyed by contract address

---

[API](https://skmtc.dev/coingecko/apis/coingecko-demo-api.md) - [All operations](https://skmtc.dev/coingecko/apis/coingecko-demo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/coingecko/apis/coingecko-demo-api/revisions/d62c9c579f3a?raw)
