ARarbital
Portfolio

GET /v3/portfolio

Request-time Codex wallet snapshot for the authenticated principal's server-resolved Privy wallets. Codex supplies holdings, quantities, token cards, and matching wallet-position cost basis without a direct-chain display overlay. There is no PostgreSQL portfolio fallback. Not quote or sell authority; the quote path still revalidates a live chain balance.

Request

  • Base URL
    https://api.arbital.xyz (the document declares no server; this is the origin it was published from)
  • URL
    https://api.arbital.xyz/v3/portfolio
  • Auth
    HTTP bearer

Query parameters

refresh'1'

Compatibility flag accepted after a confirmed wallet change. Every request already reads Codex, so this does not change snapshot retention. When set, a live Solana or EVM balance read does not join an overlapping in-flight balance read.

include'position_recap'

Opt in to a display-only provider position recap on eligible balance rows. Omit this parameter to preserve the legacy terminal response shape.

Response

Observed wallet balances and market cards

freshness'fresh' | 'stale' required

Freshness of the request-time Codex snapshot. Successful backend reads emit fresh; stale remains a response-schema compatibility value for older deployments.

messagestring required
observed_at_msstring required
partialboolean required
price_observed_at_msstring nullable required
served_at_msstring required
statusCode200 required
successtrue required

Changes

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