Status

View status of a swap, by transaction hash.

The same swap status as getStatusById, looked up by the hash of the transaction that sent the deposit.

get/status-by-transaction-hash

Request

Base URL: https://chainflip-broker.io
URL: https://chainflip-broker.io/status-by-transaction-hash
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.

transactionHashstring required

The hash of the deposit transaction. For a Polkadot Assethub deposit, either Chainflip's <block>-<extrinsicIndex> reference (as in deposit.transactionReference) or the 0x extrinsic hash; the extrinsic hash matches shortly after the deposit is witnessed.

Response

The swap status.

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.