API reference

All endpoints are GET requests under https://privy.ac/api/v1. Download the OpenAPI 3.1 document to generate a client.

Endpoints

• GET/tokens/{mint}Get a tokenPublic
• GET/tokens/trendingTrending tokensPublic
• GET/tokens/searchSearch tokensPublic
• GET/quoteGet a swap quotePublic
• GET/statsPlatform statisticsPublic
• GET/meCurrent accountAPI key
• GET/holdingsList holdingsAPI key
• GET/positionsList positionsAPI key
• GET/positions/{id}Get a positionAPI key
• GET/activityList activityAPI key
• GET/pointsPoints summaryAPI key
• GET/trades/{id}Get a tradeAPI key
• GET/trades/{id}/statusGet trade statusAPI key
• POST/trade/buysCreate a buytrade:intents
• POST/trade/buys/{id}/depositSubmit deposittrade:intents
• GET/trade/buys/{id}Get a buytrade:intents
• POST/trade/buys/{id}/cancelCancel a buytrade:intents
• POST/trade/sellsCreate a sell authorizationtrade:intents
• POST/trade/sells/{id}/authorizeAuthorize a selltrade:intents
• GET/trade/sells/{id}Get a selltrade:intents

Response envelope

{
  "data": {},
  "requestId": "req_8f3a2c91d4e6b07f"
}

Amounts and numbers

Token amounts are strings of raw integers in the smallest unit, so they never lose precision. Use decimals to convert: 1,618.34512 Bonk with 5 decimals is "161834512". USD values are numbers for display; volumeUsd fields are exact decimal strings.

Pagination

List endpoints return up to limit items, newest first. When pagination.hasMore is true, pass pagination.nextCursor as cursor to get the next page. Cursors are opaque; do not build them yourself.

Response headers