---
title: "Get Transactions"
method: GET
path: "/getTransactions"
---

# Get Transactions

`GET /getTransactions`

Retrieve paginated transaction history with optional filtering.

## Query parameters

- `appIds` string
- `walletAddress` string
- `chainIds` string
- `limit` integer
- `period` 'day' | 'week' | 'month'
- `startDate` string
- `endDate` string
- `cursor` string

## Response `200`

Transaction history response

- object
  - `txs` TxDetails[]
    - `status` 'success' | 'pending' | 'requires refund' | 'refunded' | 'failed' | 'not yet created' | 'expired' | 'submitted' | 'completed', required — Status of the transaction
    - `sender` string, required — Sender wallet address
    - `srcChainId` integer, required — Source chain ID
    - `dstChainId` integer, nullable — Destination chain ID
    - `srcTxHash` string, nullable — Source transaction hash
    - `dstTxHash` string, nullable — Destination transaction hash
    - `bridgeDetails` BridgeDetails, required
      - `isBridge` boolean, required — Whether this transaction involves bridging
      - `bridgeTime` number, nullable, required — Bridge time in seconds (null if not a bridge)
      - `txPath` TxNode[], required — Transaction path through different chains
        - `chainId` integer, required — Chain ID for this step
        - `txHash` string, nullable — Transaction hash for this step
        - `timestamp` integer, nullable
        - `nextBridge` string, nullable — Bridge type for the next hop
    - `txId` string, required — Unique transaction identifier
    - `actionRequest` ActionRequest
      - `actionType` 'swap-action' | 'evm-calldata-tx' | 'polymarket', required — Type of action to perform.
      - `sender` string, required — Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.
      - `srcChainId` integer, required — Chain ID. Find in the list of supported networks.
      - `srcToken` string, required — Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.
      - `dstChainId` integer, required — Chain ID. Find in the list of supported networks.
      - `dstToken` string, required — Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.
      - `slippage` number, float, required — Slippage tolerance in bps
      - `amount` string — The exact in or exact out amount of the swap
      - `swapDirection` 'exact-amount-in' | 'exact-amount-out' — Swap direction for the action.
      - `recipient` string — Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.
      - `to` string — Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.
      - `data` string — Hex string with 0x prefix
      - `value` string — Value to send with transaction
      - `erc20Amount` string — The amount of Erc20 being transferred
      - `erc20Spender` string — Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.
      - `bridgeIds` BridgeId[] — Specific bridge protocols to use
      - `refundTo` string — Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.
      - `appFees` AppFee[] — Application fees configuration
        - `bps` number, required — Fee in basis points
        - `receiverAddress` string, required — EVM address (0x prefix + 40 hex characters)
    - `actionResponse` ActionResponse
      - `tx` union, required — Transaction data for execution
        - EvmTransaction
          - `to` string, required — EVM address (0x prefix + 40 hex characters)
          - `data` string, required — Hex string with 0x prefix
          - `value` string, required — Value in wei as string
          - `chainId` integer — Chain ID. Find in the list of supported networks.
        - SerializedSolTransaction
          - `base64Tx` string, required — Base64-encoded transaction
          - `recentBlockhash` string, required — Recent blockhash for transaction validity
          - `payer` string, required — Solana public key (base58 encoded, 32-44 characters)
        - AltVmTransaction
          - `to` string, required — Exchange address format
          - `toExtra` string, nullable — Additional address information (e.g., memo, tag). Can be null.
          - `value` string, required — Value as string
          - `chainId` integer, required — Chain ID. Find in the list of supported networks.
          - `chainKey` string, required — Chain key identifier
        - HyperCoreTransaction
          - `type` 'usdSend', required — HyperCore action type
          - `destination` string, required — Destination address
          - `amount` string, required — Amount to transfer
          - `chainId` integer, required — Chain ID. Find in the list of supported networks.
        - TronTransaction
          - `to` string, required — Tron address (base58, starts with 'T', 34 chars)
          - `data` string, required — Hex-encoded calldata
          - `value` string, required — Value as string
      - `txId` string, required — Hex string with 0x prefix
      - `vmId` 'evm' | 'solana' | 'alt-vm' | 'hypercore' | 'tron', required — Virtual machine identifier.
      - `amountIn` Payment, required
        - `chainId` integer, required — Chain ID. Find in the list of supported networks.
        - `address` string, required — Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.
        - `name` string, required — Token name
        - `symbol` string, required — Token symbol
        - `decimals` integer, required — Token decimals
        - `isNative` boolean, required — Boolean flag for whether token is the chain's gas token.
        - `logo` string, nullable — URL to the token's logo image. Can be null if logo is not available.
        - `swapsXyzCode` string — Internal Swaps.xyz token identifier code.
        - `amount` string, required
        - `usdAmount` number, float, nullable — USD value of the payment amount
      - `amountInMax` Payment, required
        - `chainId` integer, required — Chain ID. Find in the list of supported networks.
        - `address` string, required — Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.
        - `name` string, required — Token name
        - `symbol` string, required — Token symbol
        - `decimals` integer, required — Token decimals
        - `isNative` boolean, required — Boolean flag for whether token is the chain's gas token.
        - `logo` string, nullable — URL to the token's logo image. Can be null if logo is not available.
        - `swapsXyzCode` string — Internal Swaps.xyz token identifier code.
        - `amount` string, required
        - `usdAmount` number, float, nullable — USD value of the payment amount
      - `amountOut` Payment, required
        - `chainId` integer, required — Chain ID. Find in the list of supported networks.
        - `address` string, required — Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.
        - `name` string, required — Token name
        - `symbol` string, required — Token symbol
        - `decimals` integer, required — Token decimals
        - `isNative` boolean, required — Boolean flag for whether token is the chain's gas token.
        - `logo` string, nullable — URL to the token's logo image. Can be null if logo is not available.
        - `swapsXyzCode` string — Internal Swaps.xyz token identifier code.
        - `amount` string, required
        - `usdAmount` number, float, nullable — USD value of the payment amount
      - `amountOutMin` Payment, required
        - `chainId` integer, required — Chain ID. Find in the list of supported networks.
        - `address` string, required — Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.
        - `name` string, required — Token name
        - `symbol` string, required — Token symbol
        - `decimals` integer, required — Token decimals
        - `isNative` boolean, required — Boolean flag for whether token is the chain's gas token.
        - `logo` string, nullable — URL to the token's logo image. Can be null if logo is not available.
        - `swapsXyzCode` string — Internal Swaps.xyz token identifier code.
        - `amount` string, required
        - `usdAmount` number, float, nullable — USD value of the payment amount
      - `protocolFee` Payment, required
        - `chainId` integer, required — Chain ID. Find in the list of supported networks.
        - `address` string, required — Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.
        - `name` string, required — Token name
        - `symbol` string, required — Token symbol
        - `decimals` integer, required — Token decimals
        - `isNative` boolean, required — Boolean flag for whether token is the chain's gas token.
        - `logo` string, nullable — URL to the token's logo image. Can be null if logo is not available.
        - `swapsXyzCode` string — Internal Swaps.xyz token identifier code.
        - `amount` string, required
        - `usdAmount` number, float, nullable — USD value of the payment amount
      - `applicationFee` Payment, required
        - `chainId` integer, required — Chain ID. Find in the list of supported networks.
        - `address` string, required — Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.
        - `name` string, required — Token name
        - `symbol` string, required — Token symbol
        - `decimals` integer, required — Token decimals
        - `isNative` boolean, required — Boolean flag for whether token is the chain's gas token.
        - `logo` string, nullable — URL to the token's logo image. Can be null if logo is not available.
        - `swapsXyzCode` string — Internal Swaps.xyz token identifier code.
        - `amount` string, required
        - `usdAmount` number, float, nullable — USD value of the payment amount
      - `bridgeFee` Payment
        - `chainId` integer, required — Chain ID. Find in the list of supported networks.
        - `address` string, required — Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.
        - `name` string, required — Token name
        - `symbol` string, required — Token symbol
        - `decimals` integer, required — Token decimals
        - `isNative` boolean, required — Boolean flag for whether token is the chain's gas token.
        - `logo` string, nullable — URL to the token's logo image. Can be null if logo is not available.
        - `swapsXyzCode` string — Internal Swaps.xyz token identifier code.
        - `amount` string, required
        - `usdAmount` number, float, nullable — USD value of the payment amount
      - `bridgeIds` BridgeId[] — Bridge IDs used in the route.
      - `bridgeRoute` BridgeStep[] — Array of bridge steps
        - `srcChainId` integer, required — Chain ID. Find in the list of supported networks.
        - `dstChainId` integer, required — Chain ID. Find in the list of supported networks.
        - `srcBridgeToken` string, required — Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.
        - `dstBridgeToken` string, required — Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.
        - `bridgeId` string, required — Bridge protocol identifier (e.g. "across", "relay", "mayan").
      - `exchangeRate` number, float, required — Exchange rate for the swap.
      - `estimatedTxTime` number, float, required — Estimated transaction time in seconds.
      - `estimatedPriceImpact` number, float, nullable, required — Estimated price impact percentage.
      - `requiresTokenApproval` boolean, required — Flag indicating whether the transaction object requires a source token approval check.
      - `requiresRegisterTransaction` boolean, required — Flag indicating whether the transaction requires registration via the registerTxs endpoint. Mandatory for non-EVM transactions.
      - `allRoutes` BaseActionResponse[], required — All available routes for the action.
        - `tx` union, required — Transaction data for execution
          - EvmTransaction
            - `to` string, required — EVM address (0x prefix + 40 hex characters)
            - `data` string, required — Hex string with 0x prefix
            - `value` string, required — Value in wei as string
            - `chainId` integer — Chain ID. Find in the list of supported networks.
          - SerializedSolTransaction
            - `base64Tx` string, required — Base64-encoded transaction
            - `recentBlockhash` string, required — Recent blockhash for transaction validity
            - `payer` string, required — Solana public key (base58 encoded, 32-44 characters)
          - AltVmTransaction
            - `to` string, required — Exchange address format
            - `toExtra` string, nullable — Additional address information (e.g., memo, tag). Can be null.
            - `value` string, required — Value as string
            - `chainId` integer, required — Chain ID. Find in the list of supported networks.
            - `chainKey` string, required — Chain key identifier
          - HyperCoreTransaction
            - `type` 'usdSend', required — HyperCore action type
            - `destination` string, required — Destination address
            - `amount` string, required — Amount to transfer
            - `chainId` integer, required — Chain ID. Find in the list of supported networks.
          - TronTransaction
            - `to` string, required — Tron address (base58, starts with 'T', 34 chars)
            - `data` string, required — Hex-encoded calldata
            - `value` string, required — Value as string
        - `txId` string, required — Hex string with 0x prefix
        - `vmId` 'evm' | 'solana' | 'alt-vm' | 'hypercore' | 'tron', required — Virtual machine identifier.
        - `amountIn` Payment, required
          - `chainId` integer, required — Chain ID. Find in the list of supported networks.
          - `address` string, required — Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.
          - `name` string, required — Token name
          - `symbol` string, required — Token symbol
          - `decimals` integer, required — Token decimals
          - `isNative` boolean, required — Boolean flag for whether token is the chain's gas token.
          - `logo` string, nullable — URL to the token's logo image. Can be null if logo is not available.
          - `swapsXyzCode` string — Internal Swaps.xyz token identifier code.
          - `amount` string, required
          - `usdAmount` number, float, nullable — USD value of the payment amount
        - `amountInMax` Payment, required
          - `chainId` integer, required — Chain ID. Find in the list of supported networks.
          - `address` string, required — Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.
          - `name` string, required — Token name
          - `symbol` string, required — Token symbol
          - `decimals` integer, required — Token decimals
          - `isNative` boolean, required — Boolean flag for whether token is the chain's gas token.
          - `logo` string, nullable — URL to the token's logo image. Can be null if logo is not available.
          - `swapsXyzCode` string — Internal Swaps.xyz token identifier code.
          - `amount` string, required
          - `usdAmount` number, float, nullable — USD value of the payment amount
        - `amountOut` Payment, required
          - `chainId` integer, required — Chain ID. Find in the list of supported networks.
          - `address` string, required — Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.
          - `name` string, required — Token name
          - `symbol` string, required — Token symbol
          - `decimals` integer, required — Token decimals
          - `isNative` boolean, required — Boolean flag for whether token is the chain's gas token.
          - `logo` string, nullable — URL to the token's logo image. Can be null if logo is not available.
          - `swapsXyzCode` string — Internal Swaps.xyz token identifier code.
          - `amount` string, required
          - `usdAmount` number, float, nullable — USD value of the payment amount
        - `amountOutMin` Payment, required
          - `chainId` integer, required — Chain ID. Find in the list of supported networks.
          - `address` string, required — Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.
          - `name` string, required — Token name
          - `symbol` string, required — Token symbol
          - `decimals` integer, required — Token decimals
          - `isNative` boolean, required — Boolean flag for whether token is the chain's gas token.
          - `logo` string, nullable — URL to the token's logo image. Can be null if logo is not available.
          - `swapsXyzCode` string — Internal Swaps.xyz token identifier code.
          - `amount` string, required
          - `usdAmount` number, float, nullable — USD value of the payment amount
        - `protocolFee` Payment, required
          - `chainId` integer, required — Chain ID. Find in the list of supported networks.
          - `address` string, required — Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.
          - `name` string, required — Token name
          - `symbol` string, required — Token symbol
          - `decimals` integer, required — Token decimals
          - `isNative` boolean, required — Boolean flag for whether token is the chain's gas token.
          - `logo` string, nullable — URL to the token's logo image. Can be null if logo is not available.
          - `swapsXyzCode` string — Internal Swaps.xyz token identifier code.
          - `amount` string, required
          - `usdAmount` number, float, nullable — USD value of the payment amount
        - `applicationFee` Payment, required
          - `chainId` integer, required — Chain ID. Find in the list of supported networks.
          - `address` string, required — Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.
          - `name` string, required — Token name
          - `symbol` string, required — Token symbol
          - `decimals` integer, required — Token decimals
          - `isNative` boolean, required — Boolean flag for whether token is the chain's gas token.
          - `logo` string, nullable — URL to the token's logo image. Can be null if logo is not available.
          - `swapsXyzCode` string — Internal Swaps.xyz token identifier code.
          - `amount` string, required
          - `usdAmount` number, float, nullable — USD value of the payment amount
        - `bridgeFee` Payment
          - `chainId` integer, required — Chain ID. Find in the list of supported networks.
          - `address` string, required — Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.
          - `name` string, required — Token name
          - `symbol` string, required — Token symbol
          - `decimals` integer, required — Token decimals
          - `isNative` boolean, required — Boolean flag for whether token is the chain's gas token.
          - `logo` string, nullable — URL to the token's logo image. Can be null if logo is not available.
          - `swapsXyzCode` string — Internal Swaps.xyz token identifier code.
          - `amount` string, required
          - `usdAmount` number, float, nullable — USD value of the payment amount
        - `bridgeIds` BridgeId[] — Bridge IDs used in the route.
        - `bridgeRoute` BridgeStep[] — Array of bridge steps
          - `srcChainId` integer, required — Chain ID. Find in the list of supported networks.
          - `dstChainId` integer, required — Chain ID. Find in the list of supported networks.
          - `srcBridgeToken` string, required — Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.
          - `dstBridgeToken` string, required — Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.
          - `bridgeId` string, required — Bridge protocol identifier (e.g. "across", "relay", "mayan").
        - `exchangeRate` number, float, required — Exchange rate for the swap.
        - `estimatedTxTime` number, float, required — Estimated transaction time in seconds.
        - `estimatedPriceImpact` number, float, nullable, required — Estimated price impact percentage.
        - `requiresRegisterTransaction` boolean, required — Flag indicating whether the transaction requires registration via the registerTxs endpoint. Mandatory for non-EVM transactions.
        - `executionsType` 'DEFAULT' | 'GASLESS' — Indicates the execution mode. `GASLESS` when `gasless=true` was requested and a relay provider is available; `DEFAULT` otherwise.
        - `executions` Execution[] — Ordered list of signing steps the client must complete before calling `POST /submitTx`. Only present when `executionsType` is `GASLESS`.
          - union — A single signing step returned in the `executions` array of a gasless `getAction` response. Only available for Tron same-chain swaps. The client must sign each item in order and include the signatures when calling `POST /submitTx`.
            - EvmTransactionSignExecution
              - …
            - EvmSignTypedDataExecution
              - …
        - `relayerFee` Payment
          - `chainId` integer, required — Chain ID. Find in the list of supported networks.
          - `address` string, required — Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.
          - `name` string, required — Token name
          - `symbol` string, required — Token symbol
          - `decimals` integer, required — Token decimals
          - `isNative` boolean, required — Boolean flag for whether token is the chain's gas token.
          - `logo` string, nullable — URL to the token's logo image. Can be null if logo is not available.
          - `swapsXyzCode` string — Internal Swaps.xyz token identifier code.
          - `amount` string, required
          - `usdAmount` number, float, nullable — USD value of the payment amount
      - `executionsType` 'DEFAULT' | 'GASLESS' — Indicates the execution mode. `GASLESS` when `gasless=true` was requested and a relay provider is available; `DEFAULT` otherwise.
      - `executions` Execution[] — Ordered list of signing steps the client must complete before calling `POST /submitTx`. Only present when `executionsType` is `GASLESS`.
        - union — A single signing step returned in the `executions` array of a gasless `getAction` response. Only available for Tron same-chain swaps. The client must sign each item in order and include the signatures when calling `POST /submitTx`.
          - EvmTransactionSignExecution
            - `txType` 'evmTransactionSign', required
            - `data` string, required — JSON string of an unsigned Tron transaction (TronWeb `raw_data` shape)
            - `signature` string — Hex-encoded signature from TronLink or compatible Tron wallet
          - EvmSignTypedDataExecution
            - `txType` 'evmSignTypedData', required
            - `data` union, required — EIP-712 typed data to sign. Accepted as either a JSON string (same format returned by `GET /getAction`) or a parsed object — both are equivalent.
              - …
            - `signature` string — Hex-encoded EIP-712 signature
      - `relayerFee` Payment
        - `chainId` integer, required — Chain ID. Find in the list of supported networks.
        - `address` string, required — Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.
        - `name` string, required — Token name
        - `symbol` string, required — Token symbol
        - `decimals` integer, required — Token decimals
        - `isNative` boolean, required — Boolean flag for whether token is the chain's gas token.
        - `logo` string, nullable — URL to the token's logo image. Can be null if logo is not available.
        - `swapsXyzCode` string — Internal Swaps.xyz token identifier code.
        - `amount` string, required
        - `usdAmount` number, float, nullable — USD value of the payment amount
    - `usdRates` object, nullable — USD rates at the time of the transaction
      - `srcToken` number, nullable
      - `dstToken` number, nullable
      - `timestamp` integer, required — Unix timestamp of the rate snapshot
    - `workflow` WorkflowData
      - `name` string — Workflow name
      - `operation` string — Operation type
      - `status` string — Workflow status
      - `timestamp` integer — Unix timestamp when workflow was executed
      - `data` union — Workflow-specific data
        - PolyMarketWorkflowData
          - `userId` string, required — Polymarket user ID
          - `orderRequest` PolymarketOrderRequest, required
            - `side` 'BUY' | 'SELL', required — Order side
            - `tokenID` string, required — Polymarket CLOB token ID
            - `orderType` 'FOK' | 'FAK' | 'GTC' | 'GTD', required — Order type (FOK/FAK are market orders, GTC/GTD are limit orders)
            - `feeRateBps` number, required — Fee rate in basis points
            - `slippage` number, required — Slippage tolerance in basis points
            - `tickSize` '0.01' | '0.001' | '0.0001', required — Price tick size
            - `negRisk` boolean, required — Negative risk flag
            - `amount` number — Amount for market orders (FOK/FAK)
            - `price` number — Price per share (0-1) - required for limit orders, optional for market orders
            - `size` number — Number of shares for limit orders
          - `orderResponse` union, required — Order response from Polymarket
            - PolymarketOpenOrder
              - …
            - object
              - …
          - `relayTx` object, nullable — Relay transaction details (null if not applicable)
            - `txHash` string — Transaction hash of the relay transaction
            - `status` string — Status of the relay transaction
        - object
    - `org` Org
      - `appId` string, required — Application ID
      - `appName` string — Application name
      - `affiliateId` string, nullable — Affiliate ID
    - `usdValue` number, nullable — USD value of the transaction
    - `srcTx` OnchainTx
      - `toAddress` string, nullable — Recipient address
      - `txHash` string, required — Transaction hash
      - `chainId` integer, required — Chain ID
      - `value` string, nullable — Transaction value as string
      - `timestamp` union, required — Unix timestamp in seconds. Integer for recent records; string for records created before the bigint migration.
        - integer
        - string
      - `paymentToken` Token
        - `name` string, required — Token name
        - `symbol` string, required — Token symbol
        - `decimals` integer, required — Token decimals
        - `amount` string, required — Token amount as bigint string
        - `address` string, nullable — Token contract address
        - `chainId` integer, required — Chain ID for the token
        - `isNative` boolean — Whether the token is the native gas token
        - `usdAmount` number — USD value of the token amount
      - `revertReason` string, nullable — Revert reason if transaction failed, null otherwise
    - `dstTx` OnchainTx
      - `toAddress` string, nullable — Recipient address
      - `txHash` string, required — Transaction hash
      - `chainId` integer, required — Chain ID
      - `value` string, nullable — Transaction value as string
      - `timestamp` union, required — Unix timestamp in seconds. Integer for recent records; string for records created before the bigint migration.
        - integer
        - string
      - `paymentToken` Token
        - `name` string, required — Token name
        - `symbol` string, required — Token symbol
        - `decimals` integer, required — Token decimals
        - `amount` string, required — Token amount as bigint string
        - `address` string, nullable — Token contract address
        - `chainId` integer, required — Chain ID for the token
        - `isNative` boolean — Whether the token is the native gas token
        - `usdAmount` number — USD value of the token amount
      - `revertReason` string, nullable — Revert reason if transaction failed, null otherwise
  - `cursor` object
    - `next` string, nullable — Cursor for fetching the next page of results. Null if no more pages.

---

[API](https://skmtc.dev/swaps/apis/prediction-market-data-api.md) · [All operations](https://skmtc.dev/swaps/apis/prediction-market-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/swaps/prediction-market-data-api/revisions/03e917d60cb7/schema)