Trades within Time Range by Pool Address

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

{
  "data": [
    {
      "id": "eth_25928873_0x2d17e7f893da1d87e893dd6ddcc42366ea3680c13d4be129d6d1ebac271bac40_167_1788825063",
      "type": "trade",
      "attributes": {
        "block_number": 25928873,
        "tx_hash": "0x2d17e7f893da1d87e893dd6ddcc42366ea3680c13d4be129d6d1ebac271bac40",
        "tx_from_address": "0x0000000000f8492ebaf65b3c0457cca8948badfe",
        "from_token_amount": "0.475091",
        "to_token_amount": "0.00019056174944482",
        "price_from_in_currency_token": "0.000401105786985693",
        "price_to_in_currency_token": "1.0",
        "price_from_in_usd": "0.999728096656752",
        "price_to_in_usd": "2492.43",
        "block_timestamp": "2026-09-07T23:50:47Z",
        "kind": "sell",
        "volume_in_usd": "0.474961821168753",
        "from_token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "to_token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
      }
    },
    {
      "id": "eth_25928873_0x05a0ba340fc07a23a5179ed0c7b68c0a7fe5e40487f1d2bb5d96f5d2eda6a1cb_26_1788825060",
      "type": "trade",
      "attributes": {
        "block_number": 25928873,
        "tx_hash": "0x05a0ba340fc07a23a5179ed0c7b68c0a7fe5e40487f1d2bb5d96f5d2eda6a1cb",
        "tx_from_address": "0x0e14a3e9af1afdfc60554e3e2a40c8284d647093",
        "from_token_amount": "42.234864",
        "to_token_amount": "0.0169429755714377",
        "price_from_in_currency_token": "0.000401160888583367",
        "price_to_in_currency_token": "1.0",
        "price_from_in_usd": "0.999865433531841",
        "price_to_in_usd": "2492.43",
        "block_timestamp": "2026-09-07T23:50:47Z",
        "kind": "sell",
        "volume_in_usd": "42.2291806035184",
        "from_token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "to_token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
      }
    }
  ],
  "meta": {
    "next_cursor": "eyJidCI6IjIwMjYtMDktMDdUMjM6NTA6NDcuMDAwMDAwMDAwWiIsImJuIjoyNTkyODg3MywidHgiOiIweDA1YTBiYTM0MGZjMDdhMjNhNTE3OWVkMGM3YjY4YzBhN2ZlNWU0MDQ4N2YxZDJiYjVkOTZmNWQyZWRhNmExY2IiLCJsaSI6MjYsIndmIjoxNzg4MjIwODAwLCJmcCI6Ijk1OGY2N2VkZmU2NDRjMmU2ZTE5NTlkNWQ2ZThmM2FjZDY3YTFiYWYzYWI3YzJmMTVhYmUzNjkzMjhhNjEyZTAiLCJpYXQiOjE3ODg5Mzk0MjF9"
  }
}

GET

onchain

networks

{network}

pools

{pool_address}

trades

range

Trades within Time Range by Pool Address

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

{
  "data": [
    {
      "id": "eth_25928873_0x2d17e7f893da1d87e893dd6ddcc42366ea3680c13d4be129d6d1ebac271bac40_167_1788825063",
      "type": "trade",
      "attributes": {
        "block_number": 25928873,
        "tx_hash": "0x2d17e7f893da1d87e893dd6ddcc42366ea3680c13d4be129d6d1ebac271bac40",
        "tx_from_address": "0x0000000000f8492ebaf65b3c0457cca8948badfe",
        "from_token_amount": "0.475091",
        "to_token_amount": "0.00019056174944482",
        "price_from_in_currency_token": "0.000401105786985693",
        "price_to_in_currency_token": "1.0",
        "price_from_in_usd": "0.999728096656752",
        "price_to_in_usd": "2492.43",
        "block_timestamp": "2026-09-07T23:50:47Z",
        "kind": "sell",
        "volume_in_usd": "0.474961821168753",
        "from_token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "to_token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
      }
    },
    {
      "id": "eth_25928873_0x05a0ba340fc07a23a5179ed0c7b68c0a7fe5e40487f1d2bb5d96f5d2eda6a1cb_26_1788825060",
      "type": "trade",
      "attributes": {
        "block_number": 25928873,
        "tx_hash": "0x05a0ba340fc07a23a5179ed0c7b68c0a7fe5e40487f1d2bb5d96f5d2eda6a1cb",
        "tx_from_address": "0x0e14a3e9af1afdfc60554e3e2a40c8284d647093",
        "from_token_amount": "42.234864",
        "to_token_amount": "0.0169429755714377",
        "price_from_in_currency_token": "0.000401160888583367",
        "price_to_in_currency_token": "1.0",
        "price_from_in_usd": "0.999865433531841",
        "price_to_in_usd": "2492.43",
        "block_timestamp": "2026-09-07T23:50:47Z",
        "kind": "sell",
        "volume_in_usd": "42.2291806035184",
        "from_token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "to_token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
      }
    }
  ],
  "meta": {
    "next_cursor": "eyJidCI6IjIwMjYtMDktMDdUMjM6NTA6NDcuMDAwMDAwMDAwWiIsImJuIjoyNTkyODg3MywidHgiOiIweDA1YTBiYTM0MGZjMDdhMjNhNTE3OWVkMGM3YjY4YzBhN2ZlNWU0MDQ4N2YxZDJiYjVkOTZmNWQyZWRhNmExY2IiLCJsaSI6MjYsIndmIjoxNzg4MjIwODAwLCJmcCI6Ijk1OGY2N2VkZmU2NDRjMmU2ZTE5NTlkNWQ2ZThmM2FjZDY3YTFiYWYzYWI3YzJmMTVhYmUzNjkzMjhhNjEyZTAiLCJpYXQiOjE3ODg5Mzk0MjF9"
  }
}

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 Pool 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.

pool_address

string

default:0x06da0fd433c1a5d7a4faa01111c044910a184553

required

Pool 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

token

string

Return trades for token, use this to invert the chart. Available values: base, quote, or token address. Default: base

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 pool 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.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 Pool Address

Notes

Authorizations

Path Parameters

Query Parameters

Response

​Notes

Authorizations

Path Parameters

Query Parameters

Response

Notes