--- title: "GET /v2/social/traders/{trader_profile_id}/swaps" method: GET path: "/v2/social/traders/{trader_profile_id}/swaps" tags: ["Social Activity"] --- # GET /v2/social/traders/{trader_profile_id}/swaps `GET /v2/social/traders/{trader_profile_id}/swaps` ## 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/v2/social/traders/{trader_profile_id}/swaps` - Auth: HTTP bearer Reads Codex swap history for only the server-resolved, provider-verified public wallets attached to the profile. Coverage is provider_wallet_history. 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. ## Path parameters - `trader_profile_id` string, uuid, required ## Query parameters - `cursor` string ## Response `200` Provider wallet swap history - ExternalTraderSwaps: Request-time provider wallet history for server-resolved, verified public-platform wallets. - `complete` boolean, required: True only when every configured wallet-chain read succeeded. - `coverage` 'provider_wallet_history', required - `source` 'codex', required - `swaps` CodexWatchSwapHistoryObject, required - `hasNextPage` boolean, required - `next_cursor` string, nullable, required: Opaque wallet-set-bound boundary continuation. Null proves exhaustion for this provider read. Pass unchanged; 400 means restart, 503 means retry the same cursor. - `swaps` CodexWatchSwap[], required - union - object - `address` string, required - `createdAt` string, date-time, required - `humanUsdAmountIn` number, required - `humanUsdAmountOut` number, required - `id` string, required - `inAmount` number, required: Legacy numeric atomic amount. May be rounded above JavaScript's safe integer limit; use inAmountAtomic. - `inAmountAtomic` string: Exact input amount in atomic units when the provider value and token decimals permit an unambiguous conversion. - `inHumanAmount` number, required - `inNetworkId` integer, required - `inTokenAddress` string, required - `inTokenImageUrl` string, nullable, required - `inTokenName` string, nullable, required - `inTokenSymbol` string, nullable, required - `inTradeId` unknown, required - `isCrossmint` false, required - `isOffPlatform` true, required - `networkId` integer, required - `outAmount` number, required: Legacy numeric atomic amount. May be rounded above JavaScript's safe integer limit; use outAmountAtomic. - `outAmountAtomic` string: Exact output amount in atomic units when the provider value and token decimals permit an unambiguous conversion. - `outHumanAmount` number, required - `outNetworkId` integer, required - `outTokenAddress` string, required - `outTokenImageUrl` string, nullable, required - `outTokenName` string, nullable, required - `outTokenSymbol` string, nullable, required - `outTradeId` unknown, required - `platformFeeAmount` unknown, required - `platformFeeHumanAmount` unknown, required - `platformFeeToken` unknown, required - `provider` string, required - `recipient` unknown, required - `referralFeeAddress` unknown, required - `referralFeeHumanAmount` unknown, required - `referralFeeToken` unknown, required - `referralFeeTokenAmount` unknown, required - `signature` string, required - `inExecutionPriceUsd` string, nullable, required: Historical USD consideration divided by the exact quantity of this token in this fill. Decimal string rounded half up to at most 18 fractional digits. Null when unavailable; never substituted with a current quote, portfolio average entry, or zero. Does not add network fees. - `inExecutionPriceUnavailableReason` 'missing_usd_value' | 'invalid_usd_value' | 'invalid_token_amount' | 'price_out_of_range' | 'historical_swap_unavailable' | 'historical_swap_not_found' | 'historical_swap_ambiguous' | 'historical_lookup_incomplete' | 'historical_lookup_limited' | 'unsupported_trade' | 'null', nullable, required: Null when the execution price is available; otherwise the reason it could not be determined. Treat unavailable values as unknown, without a current-price fallback. - `outExecutionPriceUsd` string, nullable, required: Historical USD consideration divided by the exact quantity of this token in this fill. Decimal string rounded half up to at most 18 fractional digits. Null when unavailable; never substituted with a current quote, portfolio average entry, or zero. Does not add network fees. - `outExecutionPriceUnavailableReason` 'missing_usd_value' | 'invalid_usd_value' | 'invalid_token_amount' | 'price_out_of_range' | 'historical_swap_unavailable' | 'historical_swap_not_found' | 'historical_swap_ambiguous' | 'historical_lookup_incomplete' | 'historical_lookup_limited' | 'unsupported_trade' | 'null', nullable, required: Null when the execution price is available; otherwise the reason it could not be determined. Treat unavailable values as unknown, without a current-price fallback. - `receipt` union: Immutable historical display receipt. Pending values are finalized once; never current price, balance, settlement or lifecycle authority. Optional during rollout. Entry is null for buys; USDC sells finalize immediately with available Entry or missing_purchase_history. - object - … - object - … - object - … - object - `address` string, required - `createdAt` string, date-time, required - `humanUsdAmountIn` number, required - `humanUsdAmountOut` number, required - `id` string, required - `inAmount` number, required: Legacy numeric atomic amount. May be rounded above JavaScript's safe integer limit; use inAmountAtomic. - `inAmountAtomic` string: Exact input amount in atomic units when the provider value and token decimals permit an unambiguous conversion. - `inHumanAmount` number, required - `inNetworkId` integer, required - `inTokenAddress` string, required - `inTokenImageUrl` string, nullable, required - `inTokenName` string, nullable, required - `inTokenSymbol` string, nullable, required - `inTradeId` unknown, required - `isCrossmint` false, required - `isOffPlatform` true, required - `networkId` integer, required - `outAmount` number, required: Legacy numeric atomic amount. May be rounded above JavaScript's safe integer limit; use outAmountAtomic. - `outAmountAtomic` string: Exact output amount in atomic units when the provider value and token decimals permit an unambiguous conversion. - `outHumanAmount` number, required - `outNetworkId` integer, required - `outTokenAddress` string, required - `outTokenImageUrl` string, nullable, required - `outTokenName` string, nullable, required - `outTokenSymbol` string, nullable, required - `outTradeId` unknown, required - `platformFeeAmount` unknown, required - `platformFeeHumanAmount` unknown, required - `platformFeeToken` unknown, required - `provider` string, required - `recipient` unknown, required - `referralFeeAddress` unknown, required - `referralFeeHumanAmount` unknown, required - `referralFeeToken` unknown, required - `referralFeeTokenAmount` unknown, required - `signature` string, required - `inExecutionPriceUsd` string, nullable, required: Historical USD consideration divided by the exact quantity of this token in this fill. Decimal string rounded half up to at most 18 fractional digits. Null when unavailable; never substituted with a current quote, portfolio average entry, or zero. Does not add network fees. - `inExecutionPriceUnavailableReason` 'missing_usd_value' | 'invalid_usd_value' | 'invalid_token_amount' | 'price_out_of_range' | 'historical_swap_unavailable' | 'historical_swap_not_found' | 'historical_swap_ambiguous' | 'historical_lookup_incomplete' | 'historical_lookup_limited' | 'unsupported_trade' | 'null', nullable, required: Null when the execution price is available; otherwise the reason it could not be determined. Treat unavailable values as unknown, without a current-price fallback. - `outExecutionPriceUsd` string, nullable, required: Historical USD consideration divided by the exact quantity of this token in this fill. Decimal string rounded half up to at most 18 fractional digits. Null when unavailable; never substituted with a current quote, portfolio average entry, or zero. Does not add network fees. - `outExecutionPriceUnavailableReason` 'missing_usd_value' | 'invalid_usd_value' | 'invalid_token_amount' | 'price_out_of_range' | 'historical_swap_unavailable' | 'historical_swap_not_found' | 'historical_swap_ambiguous' | 'historical_lookup_incomplete' | 'historical_lookup_limited' | 'unsupported_trade' | 'null', nullable, required: Null when the execution price is available; otherwise the reason it could not be determined. Treat unavailable values as unknown, without a current-price fallback. - `receipt` union: Immutable historical display receipt. Pending values are finalized once; never current price, balance, settlement or lifecycle authority. Optional during rollout. Entry is null for buys; USDC sells finalize immediately with available Entry or missing_purchase_history. - object - … - object - … - object - … - object - `address` string, required - `createdAt` string, date-time, required - `humanUsdAmountIn` number, required - `humanUsdAmountOut` number, required - `id` string, required - `inAmount` number, required: Legacy numeric atomic amount. May be rounded above JavaScript's safe integer limit; use inAmountAtomic. - `inAmountAtomic` string: Exact input amount in atomic units when the provider value and token decimals permit an unambiguous conversion. - `inHumanAmount` number, required - `inNetworkId` integer, required - `inTokenAddress` string, required - `inTokenImageUrl` string, nullable, required - `inTokenName` string, nullable, required - `inTokenSymbol` string, nullable, required - `inTradeId` unknown, required - `isCrossmint` false, required - `isOffPlatform` true, required - `networkId` integer, required - `outAmount` number, required: Legacy numeric atomic amount. May be rounded above JavaScript's safe integer limit; use outAmountAtomic. - `outAmountAtomic` string: Exact output amount in atomic units when the provider value and token decimals permit an unambiguous conversion. - `outHumanAmount` number, required - `outNetworkId` integer, required - `outTokenAddress` string, required - `outTokenImageUrl` string, nullable, required - `outTokenName` string, nullable, required - `outTokenSymbol` string, nullable, required - `outTradeId` unknown, required - `platformFeeAmount` unknown, required - `platformFeeHumanAmount` unknown, required - `platformFeeToken` unknown, required - `provider` string, required - `recipient` unknown, required - `referralFeeAddress` unknown, required - `referralFeeHumanAmount` unknown, required - `referralFeeToken` unknown, required - `referralFeeTokenAmount` unknown, required - `signature` string, required - `inExecutionPriceUsd` string, nullable, required: Historical USD consideration divided by the exact quantity of this token in this fill. Decimal string rounded half up to at most 18 fractional digits. Null when unavailable; never substituted with a current quote, portfolio average entry, or zero. Does not add network fees. - `inExecutionPriceUnavailableReason` 'missing_usd_value' | 'invalid_usd_value' | 'invalid_token_amount' | 'price_out_of_range' | 'historical_swap_unavailable' | 'historical_swap_not_found' | 'historical_swap_ambiguous' | 'historical_lookup_incomplete' | 'historical_lookup_limited' | 'unsupported_trade' | 'null', nullable, required: Null when the execution price is available; otherwise the reason it could not be determined. Treat unavailable values as unknown, without a current-price fallback. - `outExecutionPriceUsd` string, nullable, required: Historical USD consideration divided by the exact quantity of this token in this fill. Decimal string rounded half up to at most 18 fractional digits. Null when unavailable; never substituted with a current quote, portfolio average entry, or zero. Does not add network fees. - `outExecutionPriceUnavailableReason` 'missing_usd_value' | 'invalid_usd_value' | 'invalid_token_amount' | 'price_out_of_range' | 'historical_swap_unavailable' | 'historical_swap_not_found' | 'historical_swap_ambiguous' | 'historical_lookup_incomplete' | 'historical_lookup_limited' | 'unsupported_trade' | 'null', nullable, required: Null when the execution price is available; otherwise the reason it could not be determined. Treat unavailable values as unknown, without a current-price fallback. - `receipt` union: Immutable historical display receipt. Pending values are finalized once; never current price, balance, settlement or lifecycle authority. Optional during rollout. Entry is null for buys; USDC sells finalize immediately with available Entry or missing_purchase_history. - object - … - object - … - object - … - object - `address` string, required - `createdAt` string, date-time, required - `humanUsdAmountIn` number, required - `humanUsdAmountOut` number, required - `id` string, required - `inAmount` number, required: Legacy numeric atomic amount. May be rounded above JavaScript's safe integer limit; use inAmountAtomic. - `inAmountAtomic` string: Exact input amount in atomic units when the provider value and token decimals permit an unambiguous conversion. - `inHumanAmount` number, required - `inNetworkId` integer, required - `inTokenAddress` string, required - `inTokenImageUrl` string, nullable, required - `inTokenName` string, nullable, required - `inTokenSymbol` string, nullable, required - `inTradeId` unknown, required - `isCrossmint` false, required - `isOffPlatform` true, required - `networkId` integer, required - `outAmount` number, required: Legacy numeric atomic amount. May be rounded above JavaScript's safe integer limit; use outAmountAtomic. - `outAmountAtomic` string: Exact output amount in atomic units when the provider value and token decimals permit an unambiguous conversion. - `outHumanAmount` number, required - `outNetworkId` integer, required - `outTokenAddress` string, required - `outTokenImageUrl` string, nullable, required - `outTokenName` string, nullable, required - `outTokenSymbol` string, nullable, required - `outTradeId` unknown, required - `platformFeeAmount` unknown, required - `platformFeeHumanAmount` unknown, required - `platformFeeToken` unknown, required - `provider` string, required - `recipient` unknown, required - `referralFeeAddress` unknown, required - `referralFeeHumanAmount` unknown, required - `referralFeeToken` unknown, required - `referralFeeTokenAmount` unknown, required - `signature` string, required - `inExecutionPriceUsd` string, nullable, required: Historical USD consideration divided by the exact quantity of this token in this fill. Decimal string rounded half up to at most 18 fractional digits. Null when unavailable; never substituted with a current quote, portfolio average entry, or zero. Does not add network fees. - `inExecutionPriceUnavailableReason` 'missing_usd_value' | 'invalid_usd_value' | 'invalid_token_amount' | 'price_out_of_range' | 'historical_swap_unavailable' | 'historical_swap_not_found' | 'historical_swap_ambiguous' | 'historical_lookup_incomplete' | 'historical_lookup_limited' | 'unsupported_trade' | 'null', nullable, required: Null when the execution price is available; otherwise the reason it could not be determined. Treat unavailable values as unknown, without a current-price fallback. - `outExecutionPriceUsd` string, nullable, required: Historical USD consideration divided by the exact quantity of this token in this fill. Decimal string rounded half up to at most 18 fractional digits. Null when unavailable; never substituted with a current quote, portfolio average entry, or zero. Does not add network fees. - `outExecutionPriceUnavailableReason` 'missing_usd_value' | 'invalid_usd_value' | 'invalid_token_amount' | 'price_out_of_range' | 'historical_swap_unavailable' | 'historical_swap_not_found' | 'historical_swap_ambiguous' | 'historical_lookup_incomplete' | 'historical_lookup_limited' | 'unsupported_trade' | 'null', nullable, required: Null when the execution price is available; otherwise the reason it could not be determined. Treat unavailable values as unknown, without a current-price fallback. - `receipt` union: Immutable historical display receipt. Pending values are finalized once; never current price, balance, settlement or lifecycle authority. Optional during rollout. Entry is null for buys; USDC sells finalize immediately with available Entry or missing_purchase_history. - object - … - object - … - object - … - `traderProfileId` string, uuid, required ## Other responses - `400`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers. - `401`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers. - `404`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers. - `409`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers. - `429`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers. - `503`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers. --- [API](https://skmtc.dev/arbital/apis/arbital-api.md) - [All operations](https://skmtc.dev/arbital/apis/arbital-api/llms.txt) - [OpenAPI document](https://skmtc.dev/arbital/apis/arbital-api/revisions/bb0185edf43a?raw)