---
title: "PnL by Wallet Address"
method: GET
path: "/onchain/wallets/{address}/pnl"
---

# PnL by Wallet Address

`GET /onchain/wallets/{address}/pnl`

## Request

- Base URL: `https://pro-api.coingecko.com/api/v3`
- URL: `https://pro-api.coingecko.com/api/v3/onchain/wallets/{address}/pnl`
- Auth: one of:
  - API key in header `x-cg-pro-api-key`
  - API key in query parameter `x_cg_pro_api_key`

To query the PnL of a wallet address across networks

## Path parameters

- `address` string, required

## Query parameters

- `networks` string, required
- `sort` 'realized_pnl_usd_desc' | 'unrealized_pnl_usd_desc' | 'total_buy_usd_desc' | 'total_sell_usd_desc'
- `page` integer
- `per_page` integer

## Response `200`

Wallet PnL data

- WalletPnl
  - `data` object, required
    - `id` string, required: Wallet address
    - `type` string, required: Response type
    - `attributes` object, required
      - `wallet_address` string, required: Wallet address queried
      - `total_realized_pnl_usd` string, required: All-time realized PnL in USD, across the requested networks only
      - `total_unrealized_pnl_usd` string, required: All-time unrealized PnL in USD, across the requested networks only
      - `total_tokens` integer, required: Number of tokens traded across the requested networks only
      - `networks` object[], required: Realized PnL, unrealized PnL and token count per network, listing only networks where the wallet traded
        - `network` string, required: Network ID
        - `realized_pnl_usd` string, required: Realized PnL on this network in USD
        - `unrealized_pnl_usd` string, required: Unrealized PnL on this network in USD
        - `tokens` integer, required: Number of tokens traded on this network
      - `token_stats` object[], required: Trading stats and PnL, one entry per token
        - `network` string, required: Network ID
        - `address` string, required: Token contract address
        - `name` string, required: Token name
        - `symbol` string, required: Token symbol
        - `decimals` integer, required: Token decimals
        - `realized_pnl_usd` string, required: Realized PnL in USD
        - `unrealized_pnl_usd` string, nullable, required: Unrealized PnL in USD
        - `average_buy_price_usd` string, required: Average buy price in USD
        - `average_sell_price_usd` string, required: Average sell price in USD
        - `total_buy_count` integer, required: Total number of buy transactions
        - `total_sell_count` integer, required: Total number of sell transactions
        - `total_buy_token_amount` string, required: Total buy token amount
        - `total_sell_token_amount` string, required: Total sell token amount
        - `total_buy_usd` string, required: Total buy amount in USD
        - `total_sell_usd` string, required: Total sell amount in USD

## Changes

> 29 revisions in range; 1 not diffed.

- **2026-10-20** `321f4d85a166`: 2 breaking
  - removed the enum value `token_balance_desc` from the `query` request parameter `sort`
  - removed the required property `data/attributes/token_stats/items/token_balance` from the response with the `200` status

[Operation history](https://skmtc.dev/coingecko/apis/coingecko-api/changes/onchain/wallets/:address/pnl/get.md)

---

[API](https://skmtc.dev/coingecko/apis/coingecko-api.md) - [All operations](https://skmtc.dev/coingecko/apis/coingecko-api/llms.txt) - [OpenAPI document](https://skmtc.dev/coingecko/apis/coingecko-api/revisions/dd263cff468b?raw)