Wallet

The Wallet endpoint allows you to easily get all the tokens in the wallet of any EVM or SOL addresses. It doesn't include protocols positions but the data is live (without any cache).

Base url

https://api.octav.fi

Method

GET

PATH

/v1/wallet

ACCESS

Restricted with an key, see API Access

Restricted to BETA tester. Contact US if you need access.

Query params

Param	Description	Type
addresses*	A EVM or SOL addresses	String

Response Type

Portfolio

Response Example

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