Swaps

View swaps.

Lists the swaps made through your broker. Without filters it returns the last 50 completed swaps, newest first; filter by status and platform, and page with offset, limit (maximum 500) and sort.

get/swaps

Request

  • Base URL: https://chainflip-broker.io
  • URL: https://chainflip-broker.io/swaps
  • Auth: one of:
    • API key in query parameter apiKey
    • API key in header X-API-Key

Query parameters

apiKeystring

Your partner API key. A key is required through this parameter OR the X-API-Key header; when both are present, this query parameter wins, even when it is empty, which fails validation rather than falling back to the header.

offsetinteger

Swap id to return results from, depends on sort.

limitinteger

Number of results to return, default 50, maximum 500.

statusstring[]

Only return swaps which match these statuses. Defaults to completed only.

sort'ascending' | 'descending'

Sort order, default descending.

platformstring

Optional provider to filter swaps by. Defaults to all platforms.

Response

The swaps.

idinteger

The BaaS swap id, returned as id when the swap was started. Use it with getStatusById. Not the Chainflip swap id, which is status.swapId.

platformstring

The provider that executes the swap.

Example response

[
  {
    "id": 73410,
    "platform": "chainflip",
    "status": {
      "state": "completed",
      "swapId": "1919579",
      "sourceAsset": "dot.hub",
      "destinationAsset": "sol.sol",
      "destinationAddress": "A21o4asMbFHYadqXdLusT9Bvx9xaC5YV9gcaidjqtdXC",
      "depositChannel": {
        "id": "15253762-Assethub-49",
        "createdAt": 1792036410001,
        "createdAtDate": "2026-10-15T03:53:30.001+00:00",
        "brokerCommissionBps": 5,
        "depositAddress": "14CPPi1QvzDQxC5mX29uj1Q55kUGX7P3SenYkkzjQqSir8Pq",
        "sourceChainExpiryBlock": "21887126",
        "estimatedExpiryTime": 1792166010001,
        "estimatedExpiryDate": "2026-10-16T15:53:30.001+00:00",
        "expectedDepositAmount": 10,
        "expectedDepositAmountNative": "100000000000",
        "affiliateBrokers": [
          {
            "account": "cFJZVRaybb2PBwxTiAiRLiQfHY4KPB3RpJK22Q7Fhqk979aCH",
            "commissionBps": 5
          }
        ],
        "fillOrKillParams": {
          "retryDurationBlocks": 150,
          "refundAddress": "14k6xN8BTcg4bcDCjMRCETrD7NLUfXJGKgEpKFnYVmBemCK8",
          "minimumPrice": "0.0102685756257095261",
          "maximumOraclePriceSlippage": 50
        },
        "dcaParams": {
          "numberOfChunks": 10,
          "chunkIntervalBlocks": 2
        }
      },
      "fillOrKillParams": {
        "retryDurationBlocks": 150,
        "refundAddress": "14k6xN8BTcg4bcDCjMRCETrD7NLUfXJGKgEpKFnYVmBemCK8",
        "minimumPrice": "0.0102685756257095261",
        "maximumOraclePriceSlippage": 50
      },
      "brokers": [
        {
          "account": "cFJZVRaybb2PBwxTiAiRLiQfHY4KPB3RpJK22Q7Fhqk979aCH",
          "commissionBps": 5
        }
      ],
      "dcaParams": {
        "numberOfChunks": 10,
        "chunkIntervalBlocks": 2
      },
      "fallbackEgress": {
        "amountNative": "102923756",
        "amount": 0.102923756,
        "scheduledAt": 1792036488000,
        "scheduledAtDate": "2026-10-15T03:54:48+00:00",
        "scheduledBlockIndex": "15253775-1683",
        "transactionReference": "2UyZGnAhXvG3WUmiSCfAw19rRuccgydJpPR9nVwV5fBNsJ5AH1LwzkYLGABsiyt2EtTqxhjo2L11nKXTUWK2Lpnj",
        "witnessedAt": 1792036626001,
        "witnessedBlockIndex": "15253798-1668",
        "failure": {
          "failedAt": 1790985636000,
          "failedAtDate": "2026-10-03T00:00:36+00:00",
          "failedBlockIndex": "15079633-1298",
          "mode": "DEPOSIT_REJECTED",
          "reason": {
            "code": "TransactionRejectedByBroker",
            "message": "The deposit was rejected by the broker"
          }
        },
        "failedAt": 1741265580000,
        "failedAtDate": "2025-03-06T12:53:00+00:00",
        "failedBlockIndex": "6864282-895",
        "destinationAddress": "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin",
        "transactionPayload": {
          "contract": "0x79001a5e762f3befc8e5871b42f6734e00498920",
          "value": "0",
          "chainId": "42161",
          "data": "0x5293178e1f2a11943836956f8ae0da6e"
        }
      },
      "ccmParams": {
        "gasBudget": "1000000",
        "message": "0xdeadbeef"
      },
      "boost": {
        "maximumBoostFeeBps": 5,
        "effectiveBoostFeeBps": 5,
        "boostedAt": 1790087700000,
        "boostedAtDate": "2026-09-22T14:35:00+00:00",
        "boostedBlockIndex": "14930157-12",
        "skippedAt": 1790087694000,
        "skippedAtDate": "2026-09-22T14:34:54+00:00",
        "skippedBlockIndex": "14930156-1088"
      },
      "estimatedDurationSeconds": 112.9,
      "estimatedDurationsSeconds": {
        "deposit": 10.5,
        "swap": 12,
        "egress": 90.4
      },
      "sourceChainRequiredBlockConfirmations": 3,
      "fees": [
        {
          "type": "broker",
          "asset": "usdc.eth",
          "amountNative": "52863",
          "amount": 0.052863
        }
      ],
      "deposit": {
        "amountNative": "100000000000",
        "amount": 10,
        "transactionReference": "21843947-3",
        "transactionConfirmations": 1,
        "witnessedAt": 1792036476000,
        "witnessedAtDate": "2026-10-15T03:54:36+00:00",
        "witnessedBlockIndex": "15253773-1421",
        "failure": {
          "failedAt": 1790985636000,
          "failedAtDate": "2026-10-03T00:00:36+00:00",
          "failedBlockIndex": "15079633-1298",
          "mode": "DEPOSIT_REJECTED",
          "reason": {
            "code": "TransactionRejectedByBroker",
            "message": "The deposit was rejected by the broker"
          }
        },
        "failedAt": 1790985636000,
        "failedAtDate": "2026-10-03T00:00:36+00:00",
        "failedBlockIndex": "15079633-1298"
      },
      "swap": {
        "originalInputAmountNative": "99802700000",
        "originalInputAmount": 9.98027,
        "remainingInputAmountNative": "0",
        "swappedInputAmountNative": "99802700000",
        "swappedInputAmount": 9.98027,
        "swappedIntermediateAmountNative": "10519896",
        "swappedIntermediateAmount": 10.519896,
        "swappedOutputAmountNative": "102937756",
        "swappedOutputAmount": 0.102937756,
        "livePriceExecutionDeltaPercentage": 0.02,
        "regular": {
          "inputAmountNative": "99802700000",
          "inputAmount": 9.98027,
          "intermediateAmountNative": "10519896",
          "intermediateAmount": 10.519896,
          "outputAmountNative": "102937756",
          "outputAmount": 0.102937756,
          "scheduledAt": 1792036476000,
          "scheduledAtDate": "2026-10-15T03:54:36+00:00",
          "scheduledBlockIndex": "15253773-1420",
          "executedAt": 1792036488000,
          "executedAtDate": "2026-10-15T03:54:48+00:00",
          "executedBlockIndex": "15253775-1682",
          "latestSwapRescheduledAt": 1790087748000,
          "latestSwapRescheduledAtDate": "2026-09-22T14:35:48+00:00",
          "latestSwapRescheduledBlockIndex": "14930165-2005",
          "latestSwapRescheduledReason": "MinPriceViolation",
          "abortedAt": 1790087778000,
          "abortedAtDate": "2026-09-22T14:36:18+00:00",
          "abortedBlockIndex": "14930170-2208",
          "abortedReason": "MinPriceViolation"
        },
        "dca": {
          "lastExecutedChunk": {
            "inputAmountNative": "99802700000",
            "inputAmount": 9.98027,
            "intermediateAmountNative": "10519896",
            "intermediateAmount": 10.519896,
            "outputAmountNative": "102937756",
            "outputAmount": 0.102937756,
            "scheduledAt": 1792036476000,
            "scheduledAtDate": "2026-10-15T03:54:36+00:00",
            "scheduledBlockIndex": "15253773-1420",
            "executedAt": 1792036488000,
            "executedAtDate": "2026-10-15T03:54:48+00:00",
            "executedBlockIndex": "15253775-1682",
            "latestSwapRescheduledAt": 1790087748000,
            "latestSwapRescheduledAtDate": "2026-09-22T14:35:48+00:00",
            "latestSwapRescheduledBlockIndex": "14930165-2005",
            "latestSwapRescheduledReason": "MinPriceViolation",
            "abortedAt": 1790087778000,
            "abortedAtDate": "2026-09-22T14:36:18+00:00",
            "abortedBlockIndex": "14930170-2208",
            "abortedReason": "MinPriceViolation"
          },
          "currentChunk": {
            "inputAmountNative": "99802700000",
            "inputAmount": 9.98027,
            "intermediateAmountNative": "10519896",
            "intermediateAmount": 10.519896,
            "outputAmountNative": "102937756",
            "outputAmount": 0.102937756,
            "scheduledAt": 1792036476000,
            "scheduledAtDate": "2026-10-15T03:54:36+00:00",
            "scheduledBlockIndex": "15253773-1420",
            "executedAt": 1792036488000,
            "executedAtDate": "2026-10-15T03:54:48+00:00",
            "executedBlockIndex": "15253775-1682",
            "latestSwapRescheduledAt": 1790087748000,
            "latestSwapRescheduledAtDate": "2026-09-22T14:35:48+00:00",
            "latestSwapRescheduledBlockIndex": "14930165-2005",
            "latestSwapRescheduledReason": "MinPriceViolation",
            "abortedAt": 1790087778000,
            "abortedAtDate": "2026-09-22T14:36:18+00:00",
            "abortedBlockIndex": "14930170-2208",
            "abortedReason": "MinPriceViolation"
          },
          "executedChunks": 3,
          "remainingChunks": 7
        }
      },
      "swapEgress": {
        "amountNative": "102923756",
        "amount": 0.102923756,
        "scheduledAt": 1792036488000,
        "scheduledAtDate": "2026-10-15T03:54:48+00:00",
        "scheduledBlockIndex": "15253775-1683",
        "transactionReference": "2UyZGnAhXvG3WUmiSCfAw19rRuccgydJpPR9nVwV5fBNsJ5AH1LwzkYLGABsiyt2EtTqxhjo2L11nKXTUWK2Lpnj",
        "witnessedAt": 1792036626001,
        "witnessedBlockIndex": "15253798-1668",
        "failure": {
          "failedAt": 1790985636000,
          "failedAtDate": "2026-10-03T00:00:36+00:00",
          "failedBlockIndex": "15079633-1298",
          "mode": "DEPOSIT_REJECTED",
          "reason": {
            "code": "TransactionRejectedByBroker",
            "message": "The deposit was rejected by the broker"
          }
        },
        "failedAt": 1741265580000,
        "failedAtDate": "2025-03-06T12:53:00+00:00",
        "failedBlockIndex": "6864282-895",
        "destinationAddress": "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin",
        "transactionPayload": {
          "contract": "0x79001a5e762f3befc8e5871b42f6734e00498920",
          "value": "0",
          "chainId": "42161",
          "data": "0x5293178e1f2a11943836956f8ae0da6e"
        }
      },
      "refundEgress": {
        "amountNative": "102923756",
        "amount": 0.102923756,
        "scheduledAt": 1792036488000,
        "scheduledAtDate": "2026-10-15T03:54:48+00:00",
        "scheduledBlockIndex": "15253775-1683",
        "transactionReference": "2UyZGnAhXvG3WUmiSCfAw19rRuccgydJpPR9nVwV5fBNsJ5AH1LwzkYLGABsiyt2EtTqxhjo2L11nKXTUWK2Lpnj",
        "witnessedAt": 1792036626001,
        "witnessedBlockIndex": "15253798-1668",
        "failure": {
          "failedAt": 1790985636000,
          "failedAtDate": "2026-10-03T00:00:36+00:00",
          "failedBlockIndex": "15079633-1298",
          "mode": "DEPOSIT_REJECTED",
          "reason": {
            "code": "TransactionRejectedByBroker",
            "message": "The deposit was rejected by the broker"
          }
        },
        "failedAt": 1741265580000,
        "failedAtDate": "2025-03-06T12:53:00+00:00",
        "failedBlockIndex": "6864282-895",
        "destinationAddress": "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin",
        "transactionPayload": {
          "contract": "0x79001a5e762f3befc8e5871b42f6734e00498920",
          "value": "0",
          "chainId": "42161",
          "data": "0x5293178e1f2a11943836956f8ae0da6e"
        }
      },
      "lastStateChainUpdateAt": 1792153021389,
      "lastStateChainUpdateAtDate": "2026-10-16T12:17:01.389+00:00"
    }
  }
]

Changes

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