Token overview

The token overview endpoint allows you to retrieve a detailed view of the tokens owned by an address on his wallet and in the protocol positions. Specify a date to get historical token overview.

Base url

https://api.octav.fi

Method

GET

PATH

/v1/token-overview

ACCESS

Restricted with an key, see API Access

Limited to paid addresses only (Octav PRO subscription)

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

Token overview

Response Example

[
    {
        "image": "https://images.octav.fi/tokens/small/0x7a0c53f7eb34c5bc8b01691723669ada9d6cb384_logo_95663531-19b7-4994-bbae-865b41e4a962.png",
        "symbol": "boo",
        "price": "0.11599401372924134",
        "name": "spookytoken v2",
        "balance": "53432.7951972119950179478305",
        "value": "6197.884379718002216111886256747709370817835",
        "percentage": 64.78281097705006,
        "protocolsDetailed": [
            {
                "key": "wallet",
                "value": "1.1599401372924134e-19",
                "balance": "1e-18",
                "name": "Wallet",
                "image": "https://images.octav.fi/protocols/wallet.png"
            },
            {
                "key": "spookyswap",
                "value": "1.13357835744587382109147726432035e-7",
                "balance": "7.974937678839605e-7",
                "name": "SpookySwap",
                "image": "https://images.octav.fi/protocols/spookyswap_logo_213edea2-5cbc-4105-a90e-af450a4e5242_f43b5e8b-a8b2-4588-81b5-6a5b0eed3f97.png"
            },
            {
                "key": "lynx",
                "value": "2082.1887559943003533298166249826324030458",
                "balance": "17950.82943551417125006287",
                "name": "Lynx",
                "image": "https://images.octav.fi/protocols/lynx_logo_a9e81340-4223-4d72-a247-b3904f552a8f_749a9dad-ddc5-421b-9124-b464e5593b7c.png"
            },
            {
                "key": "spookyswap3",
                "value": "4115.6956236103440270373662556422",
                "balance": "35481.96576090033",
                "name": "SpookySwap V3",
                "image": "https://images.octav.fi/protocols/spookyswap3_logo_8d05030f-1828-4a67-b40e-3ba36bc912ea_1c6c142e-b60d-4a37-8265-672dff44be86.png"
            }
        ]
    },
    {
        "image": "https://images.octav.fi/tokens/small/NoImageAvailable_small.png",
        "symbol": "ws",
        "price": "0.3147",
        "name": "wrapped sonic",
        "balance": "8566.757856635413739347",
        "value": "2695.9586974831647037725009",
        "percentage": 28.179257953329625,
        "protocolsDetailed": [
            {
                "key": "lynx",
                "value": "2695.9586974831647037725009",
                "balance": "8566.757856635413739347",
                "name": "Lynx",
                "image": "https://images.octav.fi/protocols/lynx_logo_a9e81340-4223-4d72-a247-b3904f552a8f_749a9dad-ddc5-421b-9124-b464e5593b7c.png"
            }
        ]
    },
    {
        "image": "https://images.octav.fi/chains/sonic_icon.png",
        "symbol": "s",
        "price": "0.316127",
        "name": "sonic",
        "balance": "1415.6881621224037",
        "value": "447.2518516272691144699",
        "percentage": 4.674858449751094,
        "protocolsDetailed": [
            {
                "key": "wallet",
                "value": "384.3118516272691144699",
                "balance": "1215.6881621224037",
                "name": "Wallet",
                "image": "https://images.octav.fi/protocols/wallet.png"
            },
            {
                "key": "mysoniclabs",
                "value": "62.94",
                "balance": "200",
                "name": "MySonic",
                "image": "https://images.octav.fi/protocols/mysoniclabs_logo_745a32e1-ff15-4be8-87f1-75cc840609a3_72daf1a8-578d-41cc-b439-23dface511f9.png"
            }
        ]
    },
    {
        "image": "https://images.octav.fi/tokens/small/NoImageAvailable_small.png",
        "symbol": "usdc.e",
        "price": "0.999424",
        "name": "bridged usdc (sonic labs)",
        "balance": "101.185744",
        "value": "101.127461011456",
        "percentage": 1.0570253960743026,
        "protocolsDetailed": [
            {
                "key": "wallet",
                "value": "101.127461011456",
                "balance": "101.185744",
                "name": "Wallet",
                "image": "https://images.octav.fi/protocols/wallet.png"
            }
        ]
    },
    {
        "image": "https://images.octav.fi/tokens/flare_logo.png",
        "symbol": "flr",
        "price": "0.01607",
        "name": "flare",
        "balance": "3478.261396189125",
        "value": "55.89566063675923875",
        "percentage": 0.5842442026376212,
        "protocolsDetailed": [
            {
                "key": "wallet",
                "value": "55.89566063675923875",
                "balance": "3478.261396189125",
                "name": "Wallet",
                "image": "https://images.octav.fi/protocols/wallet.png"
            }
        ]
    },
    {
        "image": "https://images.octav.fi/tokens/small/BNB_small_icon.png",
        "symbol": "bnb",
        "price": "668.5",
        "name": "bnb",
        "balance": "0.038045995",
        "value": "25.4337476575",
        "percentage": 0.2658438857500565,
        "protocolsDetailed": [
            {
                "key": "wallet",
                "value": "25.4337476575",
                "balance": "0.038045995",
                "name": "Wallet",
                "image": "https://images.octav.fi/protocols/wallet.png"
            }
        ]
    },
    {
        "image": "https://images.octav.fi/tokens/small/0x775f95fb27da55c025eed5ebd7595a2fea5af081_logo_a4fe8fa9-e829-4f81-aa1f-ad43350f76f5.png",
        "symbol": "booo",
        "price": "0.000003504267949024113",
        "name": "booo",
        "balance": "6000000",
        "value": "21.025607694144678",
        "percentage": 0.21976821209907088,
        "protocolsDetailed": [
            {
                "key": "wallet",
                "value": "21.025607694144678",
                "balance": "6000000",
                "name": "Wallet",
                "image": "https://images.octav.fi/protocols/wallet.png"
            }
        ]
    },
    {
        "image": "https://images.octav.fi/tokens/small/0x4e2e5742e0a641787835629054577d7c5df47dc1_logo_fbcc3ce0-897b-4770-b3e9-9248f91ac265.png",
        "symbol": "dboo",
        "price": "0.000005473019852149464",
        "name": "devilspooky",
        "balance": "2000000",
        "value": "10.946039704298928",
        "percentage": 0.11441246361926269,
        "protocolsDetailed": [
            {
                "key": "wallet",
                "value": "10.946039704298928",
                "balance": "2000000",
                "name": "Wallet",
                "image": "https://images.octav.fi/protocols/wallet.png"
            }
        ]
    },
    {
        "image": "https://images.octav.fi/tokens/small/0x3ee2200efb3400fabb9aacf31297cbdd1d435d47_small_icon.png",
        "symbol": "ada",
        "price": "0.609869",
        "name": "binance-peg cardano",
        "balance": "11.81907851",
        "value": "7.20808959181519",
        "percentage": 0.07534188715431502,
        "protocolsDetailed": [
            {
                "key": "wallet",
                "value": "7.20808959181519",
                "balance": "11.81907851",
                "name": "Wallet",
                "image": "https://images.octav.fi/protocols/wallet.png"
            }
        ]
    },
    {
        "image": "https://images.octav.fi/tokens/small/0x4e15361fd6b4bb609fa63c81a2be19d873717870_small_icon.png",
        "symbol": "ftm",
        "price": "0.320636",
        "name": "fantom",
        "balance": "10.373705747469770508",
        "value": "3.2967890616223056465172",
        "percentage": 0.034459381544642745,
        "protocolsDetailed": [
            {
                "key": "wallet",
                "value": "3.2731709526183199878196",
                "balance": "10.2986561478384211",
                "name": "Wallet",
                "image": "https://images.octav.fi/protocols/wallet.png"
            },
            {
                "key": "pwawallet",
                "value": "0.0236181090039856586976",
                "balance": "0.075049599631349408",
                "name": "Fantom fWallet",
                "image": "https://images.octav.fi/protocols/pwawallet_logo_de8b9f40-aa4a-4bc7-96e8-d7467e116bca.png"
            }
        ]
    },
    {
        "image": "https://images.octav.fi/tokens/small/0xdac17f958d2ee523a2206206994597c13d831ec7_small_icon.png",
        "symbol": "usdt",
        "price": "1",
        "name": "tether",
        "balance": "1.005685",
        "value": "1.005685",
        "percentage": 0.010511829080041488,
        "protocolsDetailed": [
            {
                "key": "wallet",
                "value": "1.005685",
                "balance": "1.005685",
                "name": "Wallet",
                "image": "https://images.octav.fi/protocols/wallet.png"
            }
        ]
    },
    {
        "image": "https://images.octav.fi/tokens/small/0x6c021ae822bea943b2e66552bde1d2696a53fbb7_small_icon.png",
        "symbol": "tomb",
        "price": "0.0025833496538441286",
        "name": "tomb",
        "balance": "28.31209043674171",
        "value": "0.073140029029360360242566798223906",
        "percentage": 0.0007644893620426961,
        "protocolsDetailed": [
            {
                "key": "tarot",
                "value": "0.073140029029360360242566798223906",
                "balance": "28.31209043674171",
                "name": "Tarot",
                "image": "https://images.octav.fi/protocols/tarot_logo_e7da5064-55b4-4f0b-befd-00443f64fa67.png"
            }
        ]
    },
    {
        "image": "https://images.octav.fi/chains/ethereum_icon.svg",
        "symbol": "eth",
        "price": "2744.34",
        "name": "ethereum",
        "balance": "0.000023255333766001",
        "value": "0.06382054266738717933",
        "percentage": 0.0006670782962011655,
        "protocolsDetailed": [
            {
                "key": "wallet",
                "value": "0.06382054266738444",
                "balance": "0.000023255333766",
                "name": "Wallet",
                "image": "https://images.octav.fi/protocols/wallet.png"
            },
            {
                "key": "lido",
                "value": "2.73933e-15",
                "balance": "1e-18",
                "name": "LIDO",
                "image": "https://images.octav.fi/protocols/lido_logo_42f90723-224e-4295-b305-aab61fe2f1ad_cddd8dd5-6686-4e22-be57-b55b31b180a3.png"
            }
        ]
    },
    {
        "image": "https://images.octav.fi/tokens/small/NoImageAvailable_small.png",
        "symbol": "9mm",
        "price": "0.00006906203497999776",
        "name": "shigure ui",
        "balance": "30.069",
        "value": "0.00207662632981355264544",
        "percentage": 0.000021705743888110022,
        "protocolsDetailed": [
            {
                "key": "wallet",
                "value": "0.00207662632981355264544",
                "balance": "30.069",
                "name": "Wallet",
                "image": "https://images.octav.fi/protocols/wallet.png"
            }
        ]
    },
    {
        "image": "https://images.octav.fi/tokens/small/NoImageAvailable_small.png",
        "symbol": "nato",
        "price": "0.00000127",
        "name": "the nation token",
        "balance": "1000",
        "value": "0.00127",
        "percentage": 0.000013274557074683116,
        "protocolsDetailed": [
            {
                "key": "wallet",
                "value": "0.00127",
                "balance": "1000",
                "name": "Wallet",
                "image": "https://images.octav.fi/protocols/wallet.png"
            }
        ]
    },
    {
        "image": "https://images.octav.fi/tokens/small/NoImageAvailable_small.png",
        "symbol": "boomer",
        "price": "0.00194439",
        "name": "boomer",
        "balance": "0.0336",
        "value": "0.000065331504",
        "percentage": 6.828714792306208e-7,
        "protocolsDetailed": [
            {
                "key": "wallet",
                "value": "0.000065331504",
                "balance": "0.0336",
                "name": "Wallet",
                "image": "https://images.octav.fi/protocols/wallet.png"
            }
        ]
    },
    {
        "image": "https://images.octav.fi/tokens/small/NoImageAvailable_small.png",
        "symbol": "boe",
        "price": "0.00003645",
        "name": "boe",
        "balance": "0.69",
        "value": "0.0000251505",
        "percentage": 2.628832659108801e-7,
        "protocolsDetailed": [
            {
                "key": "wallet",
                "value": "0.0000251505",
                "balance": "0.69",
                "name": "Wallet",
                "image": "https://images.octav.fi/protocols/wallet.png"
            }
        ]
    },
    {
        "image": "https://images.octav.fi/tokens/small/0x21be370d5312f44cb42ce377bc9b8a0cef1a4c83_small_icon.png",
        "symbol": "wftm",
        "price": "0.3147",
        "name": "wrapped fantom",
        "balance": "0.00003037413796168698413",
        "value": "0.000009558741216542893905711",
        "percentage": 9.991185499301148e-8,
        "protocolsDetailed": [
            {
                "key": "spookyswap",
                "value": "0.000009558741216542893905711",
                "balance": "0.00003037413796168698413",
                "name": "SpookySwap",
                "image": "https://images.octav.fi/protocols/spookyswap_logo_213edea2-5cbc-4105-a90e-af450a4e5242_f43b5e8b-a8b2-4588-81b5-6a5b0eed3f97.png"
            }
        ]
    },
    {
        "image": "https://images.octav.fi/tokens/small/0x1b6382dbdea11d97f24495c9a90b7c88469134a4_small_icon.png",
        "symbol": "axlusdc",
        "price": "0.9998000399920016",
        "name": "axlusdc",
        "balance": "0.000006354838649745525",
        "value": "0.00000635356793615829334336487539284",
        "percentage": 6.641007889481093e-8,
        "protocolsDetailed": [
            {
                "key": "spookyswap",
                "value": "0.00000635356793615829334336487539284",
                "balance": "0.000006354838649745525",
                "name": "SpookySwap",
                "image": "https://images.octav.fi/protocols/spookyswap_logo_213edea2-5cbc-4105-a90e-af450a4e5242_f43b5e8b-a8b2-4588-81b5-6a5b0eed3f97.png"
            }
        ]
    },
    {
        "image": "https://images.octav.fi/tokens/small/NoImageAvailable_small.png",
        "symbol": "usdc",
        "price": "0.9998000399920016",
        "name": "usd coin",
        "balance": "0.000006242269157266846",
        "value": "0.0000062410209530762307558463568589536",
        "percentage": 6.523369200464854e-8,
        "protocolsDetailed": [
            {
                "key": "spookyswap",
                "value": "0.0000062410209530762307558463568589536",
                "balance": "0.000006242269157266846",
                "name": "SpookySwap",
                "image": "https://images.octav.fi/protocols/spookyswap_logo_213edea2-5cbc-4105-a90e-af450a4e5242_f43b5e8b-a8b2-4588-81b5-6a5b0eed3f97.png"
            }
        ]
    },
    {
        "image": "https://images.octav.fi/tokens/small/0x6cc35220349c444c39b8e26b359757739aaec952_small_icon.png",
        "symbol": "cgs",
        "price": "0",
        "name": "cougar token",
        "balance": "0.6684633233087955",
        "value": "0",
        "percentage": 0,
        "protocolsDetailed": [
            {
                "key": "wallet",
                "value": "0",
                "balance": "0.6684633233087955",
                "name": "Wallet",
                "image": "https://images.octav.fi/protocols/wallet.png"
            }
        ]
    },
    {
        "image": "https://images.octav.fi/tokens/small/0x5b2af7fd27e2ea14945c82dd254c79d3ed34685e_small_icon.png",
        "symbol": "jefe",
        "price": "0",
        "name": "jefe",
        "balance": "597561474469.2265",
        "value": "0",
        "percentage": 0,
        "protocolsDetailed": [
            {
                "key": "wallet",
                "value": "0",
                "balance": "597561474469.2265",
                "name": "Wallet",
                "image": "https://images.octav.fi/protocols/wallet.png"
            }
        ]
    },
    {
        "image": "https://images.octav.fi/tokens/small/0x1897ddd96234cf238ca6f8815abc640fffb49182_logo_baba1b39-bcc0-40a3-a3f0-23777ec317e3.png",
        "symbol": "adidas",
        "price": "0",
        "name": "adidas",
        "balance": "275",
        "value": "0",
        "percentage": 0,
        "protocolsDetailed": [
            {
                "key": "wallet",
                "value": "0",
                "balance": "275",
                "name": "Wallet",
                "image": "https://images.octav.fi/protocols/wallet.png"
            }
        ]
    },
    {
        "image": "https://images.octav.fi/tokens/small/NoImageAvailable_small.png",
        "symbol": "polter",
        "price": "0",
        "name": "polter.finance protocol token",
        "balance": "0.0001286699976267398",
        "value": "0",
        "percentage": 0,
        "protocolsDetailed": [
            {
                "key": "spookyswap",
                "value": "0",
                "balance": "0.0001286699976267398",
                "name": "SpookySwap",
                "image": "https://images.octav.fi/protocols/spookyswap_logo_213edea2-5cbc-4105-a90e-af450a4e5242_f43b5e8b-a8b2-4588-81b5-6a5b0eed3f97.png"
            }
        ]
    },
    {
        "image": "https://images.octav.fi/tokens/small/NoImageAvailable_small.png",
        "symbol": "muttski",
        "price": "0",
        "name": "muttski",
        "balance": "138904457.36114025",
        "value": "0",
        "percentage": 0,
        "protocolsDetailed": [
            {
                "key": "spookyswap",
                "value": "0",
                "balance": "138904457.36114025",
                "name": "SpookySwap",
                "image": "https://images.octav.fi/protocols/spookyswap_logo_213edea2-5cbc-4105-a90e-af450a4e5242_f43b5e8b-a8b2-4588-81b5-6a5b0eed3f97.png"
            }
        ]
    },
    {
        "image": "https://images.octav.fi/tokens/small/0x658b0c7613e890ee50b8c4bc6a3f41ef411208ad_small_icon.png",
        "symbol": "feth",
        "price": "41.11031587443017",
        "name": "feth",
        "balance": "-0.000005500000000001",
        "value": "-0.00022610673730940704531587443017",
        "percentage": 0.0000023633596766803986,
        "protocolsDetailed": [
            {
                "key": "pwawallet",
                "value": "-0.00022610673730940704531587443017",
                "balance": "-0.000005500000000001",
                "name": "Fantom fWallet",
                "image": "https://images.octav.fi/protocols/pwawallet_logo_de8b9f40-aa4a-4bc7-96e8-d7467e116bca.png"
            }
        ]
    }
]

Last updated