Skip to main content
GET
Returns the spot holdings of the wallets in wallets, a comma-separated list of 1 to 100 addresses, as one value summed across them. chains limits the read to a comma-separated list of chain slugs; omit it to read every chain. An EVM address counts on every EVM chain in scope, and a Solana address on Solana.

Value

A value is the sum of three parts:
  • The balance of the chain’s gas asset, at its latest price.
  • The stablecoin balances, at $1 each.
  • The open positions, at each token’s latest price.
A position adds nothing to the value when:
  • Its token has no price.
  • It is worth more than its token’s market cap.
  • Its token has no known market cap and under $1,000 of liquidity.
hideLowLiquidity=true drops every open position in a token with under $1,000 of liquidity, or with no known liquidity, from the values and the stats. A stablecoin is never dropped. The default is false.

Response

  • totalValueUsd is the value of every product. It equals spot.valueUsd, because spot is the only product.
  • spot splits the value into balances and positions, with one item in spot.chains per chain in scope. A chain with no holdings has zero values.
  • wallets lists each requested wallet’s share, in the order of the request. The shares add up to the totals. addresses holds the wallet under its format, evm or solana, and the other is null.
  • asOf is the time the response was calculated.

Stats

include=stats adds stats to the portfolio and to each wallet. stats reports performance over four timeframes: oneDay, sevenDays and thirtyDays cover positions whose first purchase falls in that window, and max covers every position. Each timeframe contains the realized and unrealized PnL per chain, the number of open positions, the trade counts, and buckets. buckets counts positions by realized return: rekt loses more than 50%, loss loses up to 50%, win returns 1x to 2x, pump from 2x to 5x, and moonshot at 5x or better.

Errors

Authorizations

Authorization
string
header
required

Send an API key, or a session token a key minted, as Authorization: Bearer <credential>. A browser opening /v1/stream offers its session token in Sec-WebSocket-Protocol instead.

Query Parameters

wallets
string
required

Wallet addresses, CSV; one to 100.

chains
string

Chains to scope to, CSV of the chain slugs. Absent means every spot chain.

include
string

Optional sections to compute, CSV; only stats. Absent returns none of them.

hideLowLiquidity
boolean
default:false

Drop open positions whose token liquidity is below the low-liquidity floor, or not known. A position in a stablecoin that a balance row can hold never drops.

Response

The named wallets' spot holdings. A gas balance without a price has a null USD value, which no total counts.

The summed spot holdings of the named wallets.

asOf
integer<int64>
required

Serve-time snapshot instant.

spot
object
required

Spot holdings of every named wallet.

totalValueUsd
string<decimal>
required

Sum of every product's value; spot is the only product.

Example:

"123.456789"

wallets
object[]
required

Each named wallet's share, in request order. The shares sum to the matching total. Their stats sum to stats.

stats
null | object

Timeframe performance; present only under include=stats.