Search
⌘K
Portfolio API
API version: v5.0
Introduction
Quickstart guide
Migration
Migration from v4 to v5.0
Methods
Check if portfolio service is available GET
Check if historical data is available GET
Get supported chains GET
Get supported protocols GET
Get current portfolio value breakdown GET
General profit and loss GET
General value chart GET
Overview report GET
Transaction history GET
History transaction types GET
Get protocols snapshot GET
Get protocols metrics GET
Get additional info for chosen token for given timerange, e.g. average buy price, inflow/outflow, pnl etc GET
Get chart for chosen token value and price with in/out transfers info for given timerange GET
Get paginated transactions info for chosen token GET
Get tokens snapshot GET
Get tokens metrics GET
Docs·APIs·Portfolio API·Methods·v5.0·Get tokens snapshot

Get tokens snapshot

Get tokens snapshot

GEThttps://api.1inch.com/portfolio/portfolio/v5.0/tokens/snapshot
Supported on:
ArbitrumAvalancheBaseBNB ChainZKsyncEthereumGnosisOptimismPolygonLineaSolanaSonicUnichain

Parameters

addresses
* array query
Wallet addresses
chain_id
any query
Blockchain chain identifier
timestamp
any query
Unix timestamp for historical snapshot
use_cache
boolean query
Get response from cache

Request Body

This request doesn’t have any request body.

1

Returns

200
422
array
items
AdapterResult object
Snapshot of a single DeFi position or token holding for an address.
index
* string
Unique position identifier
chain_id
* integer
Blockchain chain identifier
contract_address
*AddressType any
anyOf[0]
string
anyOf[1]
string
token_id
* integer
Token identifier (0 for non-NFT positions)
address
*AddressType any
anyOf[0]
string
anyOf[1]
string
block_number_created
* integer
Block number when the position was first created
block_number
any
Block number of the snapshot
anyOf[0]
integer
anyOf[1]
null
timestamp
any
Unix timestamp of the snapshot
anyOf[0]
integer
anyOf[1]
null
protocol_type
* string
Protocol type identifier (e.g. lending, dex, staking)
protocol_handler_id
* string
Protocol handler identifier
protocol_group_id
* string
Protocol group identifier (e.g. aave-v3, uniswap-v3)
protocol_group_name
* string
Human-readable protocol group name
protocol_group_icon
* any
URL of the protocol group icon
anyOf[0]
string
anyOf[1]
null
protocol_group_url
any
Dapp URL of the protocol group
anyOf[0]
string
anyOf[1]
null
protocol_sub_group_id
any
Protocol sub-group identifier
anyOf[0]
string
anyOf[1]
null
protocol_sub_group_name
any
Human-readable protocol sub-group name
anyOf[0]
string
anyOf[1]
null
contract_name
* string
Name of the contract or token
contract_symbol
* string
Symbol of the contract or token
asset_sign
* integer
Asset sign: 1 for supply/deposit, -1 for borrow/debt
status
Status integer (Enum)
Position status indicating whether a DeFi position is active or closed.
1
0
-1
underlying_tokens
array
List of underlying token balances in the position
items
object
additionalProperties
any
reward_tokens
array
List of reward token balances accrued
items
object
additionalProperties
any
value_usd
any
Total USD value of the position
anyOf[0]
number
anyOf[1]
null
locked
boolean
Whether the position is locked (e.g. vesting, timelock)
additionalProperties
none
JSON
1

Did you find what you need?