Trades within Time Range by Token Address

curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/tokens/{token_address}/trades/range \
  --header 'x-cg-pro-api-key: <api-key>'

{
  "data": [
    {
      "id": "eth_25928919_0xe5278132946375ba292473819aa96c86fd7219d66009a067ed280f679bdf45eb_73_1788825611",
      "type": "trade",
      "attributes": {
        "pool_address": "0x0fb0e40cec3bb23e13abc585958a93c796fbea56955e19a23727a716a0423239",
        "pool_dex": "uniswap-v4-ethereum",
        "block_number": 25928919,
        "tx_hash": "0xe5278132946375ba292473819aa96c86fd7219d66009a067ed280f679bdf45eb",
        "tx_from_address": "0xb5469a903df8dad9df1da1341a85f84fd434c724",
        "from_token_amount": "2489.650395",
        "to_token_amount": "2489.845103",
        "price_from_in_currency_token": "0.000401610882268168",
        "price_to_in_currency_token": "0.000401008437871588",
        "price_from_in_usd": "1.00030427279179",
        "price_to_in_usd": "0.9988037464599",
        "block_timestamp": "2026-09-07T23:59:59Z",
        "kind": "sell",
        "volume_in_usd": "2490.40792787628",
        "from_token_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "to_token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7"
      }
    },
    {
      "id": "eth_25928919_0xe5278132946375ba292473819aa96c86fd7219d66009a067ed280f679bdf45eb_67_1788825611",
      "type": "trade",
      "attributes": {
        "pool_address": "0x3b1b1f2e775a6db1664f8e7d59ad568605ea2406312c11aef03146c0cf89d5b9",
        "pool_dex": "uniswap-v4-ethereum",
        "block_number": 25928919,
        "tx_hash": "0xe5278132946375ba292473819aa96c86fd7219d66009a067ed280f679bdf45eb",
        "tx_from_address": "0xb5469a903df8dad9df1da1341a85f84fd434c724",
        "from_token_amount": "19917.582875",
        "to_token_amount": "19919.253008",
        "price_from_in_currency_token": "0.000401042063308448",
        "price_to_in_currency_token": "0.000401008437871588",
        "price_from_in_usd": "0.998887498344251",
        "price_to_in_usd": "0.9988037464599",
        "block_timestamp": "2026-09-07T23:59:59Z",
        "kind": "buy",
        "volume_in_usd": "19895.424531073",
        "from_token_address": "0xdc035d45d973e3ec169d2276ddab16f1e407384f",
        "to_token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7"
      }
    }
  ],
  "meta": {
    "next_cursor": "eyJidCI6IjIwMjYtMDktMDdUMjM6NTk6NTkuMDAwMDAwMDAwWiIsImJuIjoyNTkyODkxOSwidHgiOiIweGU1Mjc4MTMyOTQ2Mzc1YmEyOTI0NzM4MTlhYTk2Yzg2ZmQ3MjE5ZDY2MDA5YTA2N2VkMjgwZjY3OWJkZjQ1ZWIiLCJsaSI6NjcsIndmIjoxNzg4MjIwODAwLCJmcCI6IjBkYzBiMzc1ZjU5NGE5Y2Y0ZjVkOWRlOTNkN2UxNjU2NTQzZTZlODJlOTEwN2IwMmUxYzRlZjNkZTFiNjgwODAiLCJpYXQiOjE3ODg5Mzk0NDN9"
  }
}

GET

onchain

networks

{network}

tokens

{token_address}

trades

range

Trades within Time Range by Token Address

curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/tokens/{token_address}/trades/range \
  --header 'x-cg-pro-api-key: <api-key>'

