Portfolio At Block
Retrieve a single Ethereum address’s portfolio valued at a specific historical block. Requires the Portfolio at Block add-on to be enabled for your API key.
Cost: Set monthly fee under the Portfolio at Block add-on, plus 1 credit per call
Rate limit: 100 requests/min on a dedicated bucket
Get your API key: Dev Portal
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
A single EVM wallet address to retrieve portfolio data for. Only one address is accepted per call.
Chain the block belongs to. Only ethereum is currently supported.
ethereum The block number to value the portfolio at. Must be a positive integer.
x >= 1Response
Successful response — same shape as GET /portfolio: an array holding one portfolio for the requested address, carrying a top-level blockNumber field
The wallet address
The block number the portfolio was valued at (echoes the blockNumber query parameter, returned as a string)
Total portfolio net worth in USD, valued at blockNumber
Available cash balance at blockNumber
Assets organized by protocol, valued at blockNumber
Assets organized by blockchain (only ethereum is present)
Income on the day of blockNumber
Expenses on the day of blockNumber
Fees paid
Fees paid, in fiat
When the portfolio was computed
Open PnL, or N/A when not computed
Closed PnL, or N/A when not computed
Total cost basis, or N/A when not computed
Net worth from manually entered balances
Price adapters used; empty on the block-pinned path