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
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