PnL by Wallet Address

curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/onchain/wallets/{address}/pnl \
  --header 'x-cg-pro-api-key: <api-key>'

{
  "data": {
    "id": "0x4b3f1048c55faa0c0873e249e541139360501f2a",
    "type": "wallet_pnl",
    "attributes": {
      "wallet_address": "0x4b3f1048c55faa0c0873e249e541139360501f2a",
      "total_realized_pnl_usd": "17831328.189418429",
      "total_unrealized_pnl_usd": "-5265158.4349284421",
      "total_tokens": 47,
      "networks": [
        {
          "network": "eth",
          "realized_pnl_usd": "13365120.67931429",
          "unrealized_pnl_usd": "-1425379.6227395136",
          "tokens": 35
        },
        {
          "network": "base",
          "realized_pnl_usd": "4466207.510104139",
          "unrealized_pnl_usd": "-3839778.8121889285",
          "tokens": 12
        }
      ],
      "token_stats": [
        {
          "network": "eth",
          "address": "0x7f39c581f595b53c5cb19bd0b3f8da6c935e2ca0",
          "name": "Wrapped liquid staked Ether 2.0",
          "symbol": "wstETH",
          "decimals": 18,
          "realized_pnl_usd": "4301337.150173959",
          "unrealized_pnl_usd": null,
          "token_balance": null,
          "average_buy_price_usd": "3948.371209968930021553881069349236062352",
          "average_sell_price_usd": "3711.766598724373102968109799056730691612",
          "total_buy_count": 13,
          "total_sell_count": 15,
          "total_buy_token_amount": "1999.0764297846674",
          "total_sell_token_amount": "3285.344767166688",
          "total_buy_usd": "7893095.821889256",
          "total_sell_usd": "12194432.972063215"
        },
        {
          "network": "base",
          "address": "0xb095274743941e953c746f9c228da9c18bb6ec29",
          "name": "LAPTOP",
          "symbol": "LAPTOP",
          "decimals": 18,
          "realized_pnl_usd": "2148309.480276389",
          "unrealized_pnl_usd": null,
          "token_balance": null,
          "average_buy_price_usd": "0.0",
          "average_sell_price_usd": "3.621834900281358161020306665",
          "total_buy_count": 0,
          "total_sell_count": 416,
          "total_buy_token_amount": "0.0",
          "total_sell_token_amount": "593155.0",
          "total_buy_usd": "0.0",
          "total_sell_usd": "2148309.480276389"
        }
      ]
    }
  }
}

GET

onchain

wallets

{address}

pnl

PnL by Wallet Address

curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/onchain/wallets/{address}/pnl \
  --header 'x-cg-pro-api-key: <api-key>'

{
  "data": {
    "id": "0x4b3f1048c55faa0c0873e249e541139360501f2a",
    "type": "wallet_pnl",
    "attributes": {
      "wallet_address": "0x4b3f1048c55faa0c0873e249e541139360501f2a",
      "total_realized_pnl_usd": "17831328.189418429",
      "total_unrealized_pnl_usd": "-5265158.4349284421",
      "total_tokens": 47,
      "networks": [
        {
          "network": "eth",
          "realized_pnl_usd": "13365120.67931429",
          "unrealized_pnl_usd": "-1425379.6227395136",
          "tokens": 35
        },
        {
          "network": "base",
          "realized_pnl_usd": "4466207.510104139",
          "unrealized_pnl_usd": "-3839778.8121889285",
          "tokens": 12
        }
      ],
      "token_stats": [
        {
          "network": "eth",
          "address": "0x7f39c581f595b53c5cb19bd0b3f8da6c935e2ca0",
          "name": "Wrapped liquid staked Ether 2.0",
          "symbol": "wstETH",
          "decimals": 18,
          "realized_pnl_usd": "4301337.150173959",
          "unrealized_pnl_usd": null,
          "token_balance": null,
          "average_buy_price_usd": "3948.371209968930021553881069349236062352",
          "average_sell_price_usd": "3711.766598724373102968109799056730691612",
          "total_buy_count": 13,
          "total_sell_count": 15,
          "total_buy_token_amount": "1999.0764297846674",
          "total_sell_token_amount": "3285.344767166688",
          "total_buy_usd": "7893095.821889256",
          "total_sell_usd": "12194432.972063215"
        },
        {
          "network": "base",
          "address": "0xb095274743941e953c746f9c228da9c18bb6ec29",
          "name": "LAPTOP",
          "symbol": "LAPTOP",
          "decimals": 18,
          "realized_pnl_usd": "2148309.480276389",
          "unrealized_pnl_usd": null,
          "token_balance": null,
          "average_buy_price_usd": "0.0",
          "average_sell_price_usd": "3.621834900281358161020306665",
          "total_buy_count": 0,
          "total_sell_count": 416,
          "total_buy_token_amount": "0.0",
          "total_sell_token_amount": "593155.0",
          "total_buy_usd": "0.0",
          "total_sell_usd": "2148309.480276389"
        }
      ]
    }
  }
}

