Historical portfolio

To retrieve the historical value of an address for a specific date, you first need to subscribe to this address. More details here:

How to subscribe to the historical portfolio data

Base url

https://api.octav.fi

Method

GET

PATH

/v1/historical

ACCESS

Restricted with an key, see API Access

Cost per call

1 credit

Query params

Param	Description	Type
addresses*	A EVM or SOL address	String
date*	The date of the portfolio	String (YYYY-MM-DD) ex : '2025-05-21'

Response Type

Portfolio

Response Example

[
    {
        "address": "0xddda947f31da53d8f9b05ab5a0bb07713c256e35",
        "cashBalance": "0",
        "closedPnl": "13.5466715367602206822681107794098304",
        "dailyIncome": "0",
        "dailyExpense": "0",
        "fees": "48918091440000",
        "feesFiat": "0.125327383206473102336577",
        "lastUpdated": "1736976333061",
        "openPnl": "N/A",
        "networth": "1504.0972690884063639880894878216512",
        "totalCostBasis": "N/A",
        "assetByProtocols": {
            "wallet": {
                "name": "Wallet",
                "key": "wallet",
                "value": "1055.20576207293341601424",
                "totalCostBasis": "N/A",
                "totalClosedPnl": "N/A",
                "totalOpenPnl": "N/A",
                "chains": {
                    "arbitrum": {
                        "name": "Arbitrum",
                        "key": "arbitrum",
                        "value": "1055.20576207293341601424",
                        "totalCostBasis": "N/A",
                        "totalClosedPnl": "N/A",
                        "totalOpenPnl": "N/A",
                        "protocolPositions": {
                            "WALLET": {
                                "assets": [
                                    {
                                        "balance": "0.012695517744456324",
                                        "chainContract": "arbitrum:0x0000000000000000000000000000000000000000",
                                        "chainKey": "arbitrum",
                                        "contract": "0x0000000000000000000000000000000000000000",
                                        "decimal": "18",
                                        "name": "ethereum",
                                        "openPnl": "N/A",
                                        "price": "3442.76",
                                        "symbol": "eth",
                                        "totalCostBasis": "N/A",
                                        "value": "43.70762066990445401424"
                                    },
                                    {
                                        "balance": "69.9031085959246",
                                        "chainContract": "arbitrum:0xfa7f8980b0f1e64a2062791cc3b0871572f1f7f0",
                                        "chainKey": "arbitrum",
                                        "contract": "0xfa7f8980b0f1e64a2062791cc3b0871572f1f7f0",
                                        "decimal": "18",
                                        "name": "uniswap",
                                        "openPnl": "N/A",
                                        "price": "14.47",
                                        "symbol": "uni",
                                        "totalCostBasis": "N/A",
                                        "value": "1011.497981383028962"
                                    },
                                    {
                                        "balance": "15000",
                                        "chainContract": "arbitrum:0x306fd3e7b169aa4ee19412323e1a5995b8c1a1f4",
                                        "chainKey": "arbitrum",
                                        "contract": "0x306fd3e7b169aa4ee19412323e1a5995b8c1a1f4",
                                        "decimal": "18",
                                        "name": "black agnus",
                                        "openPnl": "N/A",
                                        "price": "1.0668e-8",
                                        "symbol": "ftw",
                                        "totalCostBasis": "N/A",
                                        "value": "0.00016002"
                                    }
                                ],
                                "name": "wallet",
                                "protocolPositions": [],
                                "totalOpenPnl": "N/A",
                                "totalCostBasis": "N/A",
                                "totalValue": "1055.20576207293341601424",
                                "unlockAt": "0"
                            }
                        }
                    }
                }
            },
         "chains": {
            "arbitrum": {
                "name": "Arbitrum",
                "key": "arbitrum",
                "chainId": "42161",
                "value": "1504.0972690884063639880894878216512",
                "valuePercentile": "100",
                "totalCostBasis": "N/A",
                "totalClosedPnl": "N/A",
                "totalOpenPnl": "N/A"
            }
        }
    }
]