curl --request GET \
--url https://api.bookie.app/v1/portfolio/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU \
--header 'Authorization: Bearer bookie_live_abc123def456'
const response = await fetch(
'https://api.bookie.app/v1/portfolio/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU',
{
headers: {
'Authorization': `Bearer ${process.env.BOOKIE_API_KEY}`
}
}
);
const data = await response.json();
import requests
response = requests.get(
'https://api.bookie.app/v1/portfolio/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU',
headers={
'Authorization': f'Bearer {api_key}'
}
)
{
"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"
}
{
"error": {
"code": "wallet_not_found",
"message": "Wallet address does not exist or has no activity"
}
}
Portfolio & Prices
Get Portfolio
Retrieve wallet balances and token holdings
GET
/
v1
/
portfolio
/
{walletAddress}
curl --request GET \
--url https://api.bookie.app/v1/portfolio/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU \
--header 'Authorization: Bearer bookie_live_abc123def456'
const response = await fetch(
'https://api.bookie.app/v1/portfolio/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU',
{
headers: {
'Authorization': `Bearer ${process.env.BOOKIE_API_KEY}`
}
}
);
const data = await response.json();
import requests
response = requests.get(
'https://api.bookie.app/v1/portfolio/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU',
headers={
'Authorization': f'Bearer {api_key}'
}
)
{
"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"
}
{
"error": {
"code": "wallet_not_found",
"message": "Wallet address does not exist or has no activity"
}
}
Authorization
string
required
Bearer token. Format:
Bearer bookie_live_abc123def456Path Parameters
string
required
Solana wallet address. Format: Base58 encoded public key
Query Parameters
boolean
default:"false"
Include NFT holdings in response
boolean
default:"false"
Include staked tokens in response
Response
string
Solana wallet address
number
SOL balance in lamports
array
Array of token holdingsEach token object contains:
mint(string): Token mint addresssymbol(string): Token symbolbalance(number): Token balance in base unitsdecimals(number): Token decimalsuiAmount(number): Human-readable amountusdValue(number): USD value
number
Total portfolio value in USD
string
ISO 8601 timestamp of last update
curl --request GET \
--url https://api.bookie.app/v1/portfolio/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU \
--header 'Authorization: Bearer bookie_live_abc123def456'
const response = await fetch(
'https://api.bookie.app/v1/portfolio/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU',
{
headers: {
'Authorization': `Bearer ${process.env.BOOKIE_API_KEY}`
}
}
);
const data = await response.json();
import requests
response = requests.get(
'https://api.bookie.app/v1/portfolio/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU',
headers={
'Authorization': f'Bearer {api_key}'
}
)
{
"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"
}
{
"error": {
"code": "wallet_not_found",
"message": "Wallet address does not exist or has no activity"
}
}