crypto

Token balances held by a wallet address on one chain.

Lists the token positions of a wallet on one EVM chain with balance and, where the provider attaches them, USD price and value. Page with cursor. The chain's native coin may be excluded by the provider (see unsupported_fields and the method notes).

Fixed price: 0.2 credits per successful call, whichever provider serves it.

post/v2/ops/crypto.wallet.assets

Request

  • Base URL
    https://api.agentkey.app
  • URL
    https://api.agentkey.app/v2/ops/crypto.wallet.assets
  • Auth
    HTTP bearer

Request body

addressstring required

Wallet address (0x-prefixed hex). ENS names are not resolved.

chain'ethereum' | 'polygon' | 'bsc' | 'arbitrum' | 'optimism' | 'base' | 'avalanche'

Chain to read positions on.

cursorstring

Opaque pagination cursor from the previous response's next_cursor. Send the same query parameters with it.

fieldsstring[]

Projection: keep only these dotted paths of data, e.g. ["items.id", "items.text"].

include_rawboolean

Attach the raw upstream payload as raw (not a stable contract; truncated above 256 KB).

limitinteger

Maximum number of positions to return.

providerstring

Shorthand for routing.only = [provider].

Response

Success envelope

credits_chargednumber required

Credits charged for this call (the method's fixed price).

opstring required

Method name.

op_versioninteger required

Method version that served the call.

providerstring required

Provider that actually served the call.

rawunknown
raw_truncatedboolean
request_idstring required

Correlation id; quote it in support requests.

took_msinteger required
unsupported_fieldsstring[] required

Output paths this provider structurally does not supply; such fields are null for a different reason than 'missing on this record'.

Changes

No recorded changes to this operation across all 1 revision of this API.