Skip to main content
GET
/
portfolio
/
at-block
Portfolio At Block
curl --request GET \
  --url https://api.octav.fi/v1/portfolio/at-block \
  --header 'Authorization: Bearer <token>'
{
  "address": "<string>",
  "blockNumber": "<string>",
  "networth": "<string>",
  "cashBalance": "<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

A single EVM wallet address to retrieve portfolio data for. Only one address is accepted per call.

​
chainKey
enum<string>
required

Chain the block belongs to. Only ethereum is currently supported.

Available options:
ethereum
​
blockNumber
integer
required

The block number to value the portfolio at. Must be a positive integer.

Required range: x >= 1

Response

Successful response — same shape as GET /portfolio (an array with one portfolio for the requested address), each portfolio carrying a top-level blockNumber field

​
address
string

The wallet address

​
blockNumber
string

The block number the portfolio was valued at (echoes the blockNumber query parameter, returned as a string)

​
networth
string

Total portfolio net worth in USD, valued at blockNumber

​
cashBalance
string

Available cash balance at blockNumber

​
assetByProtocols
object

Assets organized by protocol, valued at blockNumber

​
chains
object

Assets organized by blockchain (only ethereum is present)