Swaps

View swaps feed, sorted oldest to newest.

Returns your broker's completed swaps oldest to newest, each with a feedId, for processing every swap exactly once. Store the last feedId you processed and pass feedId + 1 as offset next time; an empty list means you are up to date.

get/feed

Request

  • Base URL: https://chainflip-broker.io
  • URL: https://chainflip-broker.io/feed
  • 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

Feed id to return results from.

limitinteger

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

Response

The swaps in completion order.

feedIdinteger

The swap's position in the feed, increasing in completion order. Store the last one you processed and pass it plus one as offset on the next call.

swapIdinteger

The BaaS swap id, as returned when the swap was started. Use it with getStatusById.

platformstring

The provider that executed the swap.

Example response

[
  {
    "feedId": 1,
    "swapId": 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.