Trades by Pool Address

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

{
  "data": [
    {
      "id": "eth_25191329_0x90a746e28f4db27b2595b8ac55ef999914ed09453d5924b1424b2c050fd053c3_99_1779941075",
      "type": "trade",
      "attributes": {
        "block_number": 25191329,
        "tx_hash": "0x90a746e28f4db27b2595b8ac55ef999914ed09453d5924b1424b2c050fd053c3",
        "tx_from_address": "0x0b0d1579b739b1996d28c53c4ff11e2c541a1188",
        "from_token_amount": "0.106968578509495",
        "to_token_amount": "211.331589",
        "price_from_in_currency_token": "1.0",
        "price_to_in_currency_token": "0.000506164643987487",
        "price_from_in_usd": "1976.18881048696",
        "price_to_in_usd": "1.00027690571219",
        "block_timestamp": "2026-05-28T04:04:11Z",
        "kind": "buy",
        "volume_in_usd": "211.39010792416",
        "from_token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "to_token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7"
      }
    },
    {
      "id": "eth_25191103_0x8c7d19881344e94e69f69f44a3910a32183652b84156537ec23313bfa01ff054_804_1779938350",
      "type": "trade",
      "attributes": {
        "block_number": 25191103,
        "tx_hash": "0x8c7d19881344e94e69f69f44a3910a32183652b84156537ec23313bfa01ff054",
        "tx_from_address": "0x39b9a705f5aa2fdf315bf5cc8ecd71dc821f45b1",
        "from_token_amount": "192.459164",
        "to_token_amount": "0.096413761161719",
        "price_from_in_currency_token": "0.000500956977874636",
        "price_to_in_currency_token": "1.0",
        "price_from_in_usd": "0.992388076121959",
        "price_to_in_usd": "1980.98463531194",
        "block_timestamp": "2026-05-28T03:18:47Z",
        "kind": "sell",
        "volume_in_usd": "190.994179494001",
        "from_token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "to_token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
      }
    }
  ],
  "meta": {
    "next_cursor": null
  }
}

GET

onchain

networks

{network}

pools

{pool_address}

trades

Trades by Pool Address

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

{
  "data": [
    {
      "id": "eth_25191329_0x90a746e28f4db27b2595b8ac55ef999914ed09453d5924b1424b2c050fd053c3_99_1779941075",
      "type": "trade",
      "attributes": {
        "block_number": 25191329,
        "tx_hash": "0x90a746e28f4db27b2595b8ac55ef999914ed09453d5924b1424b2c050fd053c3",
        "tx_from_address": "0x0b0d1579b739b1996d28c53c4ff11e2c541a1188",
        "from_token_amount": "0.106968578509495",
        "to_token_amount": "211.331589",
        "price_from_in_currency_token": "1.0",
        "price_to_in_currency_token": "0.000506164643987487",
        "price_from_in_usd": "1976.18881048696",
        "price_to_in_usd": "1.00027690571219",
        "block_timestamp": "2026-05-28T04:04:11Z",
        "kind": "buy",
        "volume_in_usd": "211.39010792416",
        "from_token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "to_token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7"
      }
    },
    {
      "id": "eth_25191103_0x8c7d19881344e94e69f69f44a3910a32183652b84156537ec23313bfa01ff054_804_1779938350",
      "type": "trade",
      "attributes": {
        "block_number": 25191103,
        "tx_hash": "0x8c7d19881344e94e69f69f44a3910a32183652b84156537ec23313bfa01ff054",
        "tx_from_address": "0x39b9a705f5aa2fdf315bf5cc8ecd71dc821f45b1",
        "from_token_amount": "192.459164",
        "to_token_amount": "0.096413761161719",
        "price_from_in_currency_token": "0.000500956977874636",
        "price_to_in_currency_token": "1.0",
        "price_from_in_usd": "0.992388076121959",
        "price_to_in_usd": "1980.98463531194",
        "block_timestamp": "2026-05-28T03:18:47Z",
        "kind": "sell",
        "volume_in_usd": "190.994179494001",
        "from_token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "to_token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
      }
    }
  ],
  "meta": {
    "next_cursor": null
  }
}

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 an absolute date window instead of a relative lookback, consider Trades within Time Range by Pool Address (Analyst & above).

trading_period, cursor and per_page require Analyst plan & above. Without them, the endpoint returns the last 300 trades from the past 24 hours.

SDK Examples

const response = await client.onchain.networks.pools.trades.get('0x06da0fd433c1a5d7a4faa01111c044910a184553', {
  network: 'eth',
});

console.log(JSON.stringify(response, null, 2));

response = client.onchain.networks.pools.trades.get(
  "0x06da0fd433c1a5d7a4faa01111c044910a184553",
  network="eth",
)

print(response.model_dump_json(indent=2))

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

trading_period

enum<string>

Lookback period for trades. Default: 1d

Available options:

1d,

7d,

30d

cursor

string

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

per_page

integer

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

Response

200 - application/json

Trades from a pool

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 by Pool Address

Notes

SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

​Notes

​SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

Notes

SDK Examples