$PRIVY is live -

Skip to content
Docs

API reference

Holdings

Tokens held for you in Privy trading wallets.

List holdings

GET/api/v1/holdingsAPI key

Aggregates every open Privy position per token. These are holdings managed by Privy, not the contents of your own wallet. Sorted by USD value, largest first.

Response (array of)

  • mintstring

    Token mint.

  • namestringnullable

    Token name.

  • symbolstringnullable

    Ticker symbol.

  • decimalsintegernullable

    Token decimals.

  • amountstring

    Raw balance in smallest units.

  • balancestringnullable

    Exact decimal balance.

  • usdPricenumbernullable

    Latest USD price.

  • usdValuenumbernullable

    Estimated USD value, rounded to cents.

  • imageUrlstring · uri

    Token logo URL.

  • positionIdsstring[]

    Open positions that make up this holding.

  • sellInProgressboolean

    True while a sell of this token is executing.

curl "https://privy.ac/api/v1/holdings" \
  -H "X-API-Key: $PRIVY_API_KEY"

Try it

Sends a real request
Example response
{
  "data": [
    {
      "mint": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
      "name": "Bonk",
      "symbol": "Bonk",
      "decimals": 5,
      "amount": "161834512",
      "balance": "1618.34512",
      "usdPrice": 0.00000337,
      "usdValue": 0.01,
      "imageUrl": "https://privy.ac/api/token-image/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
      "positionIds": [
        "4a3f2c1e-8b7d-4e6f-9a01-23456789abcd"
      ],
      "sellInProgress": false
    }
  ],
  "requestId": "req_8f3a2c91d4e6b07f"
}