$PRIVY is live -

Skip to content
Docs

API reference

Activity

Your on-chain ledger of buys, sells, deposits, payouts and refunds.

List activity

GET/api/v1/activityAPI key

Your ledger of on-chain activity through Privy, newest first, with the points each entry earned.

Parameters

  • typestring · queryoptional

    Comma-separated filter: buy, sell, deposit, payout, refund.

  • limitinteger · queryoptional

    Number of results, 1 to 100. Defaults to 25.

  • cursorstring · queryoptional

    Opaque cursor from a previous response’s pagination.nextCursor.

Response (array of)

  • idstring · uuid

    Activity entry ID.

  • typestring

    Entry type.

    buyselldepositpayoutrefund

  • statusstring

    Entry status.

  • signaturestringnullable

    Transaction signature.

  • mintstringnullable

    Token mint involved.

  • symbolstringnullable

    Token symbol.

  • decimalsintegernullable

    Token decimals.

  • amountstringnullable

    Raw token amount.

  • solLamportsstringnullable

    SOL leg in lamports, for buys and sells.

  • usdValuenumbernullable

    USD value at execution.

  • pointsnumber

    Points earned by this entry.

  • createdAtstring · date-time

    When it happened.

curl "https://privy.ac/api/v1/activity?type=buy%2Csell" \
  -H "X-API-Key: $PRIVY_API_KEY"

Try it

Sends a real request
Example response
{
  "data": [
    {
      "id": "2e4f6a8c-0b1d-4e3f-a5b7-c9d1e3f5a7b9",
      "type": "buy",
      "status": "completed",
      "signature": "5h8Xb3...kQ2",
      "mint": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
      "symbol": "Bonk",
      "decimals": 5,
      "amount": "161834512",
      "solLamports": "49852211",
      "usdValue": 5.43,
      "points": 271.5,
      "createdAt": "2026-10-09T18:22:41.000Z"
    }
  ],
  "pagination": {
    "nextCursor": null,
    "hasMore": false
  },
  "requestId": "req_8f3a2c91d4e6b07f"
}