GET /v3/portfolio/swaps/{chain_id}/{address}

Request-time swap history of one token on one chain from Codex for the principal's server-resolved Privy wallets. Only wallets on the token's chain are read and the provider filters to swaps whose input or output is that token; a chain without a wallet returns an empty complete page. Native coins trade through their wrapped token: address native is rejected with 400. Same page shape, ordering, cursor rules and failure semantics as GET /v3/portfolio/swaps; the cursor is bound to the wallet set and the token. Display only; never balance, quote, execution or settlement authority.

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/swaps/{chain_id}/{address}
Auth
HTTP bearer

Path parameters

chain_id'eip155:1' | 'eip155:56' | 'eip155:143' | 'eip155:4663' | 'eip155:5042' | 'eip155:8453' | 'eip155:42161' | 'solana:mainnet-beta' required

addressstring required

Canonical Solana mint or nonzero EVM token address, or native for the chain native asset. EVM case is normalized.

Query parameters

cursorstring

Opaque next_cursor returned by the previous page of this token's history (maximum 2048 characters); bound to the current verified wallet set and the token. Pass unchanged. A cursor from the unscoped history or another token is rejected with 400.

Response

Observed same-chain DEX swaps

messagestring required

statusCode200 required

successtrue required

Example response

{
  "responseObject": {
    "swaps": [
      {
        "inExecutionPriceUsd": "0.2",
        "outExecutionPriceUsd": "0.2",
        "receipt": {
          "executionPriceUsd": "0.2"
        }
      }
    ]
  }
}

Changes

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