{
  "data": [
    {
      "id": "eth_25928919_0xe5278132946375ba292473819aa96c86fd7219d66009a067ed280f679bdf45eb_73_1788825611",
      "type": "trade",
      "attributes": {
        "pool_address": "0x0fb0e40cec3bb23e13abc585958a93c796fbea56955e19a23727a716a0423239",
        "pool_dex": "uniswap-v4-ethereum",
        "block_number": 25928919,
        "tx_hash": "0xe5278132946375ba292473819aa96c86fd7219d66009a067ed280f679bdf45eb",
        "tx_from_address": "0xb5469a903df8dad9df1da1341a85f84fd434c724",
        "from_token_amount": "2489.650395",
        "to_token_amount": "2489.845103",
        "price_from_in_currency_token": "0.000401610882268168",
        "price_to_in_currency_token": "0.000401008437871588",
        "price_from_in_usd": "1.00030427279179",
        "price_to_in_usd": "0.9988037464599",
        "block_timestamp": "2026-09-07T23:59:59Z",
        "kind": "sell",
        "volume_in_usd": "2490.40792787628",
        "from_token_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "to_token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7"
      }
    },
    {
      "id": "eth_25928919_0xe5278132946375ba292473819aa96c86fd7219d66009a067ed280f679bdf45eb_67_1788825611",
      "type": "trade",
      "attributes": {
        "pool_address": "0x3b1b1f2e775a6db1664f8e7d59ad568605ea2406312c11aef03146c0cf89d5b9",
        "pool_dex": "uniswap-v4-ethereum",
        "block_number": 25928919,
        "tx_hash": "0xe5278132946375ba292473819aa96c86fd7219d66009a067ed280f679bdf45eb",
        "tx_from_address": "0xb5469a903df8dad9df1da1341a85f84fd434c724",
        "from_token_amount": "19917.582875",
        "to_token_amount": "19919.253008",
        "price_from_in_currency_token": "0.000401042063308448",
        "price_to_in_currency_token": "0.000401008437871588",
        "price_from_in_usd": "0.998887498344251",
        "price_to_in_usd": "0.9988037464599",
        "block_timestamp": "2026-09-07T23:59:59Z",
        "kind": "buy",
        "volume_in_usd": "19895.424531073",
        "from_token_address": "0xdc035d45d973e3ec169d2276ddab16f1e407384f",
        "to_token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7"
      }
    }
  ],
  "meta": {
    "next_cursor": "eyJidCI6IjIwMjYtMDktMDdUMjM6NTk6NTkuMDAwMDAwMDAwWiIsImJuIjoyNTkyODkxOSwidHgiOiIweGU1Mjc4MTMyOTQ2Mzc1YmEyOTI0NzM4MTlhYTk2Yzg2ZmQ3MjE5ZDY2MDA5YTA2N2VkMjgwZjY3OWJkZjQ1ZWIiLCJsaSI6NjcsIndmIjoxNzg4MjIwODAwLCJmcCI6IjBkYzBiMzc1ZjU5NGE5Y2Y0ZjVkOWRlOTNkN2UxNjU2NTQzZTZlODJlOTEwN2IwMmUxYzRlZjNkZTFiNjgwODAiLCJpYXQiOjE3ODg5Mzk0NDN9"
  }
}

Notes

Paginate with cursor rather than a page number:
- Pass meta.next_cursor back unchanged as cursor to fetch the next page.
- meta.next_cursor is null on the last page.
For a relative lookback instead of an absolute window, use Trades by Token Address with trading_period.

from and to are both required, and the window between them cannot exceed 30 days.

Both ends are inclusive.
Neither may be later than the current server time.

Authorizations

x-cg-pro-api-key

string

header

required

Learn how to set up your API key

Path Parameters

network

string

default:eth

required

Network ID. *refers to /onchain/networks.

token_address

string

default:0xdac17f958d2ee523a2206206994597c13d831ec7

required

Token contract address.

Query Parameters

trade_volume_in_usd_greater_than

number

Filter trades by trade volume in USD greater than this value. Default value: 0

from

string

default:2026-09-01

required

Starting date in ISO date string (YYYY-MM-DD or YYYY-MM-DDTHH:MM) or UNIX timestamp. Use ISO date string for best compatibility.

string

default:2026-09-08

required

Ending date in ISO date string (YYYY-MM-DD or YYYY-MM-DDTHH:MM) or UNIX timestamp. Use ISO date string for best compatibility.

cursor

string

Cursor from the previous response, passed back unchanged to fetch the next page.

per_page

integer

Total results per page. Default value: 100 Valid values: 1...300

Response

200 - application/json

Trades from a token across all pools within a time range

data

object[]

required

Hide child attributes

data.id

string

required

Trade identifier

data.type

string

required

Resource type

data.attributes

object

required

Hide child attributes

data.attributes.pool_address

string

required

Pool contract address where the trade occurred

data.attributes.pool_dex

string

required

DEX identifier of the pool

data.attributes.block_number

integer

required

Block number of the trade

data.attributes.tx_hash

string

required

Transaction hash

data.attributes.tx_from_address

string

required

Transaction sender address

data.attributes.from_token_amount

string

required

Amount of token sent

data.attributes.to_token_amount

string

required

Amount of token received

data.attributes.price_from_in_currency_token

string

required

Price of from-token in currency token

data.attributes.price_to_in_currency_token

string

required

Price of to-token in currency token

data.attributes.price_from_in_usd

string

required

Price of from-token in USD

data.attributes.price_to_in_usd

string

required

Price of to-token in USD

data.attributes.block_timestamp

string

required

Block timestamp

data.attributes.kind

string

required

Trade kind (buy or sell)

data.attributes.volume_in_usd

string

required

Trade volume in USD

data.attributes.from_token_address

string

required

From-token contract address

data.attributes.to_token_address

string

required

To-token contract address

CoinGecko API

Onchain API

Trades within Time Range by Token Address

Notes

Authorizations

Path Parameters

Query Parameters

Response

​Notes

Authorizations

Path Parameters

Query Parameters

Response

Notes