Get Pnl History

post/api/v1/developer/wallet/pnl/history

Query parameters

min_liquiditynumber

Minimum liquidity of which tokens must have to be included in the response.

Request body

start_timestampstring date-time required

Start of time range (UTC ISO 8601)

end_timestampstring date-time required

End of time range (UTC ISO 8601)

granularity'1h' | '1d' | '1m' | '5m' | '15s' required

Example request

{
  "addresses": [
    {
      "address": "125Z6k4ZAxsgdG7JxrKZpwbcS1rxqpAeqM9GSCKd66Wp",
      "chain": "solana"
    }
  ],
  "end_timestamp": "2025-04-10T00:00:00Z",
  "granularity": "1h",
  "start_timestamp": "2025-04-01T00:00:00Z"
}

Response

Successful Response

errorstring nullable

Error message

cursorstring nullable

Pagination cursor for next page

Example response

{
  "data": {
    "address": "125Z6k4ZAxsgdG7JxrKZpwbcS1rxqpAeqM9GSCKd66Wp",
    "chain": "solana",
    "pnl": [
      {
        "realized_pnl": {
          "amount": "0.002335373911312482",
          "currency": "USD"
        },
        "timestamp": "2026-03-19T22:00:00Z",
        "unrealized_pnl": {
          "amount": "0.145848378518889629",
          "currency": "USD"
        }
      },
      {
        "realized_pnl": {
          "amount": "0.002335373911312482",
          "currency": "USD"
        },
        "timestamp": "2026-03-19T23:00:00Z",
        "unrealized_pnl": {
          "amount": "0.137894957302491137",
          "currency": "USD"
        }
      }
    ]
  },
  "items": [
    {
      "address": "125Z6k4ZAxsgdG7JxrKZpwbcS1rxqpAeqM9GSCKd66Wp",
      "chain": "solana",
      "pnl": [
        {
          "realized_pnl": {
            "amount": "0.002335373911312482",
            "currency": "USD"
          },
          "timestamp": "2026-03-19T22:00:00Z",
          "unrealized_pnl": {
            "amount": "0.145848378518889629",
            "currency": "USD"
          }
        },
        {
          "realized_pnl": {
            "amount": "0.002335373911312482",
            "currency": "USD"
          },
          "timestamp": "2026-03-19T23:00:00Z",
          "unrealized_pnl": {
            "amount": "0.137894957302491137",
            "currency": "USD"
          }
        }
      ]
    }
  ]
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.