Skip to main content
POST
/
api
/
zerion
/
wallets
/
positions
/zerion/wallets/positions
curl --request POST \
  --url https://api.anysite.io/api/zerion/wallets/positions \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "address": "<string>",
  "count": 2,
  "timeout": 300,
  "currency": "usd",
  "chains": []
}
'
[
  {
    "id": "<string>",
    "@type": "ZerionPosition",
    "name": "<string>",
    "type": "<string>",
    "protocol": "<string>",
    "value": 123,
    "amount": 123,
    "is_displayable": true,
    "is_included_in_chart": true,
    "updated_at": "<string>",
    "chain": {
      "id": "<string>",
      "@type": "ZerionChainRef",
      "name": "<string>",
      "image": "<string>",
      "is_testnet": true
    },
    "asset": {
      "@type": "ZerionAsset",
      "id": "<string>",
      "name": "<string>",
      "symbol": "<string>",
      "image": "<string>",
      "price": 123,
      "price_change_24h": 123,
      "is_verified": true,
      "contracts": {}
    },
    "dapp": {
      "@type": "ZerionDapp",
      "id": "<string>",
      "name": "<string>",
      "image": "<string>",
      "url": "<string>"
    }
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
address
string
required

Wallet address: an EVM 0x address or an ENS / identity name

Examples:

"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"

"vitalik.eth"

count
integer
required

Max number of positions to return

Required range: x >= 1
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
currency
enum<string>
default:usd

Currency to denominate position values in

Available options:
usd,
eur,
gbp,
jpy,
aud,
cad,
chf,
cny,
inr,
krw,
rub,
brl,
try,
btc,
eth
chains
enum<string>[] | null

Filter positions to these blockchain networks

Available options:
ethereum,
tron,
binance-smart-chain,
base,
arbitrum,
plasma,
ink,
avalanche,
polygon,
monad,
optimism,
mantle,
katana,
berachain,
xdai,
megaeth,
sei,
okbchain,
linea,
fraxtal,
blast,
unichain,
sonic,
celo,
zksync-era,
scroll,
abstract,
ronin,
bob,
xinfin-xdc,
soneium,
fantom,
cronos-zkevm,
manta-pacific,
aurora,
taiko,
metis-andromeda,
ape,
mode,
opbnb,
somnia,
lisk,
tomochain,
polynomial,
polygon-zkevm,
0g,
lens,
gravity-alpha,
zora,
swellchain,
redstone,
astar-zkevm,
rari,
degen,
cyber,
hyperevm,
solana,
tempo,
wonder,
world,
zero,
zkcandy,
zklink-nova,
re-al

Response

Successful Response

id
string
required
@type
string
default:ZerionPosition
name
string | null
type
string | null
protocol
string | null
value
number | null
amount
number | null
is_displayable
boolean | null
is_included_in_chart
boolean | null
updated_at
string | null
chain
object
asset
object
dapp
object