GateData.AI

Wallet intelligence

Query wallet balances, labels, and P&L.

GET/api/v1/wallets/{address}
Domain
Flows & Wallets
Level
On-chain address
MCP tool
ownership_flows_query (task=wallet_profile)

Available data

Returns
Wallet balances, labels, and P&L
Market coverage
Major EVM chains and Solana
Query granularity
One address per query; holdings are for that address only

Authentication

Send Authorization: Bearer YOUR_API_KEY or X-API-KEY on every request.

Query Parameters

Wallet positioning

address and chain are required.

addressstringpathExample0x1ab4973a48dc892cd9971ece8e01dcc7688f8f23required

Wallet address.

chainstringqueryExampleethereumrequired

Chain code.

Filters

All optional.

querystringqueryExampleETHoptional

Filter by asset name or symbol.

asset_idstringqueryExampleasset_ethoptional

Filter by canonical asset ID.

deployment_idstringqueryExampledeployment_ethoptional

Filter by deployment ID.

token_addressstringqueryExample0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48optional

Filter by token contract address.

includestringqueryExamplepnloptional

Additional content, such as pnl.

pnl_windowstringqueryExample30doptional

PnL window: 7d, 30d, or 90d.

Pagination

All optional.

pageintegerqueryExample1optional

Page number, starting at 1.

page_sizeintegerqueryExample20optional

Rows per page.

Response

walletobject

Wallet overview

addressstring / string / string[]Example0x1ab4973a48dc892cd9971ece8e01dcc7688f8f…

Address, chain, and labels

chainstring / string / string[]Exampleethereum

Address, chain, and labels

labels[]string / string / string[]Examplesmart_money

Address, chain, and labels

native_balancedecimal string | nullExample1.25

Native balance and portfolio value in USD

native_balance_usddecimal string | nullExample4250.00

Native balance and portfolio value in USD

portfolio_value_usddecimal string | nullExample98250.00

Native balance and portfolio value in USD

balance_timestampdatetime | nullExample2026-09-18T06:30:00Z

Balance snapshot time

items[]object[]

Wallet asset rows

asset_idstring | nullExampleasset_eth

Asset identity

chainstring | nullExampleethereum

Asset identity

symbolstring | nullExampleETH

Asset identity

token_addressstring | null

Asset identity

balancedecimal string | nullExample12.50

Balance, price, and average cost

balance_usddecimal string | nullExample42500.00

Balance, price, and average cost

price_usddecimal string | nullExample3400.00

Balance, price, and average cost

avg_cost_usddecimal string | nullExample2450.20

Balance, price, and average cost

realized_pnl_usddecimal string | nullExample1200.00

Realized, unrealized, and total PnL

unrealized_pnl_usddecimal string | nullExample6600.00

Realized, unrealized, and total PnL

total_pnl_usddecimal string | nullExample7800.00

Realized, unrealized, and total PnL

pnl_percentdecimal string | nullExample18.40

Realized, unrealized, and total PnL

pnl_statusstring | nullExampleestimated

PnL calculation status

data_statusDataStatusExamplepartial

Data availability status

pageintegerExample1

Current page and page size

page_sizeintegerExample20

Current page and page size

metadataobject

Task, completeness, limitations, and update time

object_refs[]object[]

Unified object references

Errors & fallback

200
assets_resolve name multi-match; confirm from data[] candidates.
200
The object resolved but no data is available; empty_reason may be not_covered_by_source, unsupported_metric, or limited_depth.
400
Invalid parameters or an ambiguous market listing; ambiguity responses include required_params + candidates.
401
The API key is missing or invalid.
403
The current key scope or plan cannot access this data domain.
404
The requested resource does not exist; source coverage gaps are not 404 responses.
402
Credits or monthly quota exhausted.
429
Request rate exceeded; retry_after is returned in the body and Retry-After in the response headers.