Notes

Use the sort param to rank tokens by PnL, buy or sell volume, or balance.

Every network in one request must belong to the same VM family, or the request returns a 400.

For example, networks=eth,base,arbitrum is valid because all three are EVM.
Networks from different VM families must be queried in separate calls.

Authorizations

x-cg-pro-api-key

string

header

required

Learn how to set up your API key

Path Parameters

address

string

default:0x4b3f1048c55faa0c0873e249e541139360501f2a

required

Wallet address.

Query Parameters

networks

string

default:eth,base

required

Query PnL by networks, comma-separated if more than one. *refers to /onchain/networks.

sort

enum<string>

Sort the token stats by field. Default: realized_pnl_usd_desc

Available options:

realized_pnl_usd_desc,

unrealized_pnl_usd_desc,

total_buy_usd_desc,

total_sell_usd_desc,

token_balance_desc

page

integer

Page through results. Default value: 1

per_page

integer

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

Response

200 - application/json

Wallet PnL data

data

object

required

Hide child attributes

data.id

string

required

Wallet address

data.type

string

required

Response type

data.attributes

object

required

Hide child attributes

data.attributes.wallet_address

string

required

Wallet address queried

data.attributes.total_realized_pnl_usd

string

required

All-time realized PnL in USD, across the requested networks only

data.attributes.total_unrealized_pnl_usd

string

required

All-time unrealized PnL in USD, across the requested networks only

data.attributes.total_tokens

integer

required

Number of tokens traded across the requested networks only

data.attributes.networks

object[]

required

Realized PnL, unrealized PnL and token count per network, listing only networks where the wallet traded

Hide child attributes

data.attributes.networks.network

string

required

Network ID

data.attributes.networks.realized_pnl_usd

string

required

Realized PnL on this network in USD

data.attributes.networks.unrealized_pnl_usd

string

required

Unrealized PnL on this network in USD

data.attributes.networks.tokens

integer

required

Number of tokens traded on this network

data.attributes.token_stats

object[]

required

Trading stats and PnL, one entry per token

Hide child attributes

data.attributes.token_stats.network

string

required

Network ID

data.attributes.token_stats.address

string

required

Token contract address

data.attributes.token_stats.name

string

required

Token name

data.attributes.token_stats.symbol

string

required

Token symbol

data.attributes.token_stats.decimals

integer

required

Token decimals

data.attributes.token_stats.realized_pnl_usd

string

required

Realized PnL in USD

data.attributes.token_stats.unrealized_pnl_usd

string | null

required

Unrealized PnL in USD

data.attributes.token_stats.token_balance

string | null

required

Current token balance

data.attributes.token_stats.average_buy_price_usd

string

required

Average buy price in USD

data.attributes.token_stats.average_sell_price_usd

string

required

Average sell price in USD

data.attributes.token_stats.total_buy_count

integer

required

Total number of buy transactions

data.attributes.token_stats.total_sell_count

integer

required

Total number of sell transactions

data.attributes.token_stats.total_buy_token_amount

string

required

Total buy token amount

data.attributes.token_stats.total_sell_token_amount

string

required

Total sell token amount

data.attributes.token_stats.total_buy_usd

string

required

Total buy amount in USD

data.attributes.token_stats.total_sell_usd

string

required

Total sell amount in USD

CoinGecko API

Onchain API

PnL by Wallet Address

Notes

Authorizations

Path Parameters

Query Parameters

Response

​Notes

Authorizations

Path Parameters

Query Parameters

Response

Notes