GET /v3/portfolio/swaps

Request-time swap history from Codex for the principal's server-resolved Privy wallets. There is no PostgreSQL or social trade-history fallback. Same-chain DEX pool events only; platformFee, trade ids, referral, and Relay bridges are null. Combines up to ten verified canonical wallets across supported chains, newest first, at most 50 events per page. Equal-second events preserve provider order within a wallet/chain and canonical source order across sources. Pagination replays the consumed boundary-second prefix; it is not an immutable provider snapshot. Any unavailable source or exhausted request budget fails the whole page without advancing. Unknown wallet identity is unavailable. 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
Auth
HTTP bearer

Query parameters

cursorstring

Opaque next_cursor returned by the previous page (maximum 2048 characters); bound to the current verified wallet set. Pass unchanged. ISO-8601 and legacy v1 cursors are accepted only as exclusive time seeks, not exact continuations. Changed boundary history or wallet identity requires restarting without a cursor.

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.