---
title: "GET /requests/v2"
method: GET
path: "/requests/v2"
---

# GET /requests/v2

`GET /requests/v2`

## Query parameters

- `limit` number
- `continuation` string
- `user` string
- `hash` string
- `originChainId` number
- `destinationChainId` number
- `privateChainsToInclude` string
- `id` string
- `orderId` string
- `includeOrderData` boolean
- `startTimestamp` number
- `endTimestamp` number
- `startBlock` number
- `endBlock` number
- `chainId` string
- `referrer` string
- `depositAddress` string
- `includeChildRequests` boolean
- `includeAuthenticatedData` boolean
- `status` 'success' | 'failure' | 'refund' | 'pending' | 'depositing'
- `apiKey` string
- `sortBy` 'createdAt' | 'updatedAt'
- `sortDirection` 'asc' | 'desc'

## Headers

- `x-api-key` string

## Response `200`

Default Response

- object
  - `requests` object[]
    - `id` string — The `requestId` — the Relay-level intent identifier used across the API for status polling, webhooks, and most other endpoints. Distinct from `protocol.orderId`, which is the protocol-level deposit identifier extractable from on-chain data.
    - `status` 'refund' | 'waiting' | 'depositing' | 'failure' | 'pending' | 'success' — Note that fallback is returned in the case of a refund
    - `user` string — The address that initiated the request.
    - `recipient` string — The address that receives the destination output.
    - `depositAddress` object, nullable
      - `address` string
      - `depositAddressType` 'strict' | 'open'
      - `depositor` string, nullable
      - `depositTxHash` string, nullable
    - `data` object
      - `slippageTolerance` string — Slippage tolerance for the swap. This value is in basis points (1/100th of a percent), e.g. 50 for 0.5% slippage
      - `failReason` 'UNKNOWN' | 'SLIPPAGE' | 'AMOUNT_TOO_LOW_TO_REFUND' | 'DEPOSIT_ADDRESS_MISMATCH' | 'DEPOSIT_CHAIN_MISMATCH' | 'INCORRECT_DEPOSIT_CURRENCY' | 'DOUBLE_SPEND' | 'SOLVER_CAPACITY_EXCEEDED' | 'SOLVER_BALANCE_TOO_LOW' | 'DEPOSITED_AMOUNT_TOO_LOW_TO_FILL' | 'NEGATIVE_NEW_AMOUNT_AFTER_FEES' | 'NO_QUOTES' | 'MISSING_REVERT_DATA' | 'REVERSE_SWAP_FAILED' | 'GENERATE_SWAP_FAILED' | 'TOO_LITTLE_RECEIVED' | 'EXECUTION_REVERTED' | 'NEW_CALLDATA_INCLUDES_HIGHER_RENT_FEE' | 'TRANSACTION_REVERTED' | 'TRANSACTION_TOO_LARGE' | 'ORIGIN_CURRENCY_MISMATCH' | 'NO_INTERNAL_SWAP_ROUTES_FOUND' | 'SWAP_USES_TOO_MUCH_GAS' | 'INSUFFICIENT_FUNDS_FOR_RENT' | 'SPONSOR_BALANCE_TOO_LOW' | 'ORDER_EXPIRED' | 'ORDER_IS_CANCELLED' | 'TRANSFER_FROM_FAILED' | 'TRANSFER_FAILED' | 'SIGNATURE_EXPIRED' | 'INVALID_SIGNATURE' | 'INSUFFICIENT_NATIVE_TOKENS_SUPPLIED' | 'TRANSFER_AMOUNT_EXCEEDS_ALLOWANCE' | 'TRANSFER_AMOUNT_EXCEEDS_BALANCE' | 'INVALID_SENDER' | 'ACCOUNT_ABSTRACTION_INVALID_NONCE' | 'ACCOUNT_ABSTRACTION_SIGNATURE_ERROR' | 'SEAPORT_INEXACT_FRACTION' | 'TOKEN_NOT_TRANSFERABLE' | 'ZERO_SELL_AMOUNT' | 'MINT_NOT_ACTIVE' | 'ERC_1155_TOO_MANY_REQUESTED' | 'INCORRECT_PAYMENT' | 'INVALID_GAS_PRICE' | 'FLUID_DEX_ERROR' | 'ORDER_ALREADY_FILLED' | 'SEAPORT_INVALID_FULFILLER' | 'INVALID_SIGNER' | 'MINT_QUANTITY_EXCEEDS_MAX_PER_WALLET' | 'MINT_QUANTITY_EXCEEDS_MAX_SUPPLY' | 'JUPITER_INVALID_TOKEN_ACCOUNT' | 'INVALID_NONCE' | 'ACCOUNT_ABSTRACTION_GAS_LIMIT' | 'CONTRACT_PAUSED' | 'SWAP_IMPACT_TOO_HIGH' | 'INSUFFICIENT_POOL_LIQUIDITY' | 'TTL_EXPIRED' | 'DEPOSIT_CONFIRMATION_TIMEOUT' | 'ORPHANED_DEPOSIT_REFUND' | 'GASLESS_PERMIT_BALANCE_TOO_LOW' | 'MANUAL_ADMIN_REFUND' | 'QUOTED_GAS_LIMIT_EXCEEDED' | 'DESTINATION_TOKEN_TRANSFER_REJECTED' | 'DEPOSIT_REORGED' | 'BLOCKED_WALLET' | 'PROTOCOL_DEADLINE_EXPIRED' | 'TRANSACTION_NOT_INCLUDED' | 'TRANSACTION_SUBMISSION_FAILED' | 'N/A'
      - `refundFailReason` 'AMOUNT_TOO_LOW_TO_REFUND' | 'NEGATIVE_NEW_AMOUNT_AFTER_FEES' | 'SWAP_CURRENCY_NOT_ON_ORIGIN' | 'REFUND_RECIPIENT_IS_VASP' | 'MANUAL_REFUND_REQUIRED'
      - `supersededByRequestId` string, nullable — Regenerated requestId that now owns the sweep/fill for a superseded deposit-address request.
      - `failedTxHash` string
      - `failedTxBlockNumber` number
      - `failedCallData` object
        - `from` string
        - `to` string
        - `data` string
        - `value` string
      - `subsidizedRequest` boolean
      - `fees` object
        - `gas` string — Estimated gas cost required for execution, in wei
        - `fixed` string — The fixed fee which is always added to execution, in wei
        - `price` string — The dynamic fee which is a result of the chain and the amount, in wei
        - `gateway` string — The fee taken by the API gateway, in wei
      - `feesUsd` object
        - `gas` string
        - `fixed` string
        - `price` string
        - `gateway` string
      - `inTxs` object[]
        - `fee` string — Total fees in wei
        - `data` unknown
        - `stateChanges` unknown
        - `hash` string
        - `block` number
        - `type` string — The type of transaction, always set to onchain
        - `chainId` number
        - `timestamp` number
        - `status` 'success' | 'failure'
      - `currency` string
      - `currencyObject` object
        - `chainId` number
        - `address` string
        - `symbol` string
        - `name` string
        - `decimals` number
        - `metadata` object
          - `logoURI` string
          - `verified` boolean
          - `isNative` boolean
      - `feeCurrency` string
      - `feeCurrencyObject` object
        - `chainId` number
        - `address` string
        - `symbol` string
        - `name` string
        - `decimals` number
        - `metadata` object
          - `logoURI` string
          - `verified` boolean
          - `isNative` boolean
      - `appFeeCurrencyObject` object
        - `chainId` number
        - `address` string
        - `symbol` string
        - `name` string
        - `decimals` number
        - `metadata` object
          - `logoURI` string
          - `verified` boolean
          - `isNative` boolean
      - `refundCurrencyData` object
        - `currency` object
          - `chainId` number
          - `address` string
          - `symbol` string
          - `name` string
          - `decimals` number
          - `metadata` object
            - `logoURI` string
            - `verified` boolean
            - `isNative` boolean
        - `amount` string
        - `amountFormatted` string
        - `amountUsd` string
        - `minimumAmount` string
      - `appFees` object[]
        - `recipient` string
        - `bps` string
        - `amount` string
        - `amountUsd` string
        - `amountUsdCurrent` string
      - `subsidizedFee` object
        - `origin` object
          - `amount` string
          - `address` string
          - `chainId` number
        - `sponsor` object
          - `amount` string
          - `address` string
          - `chainId` number
        - `amountUsd` string
        - `amountUsdCurrent` string
      - `feeSponsorship` object — Granular fee sponsorship details derived from the solver's internal sponsorship resolution.
        - `quoted` object — The quote-time sponsorship expectation for the request.
          - `selectedComponents` string[], required — The normalized sponsorship buckets selected for this request.
          - `maxSubsidizationAmount` string — The requested sponsorship cap in USD micro-units, when one was configured for the request.
          - `capHit` boolean, required — Whether the configured sponsorship cap limited the selected fee buckets for this phase.
          - `components` object, required — Per-bucket sponsorship details for the sponsorable fee components.
            - `execution` object, required — Execution fee sponsorship details.
              - …
            - `swap` object, required — Swap fee sponsorship details.
              - …
            - `relay` object, required — Relay protocol fee sponsorship details.
              - …
            - `app` object, required — App fee sponsorship details.
              - …
            - `rent` object, required — Solana ATA rent sponsorship details.
              - …
          - `sponsoredTotal` object, required — The total amount sponsored for this phase.
            - `currency` object
              - …
            - `amount` string
            - `amountFormatted` string
            - `amountUsd` string
            - `minimumAmount` string
          - `userPaysTotal` object, required — The total amount the user paid across the sponsorable fee buckets for this phase.
            - `currency` object
              - …
            - `amount` string
            - `amountFormatted` string
            - `amountUsd` string
            - `minimumAmount` string
        - `actual` object — The post-solve sponsorship outcome recorded for the request.
          - `selectedComponents` string[], required — The normalized sponsorship buckets selected for this request.
          - `maxSubsidizationAmount` string — The requested sponsorship cap in USD micro-units, when one was configured for the request.
          - `capHit` boolean, required — Whether the configured sponsorship cap limited the selected fee buckets for this phase.
          - `components` object, required — Per-bucket sponsorship details for the sponsorable fee components.
            - `execution` object, required — Execution fee sponsorship details.
              - …
            - `swap` object, required — Swap fee sponsorship details.
              - …
            - `relay` object, required — Relay protocol fee sponsorship details.
              - …
            - `app` object, required — App fee sponsorship details.
              - …
            - `rent` object, required — Solana ATA rent sponsorship details.
              - …
          - `sponsoredTotal` object, required — The total amount sponsored for this phase.
            - `currency` object
              - …
            - `amount` string
            - `amountFormatted` string
            - `amountUsd` string
            - `minimumAmount` string
          - `userPaysTotal` object, required — The total amount the user paid across the sponsorable fee buckets for this phase.
            - `currency` object
              - …
            - `amount` string
            - `amountFormatted` string
            - `amountUsd` string
            - `minimumAmount` string
          - `sponsorPayment` object — How much the sponsor ultimately paid, denominated in the sponsor payment currency.
            - `amount` string, required — The sponsor payment amount.
            - `address` string, required — The sponsor payment currency address.
            - `chainId` number, required — The sponsor payment chain id.
      - `expandedPriceImpact` object, nullable — Breakdown of price impact by component, with quoted and actual values
        - `quoted` object — Price impact as estimated at quote time
          - `swap` object — Cost to execute swap or bridge depending on available liquidity. This value can be negative (representing network rewards for improving liquidity distribution)
            - `usd` string
          - `execution` object — Fees paid to cover transaction execution costs
            - `usd` string
          - `relay` object — Fees paid to the protocol
            - `usd` string
          - `app` object — Fees paid to the app. Currency will be the same as the relayer fee currency. This needs to be claimed later by the app owner and is not immediately distributed to the app
            - `usd` string
          - `sponsored` object — Fees paid by a sponsor for this request
            - `usd` string
        - `actual` object — Price impact as computed at fill time
          - `swap` object — Cost to execute swap or bridge depending on available liquidity. This value can be negative (representing network rewards for improving liquidity distribution)
            - `usd` string
          - `execution` object — Fees paid to cover transaction execution costs
            - `usd` string
          - `relay` object — Fees paid to the protocol
            - `usd` string
          - `app` object — Fees paid to the app. Currency will be the same as the relayer fee currency. This needs to be claimed later by the app owner and is not immediately distributed to the app
            - `usd` string
          - `sponsored` object — Fees paid by a sponsor for this request
            - `usd` string
      - `paidAppFees` object[]
        - `recipient` string
        - `bps` string
        - `amount` string
        - `amountUsd` string
        - `amountUsdCurrent` string
      - `platformFee` object, nullable
        - `bucket` string
        - `ruleId` string
        - `relayFeeBps` number
        - `integratorFeeBps` number
        - `totalFeeBps` number
        - `relayFee` object
          - `currency` object
            - `chainId` number
            - `address` string
            - `symbol` string
            - `name` string
            - `decimals` number
            - `metadata` object
              - …
          - `amount` string
          - `amountFormatted` string
          - `amountUsd` string
          - `minimumAmount` string
        - `integratorFee` object
          - `currency` object
            - `chainId` number
            - `address` string
            - `symbol` string
            - `name` string
            - `decimals` number
            - `metadata` object
              - …
          - `amount` string
          - `amountFormatted` string
          - `amountUsd` string
          - `minimumAmount` string
        - `totalPlatformFee` object
          - `currency` object
            - `chainId` number
            - `address` string
            - `symbol` string
            - `name` string
            - `decimals` number
            - `metadata` object
              - …
          - `amount` string
          - `amountFormatted` string
          - `amountUsd` string
          - `minimumAmount` string
        - `integratorFeeRecipient` string, nullable
      - `metadata` object
        - `sender` string
        - `recipient` string
        - `currencyIn` object
          - `currency` object
            - `chainId` number
            - `address` string
            - `symbol` string
            - `name` string
            - `decimals` number
            - `metadata` object
              - …
          - `amount` string
          - `amountFormatted` string
          - `amountUsd` string
          - `amountUsdCurrent` string
          - `minimumAmount` string
        - `currencyOut` object
          - `currency` object
            - `chainId` number
            - `address` string
            - `symbol` string
            - `name` string
            - `decimals` number
            - `metadata` object
              - …
          - `amount` string
          - `amountFormatted` string
          - `amountUsd` string
          - `amountUsdCurrent` string
          - `minimumAmount` string
        - `currencyGasTopup` object
          - `currency` object
            - `chainId` number
            - `address` string
            - `symbol` string
            - `name` string
            - `decimals` number
            - `metadata` object
              - …
          - `amount` string
          - `amountFormatted` string
          - `amountUsd` string
          - `minimumAmount` string
        - `rate` string
        - `quoteOraclePrice` object
          - `rate` string
          - `inputAmount` string
          - `outputAmount` string
          - `observedAt` string
          - `from` object
            - `chainId` number
            - `address` string
            - `currencyId` string
            - `decimals` number
          - `to` object
            - `chainId` number
            - `address` string
            - `currencyId` string
            - `decimals` number
        - `route` object
          - `origin` object — The route taken for the origin chain swap
            - `inputCurrency` object
              - …
            - `outputCurrency` object
              - …
            - `router` string
            - `includedSwapSources` string[]
          - `destination` object — The route taken for the origin chain swap
            - `inputCurrency` object
              - …
            - `outputCurrency` object
              - …
            - `router` string
            - `includedSwapSources` string[]
      - `price` string
      - `usesExternalLiquidity` boolean
      - `timeEstimate` number
      - `triggeredByFastFill` boolean
      - `outTxs` object[]
        - `fee` string — Total fees in wei
        - `data` unknown
        - `stateChanges` unknown
        - `hash` string
        - `block` number
        - `type` string — The type of transaction, always set to onchain
        - `chainId` number
        - `timestamp` number
        - `status` 'success' | 'failure'
    - `protocol` object
      - `orderId` string — The protocol-level deposit identifier passed as `bytes32 id` to the Relay Depository when funds are deposited, and emitted in the deposit event. Use this to correlate on-chain deposit data to a Relay request. Distinct from the `requestId`, which is the Relay-level intent identifier used across the API.
      - `hubType` 'onchain'
      - `isWithdrawable` boolean — True if the deposit is recoverable via the protocol withdrawal flow.
      - `solver` object
        - `address` string
        - `protocolChainId` string
        - `chainId` number
      - `deposit` object
        - `origin` object
          - `amount` string
          - `chainId` number
          - `currency` string
          - `depositor` string
          - `depository` string
          - `onchainId` string
          - `transactionId` string
        - `relay` object
          - `amount` string
          - `chainId` number
          - `currency` string
          - `hash` string
          - `operation` 'mint'
          - `tokenMetadata` object
            - `decimals` number
            - `name` string
            - `symbol` string
        - `attestation` object
          - `execution` object
            - `actions` string[]
            - `idempotencyKey` string
          - `attestations` object[]
            - `oracleChainId` string
            - `oracleContract` string
            - `signerAddress` string
            - `signature` string
      - `settlement` object
        - `destination` object
          - `fills` object[]
            - `chainId` number
            - `transactionId` string
          - `refunds` object[]
            - `chainId` number
            - `transactionId` string
        - `relay` object
          - `amount` string
          - `chainId` number
          - `currency` string
          - `hash` string
          - `operation` 'transfer' | 'burn' | 'mixed'
          - `solver` string
          - `tokenMetadata` object
            - `decimals` number
            - `name` string
            - `symbol` string
        - `attestation` object
          - `execution` object
            - `actions` string[]
            - `idempotencyKey` string
          - `attestations` object[]
            - `oracleChainId` string
            - `oracleContract` string
            - `signerAddress` string
            - `signature` string
    - `orderData` unknown
    - `referrer` string
    - `moonpayId` string
    - `createdAt` string
    - `updatedAt` string
  - `continuation` string
  - `deprecation` object
    - `message` string, required
    - `deprecatedAt` string, required
    - `throttledFrom` string, required
    - `sunsetAt` string, required
    - `successor` string, required
    - `migrationGuide` string, required

---

[API](https://skmtc.net/relay/apis/cross-chain-solver.md) · [All operations](https://skmtc.net/relay/apis/cross-chain-solver/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/relay/cross-chain-solver/versions/428d669c2830/schema)