> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coingecko.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Trades by Wallet Address
> To query the trades of a wallet address on a network
export const CacheInfo = ({publicRate, paidRate, rate}) => {
const fmt = v => v === 0 ? 'Real-time (Cacheless)' : `Every ${v}`;
if (rate !== undefined) {
return
Cache / Update Frequency:
{fmt(rate)}
;
}
if (publicRate !== undefined && paidRate !== undefined) {
return
Cache / Update Frequency:- {fmt(paidRate)} (Paid API)
- {fmt(publicRate)} (Demo / Keyless API)
;
}
return null;
};
export const PlanExclusivity = ({tier}) => {
if (tier === "enterprise") {
return
Enterprise Only
This endpoint is exclusively available to Enterprise plan.
→ Contact sales
;
}
if (tier === "analyst_above") {
return
Analyst Plan and Above
This endpoint is only available to Analyst, Lite, Pro, and Enterprise plan.
→ View pricing
;
}
if (tier === "basic_above") {
return
Basic Plan and Above
This endpoint is only available to Basic, Analyst, Lite, Pro, and Enterprise plan.
→ View pricing
;
}
throw new Error(`PlanExclusivity: invalid tier "${tier}". Use "basic_above", "analyst_above", or "enterprise".`);
};
#### 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.
* An invalid or expired `cursor` returns a `400`. Restart pagination without `cursor`.
`from` and `to` must be provided together, and the window between them cannot exceed 30 days.
* Omit both to get the most recent 7 days.
* Providing only one of them returns a `400`.
## OpenAPI
````yaml openapi-specs/pro-api.json get /onchain/networks/{network}/wallets/{address}/trades
openapi: 3.0.0
info:
title: CoinGecko Pro API
version: 3.0.0
servers:
- url: https://pro-api.coingecko.com/api/v3
security:
- headerAuth: []
- queryAuth: []
paths:
/onchain/networks/{network}/wallets/{address}/trades:
get:
summary: Trades by Wallet Address
description: To query the trades of a wallet address on a network
operationId: wallet-trades
parameters:
- name: network
in: path
required: true
description: |-
Network ID.
*refers to [`/onchain/networks`](/reference/networks-list).
schema:
type: string
default: eth
- name: address
in: path
required: true
description: Wallet address.
schema:
type: string
default: '0x7942262a7a5637e6eb0eec9b91b55ec232141f87'
- name: token
in: query
required: false
description: >-
Filter trades by token contract address, returning only trades
involving this token.
schema:
type: string
- name: from
in: query
required: false
description: >-
Starting date in ISO date string (`YYYY-MM-DD` or
`YYYY-MM-DDTHH:MM`) or UNIX timestamp.
**Use ISO date string for best compatibility.**
Must be provided together with `to`.
schema:
type: string
- name: to
in: query
required: false
description: >-
Ending date in ISO date string (`YYYY-MM-DD` or `YYYY-MM-DDTHH:MM`)
or UNIX timestamp.
**Use ISO date string for best compatibility.**
Must be provided together with `from`.
schema:
type: string
- name: cursor
in: query
required: false
description: >-
Cursor from the previous response, passed back unchanged to fetch
the next page.
schema:
type: string
- name: per_page
in: query
required: false
description: |-
Total results per page.
Default value: 100
Valid values: 1...300
schema:
type: integer
responses:
'200':
description: Wallet trades data
content:
application/json:
schema:
$ref: '#/components/schemas/WalletTrades'
example:
data:
- id: >-
eth_26014653_0x62cea982714040d1e3ccbbb7b34f2038b21ad8f0807f38ab5b649937328f2e21_70_1789858264
type: trade
attributes:
pool_address: '0x86ce2637f272a2972b0652492c4830458d008d29'
pool_dex: uniswap_v2
block_number: 26014653
block_timestamp: '2026-09-19T22:50:59Z'
tx_hash: >-
0x62cea982714040d1e3ccbbb7b34f2038b21ad8f0807f38ab5b649937328f2e21
tx_from_address: '0x7942262a7a5637e6eb0eec9b91b55ec232141f87'
kind: sell
from_token_address: '0x12419a0427c2a27a61c1cb4a49f5fad24fd4e671'
to_token_address: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2'
from_token_amount: '103506.532814702'
to_token_amount: '0.00501453238225022'
price_from_in_usd: '0.000127363990398952'
price_to_in_usd: '2628.96'
price_from_in_currency_token: '0.0000000484465303385948'
price_to_in_currency_token: '1.0'
volume_in_usd: '13.1830050516405'
- id: >-
eth_26010581_0x7ee572c77ff5ff2fa994eb75ae2a02220313eae9cd68e057bf505a83330d63a9_146_1789809092
type: trade
attributes:
pool_address: '0x40efafe9250b43b7c1be0ec1a75e4e7526559507'
pool_dex: uniswap_v2
block_number: 26010581
block_timestamp: '2026-09-19T09:11:23Z'
tx_hash: >-
0x7ee572c77ff5ff2fa994eb75ae2a02220313eae9cd68e057bf505a83330d63a9
tx_from_address: '0x7942262a7a5637e6eb0eec9b91b55ec232141f87'
kind: buy
from_token_address: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2'
to_token_address: '0x57737ded3870e43fed7d80d31e0ced3d5fb0cccc'
from_token_amount: '0.198'
to_token_amount: '2119603.73334363'
price_from_in_usd: '2652.59'
price_to_in_usd: '0.00024778821236151'
price_from_in_currency_token: '1.0'
price_to_in_currency_token: '0.0000000934136871365381'
volume_in_usd: '525.21282'
meta:
next_cursor: null
components:
schemas:
WalletTrades:
type: object
required:
- data
- meta
properties:
data:
type: array
items:
type: object
required:
- id
- type
- attributes
properties:
id:
type: string
description: Trade identifier
type:
type: string
description: Resource type
attributes:
type: object
required:
- pool_address
- pool_dex
- block_number
- block_timestamp
- tx_hash
- tx_from_address
- kind
- from_token_address
- to_token_address
- from_token_amount
- to_token_amount
- price_from_in_usd
- price_to_in_usd
- price_from_in_currency_token
- price_to_in_currency_token
- volume_in_usd
properties:
pool_address:
type: string
description: Pool contract address where the trade occurred
pool_dex:
type: string
description: DEX identifier of the pool
block_number:
type: integer
description: Block number of the trade
block_timestamp:
type: string
format: date-time
description: Block timestamp of the trade
tx_hash:
type: string
description: Transaction hash
tx_from_address:
type: string
description: Transaction sender address
kind:
type: string
description: Trade kind, either buy or sell
from_token_address:
type: string
description: From-token contract address
to_token_address:
type: string
description: To-token contract address
from_token_amount:
type: string
description: Amount of token sent
to_token_amount:
type: string
description: Amount of token received
price_from_in_usd:
type: string
description: Price of from-token in USD
price_to_in_usd:
type: string
description: Price of to-token in USD
price_from_in_currency_token:
type: string
description: Price of from-token in currency token
price_to_in_currency_token:
type: string
description: Price of to-token in currency token
volume_in_usd:
type: string
description: Trade volume in USD
meta:
type: object
required:
- next_cursor
properties:
next_cursor:
type: string
nullable: true
description: Cursor for the next page, null when there are no further pages
securitySchemes:
headerAuth:
type: apiKey
in: header
name: x-cg-pro-api-key
description: >-
Learn how to [set up your API
key](https://docs.coingecko.com/docs/setting-up-your-api-key)
queryAuth:
type: apiKey
in: query
name: x_cg_pro_api_key
description: >-
Learn how to [set up your API
key](https://docs.coingecko.com/docs/setting-up-your-api-key)
````