Skip to main content
GET
/
portfolio
Portfolio
curl --request GET \
  --url https://api.octav.fi/v1/portfolio \
  --header 'Authorization: Bearer <token>'
{
  "address": "<string>",
  "networth": "<string>",
  "cashBalance": "<string>",
  "dailyIncome": "<string>",
  "dailyExpense": "<string>",
  "fees": "<string>",
  "feesFiat": "<string>",
  "lastUpdated": "<string>",
  "assetByProtocols": {},
  "chains": {}
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
addresses
string
required

Comma-separated list of EVM or SOL wallet addresses to retrieve portfolio data for

​
includeNFTs
boolean
default:false

Include NFT holdings in the portfolio response

​
includeImages
boolean
default:false

Include image URLs for chains, assets, and protocols

​
includeExplorerUrls
boolean
default:false

Include blockchain explorer URLs for assets and transactions

​
waitForSync
boolean
default:false

Wait for fresh data if cache is stale

Response

200 - application/json

Successful response

​
address
string

The wallet address

​
networth
string

Total portfolio net worth in USD

​
cashBalance
string

Available cash balance

​
dailyIncome
string

Income generated today

​
dailyExpense
string

Expenses incurred today

​
fees
string

Total fees in native asset

​
feesFiat
string

Total fees in USD

​
lastUpdated
string

Last sync timestamp (milliseconds since epoch)

​
assetByProtocols
object

Assets organized by protocol

​
chains
object

Assets organized by blockchain