Skip to main content
GET
/
v1
/
portfolio
/
{walletAddress}
curl --request GET \
  --url https://api.bookie.app/v1/portfolio/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU \
  --header 'Authorization: Bearer bookie_live_abc123def456'

{
  "walletAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "solBalance": 12450000000,
  "tokens": [
    {
      "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "symbol": "USDC",
      "balance": 5432100000,
      "decimals": 6,
      "uiAmount": 5432.10,
      "usdValue": 5432.10
    },
    {
      "mint": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
      "symbol": "BONK",
      "balance": 1250000000000,
      "decimals": 5,
      "uiAmount": 1250000,
      "usdValue": 18.75
    }
  ],
  "totalValue": 7389.81,
  "lastUpdated": "2024-03-08T14:30:00Z"
}

​
Authorization

​
Authorization
string
required
Bearer token. Format: Bearer bookie_live_abc123def456

​
Path Parameters

​
walletAddress
string
required
Solana wallet address. Format: Base58 encoded public key

​
Query Parameters

​
includeNFTs
boolean
default:"false"
Include NFT holdings in response
​
includeStaked
boolean
default:"false"
Include staked tokens in response

​
Response

​
walletAddress
string
Solana wallet address
​
solBalance
number
SOL balance in lamports
​
tokens
array
Array of token holdingsEach token object contains:
  • mint (string): Token mint address
  • symbol (string): Token symbol
  • balance (number): Token balance in base units
  • decimals (number): Token decimals
  • uiAmount (number): Human-readable amount
  • usdValue (number): USD value
​
totalValue
number
Total portfolio value in USD
​
lastUpdated
string
ISO 8601 timestamp of last update
curl --request GET \
  --url https://api.bookie.app/v1/portfolio/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU \
  --header 'Authorization: Bearer bookie_live_abc123def456'

{
  "walletAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "solBalance": 12450000000,
  "tokens": [
    {
      "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "symbol": "USDC",
      "balance": 5432100000,
      "decimals": 6,
      "uiAmount": 5432.10,
      "usdValue": 5432.10
    },
    {
      "mint": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
      "symbol": "BONK",
      "balance": 1250000000000,
      "decimals": 5,
      "uiAmount": 1250000,
      "usdValue": 18.75
    }
  ],
  "totalValue": 7389.81,
  "lastUpdated": "2024-03-08T14:30:00Z"
}