Skip to main content

View Swap History

Details​

Get a historical overview of all swaps which have happened via your broker.

The default for this call is to return the last 50 completed swaps.

Parameters​

You can control the swaps returned by providing the following parameters:

  • offset - Swap id to return results from, depends on sort if it counts ascending or descending.
  • limit - Number of results to return, defaults to 50, maximum 500.
  • status - Only return swaps which match these statuses. Multiple can be supplied by passing in the parameter multiple times. Defaults to completed only, so pass the states you care about if you also want swaps in progress or failed swaps.
  • sort - Sort order, default descending.
  • platform - Optional provider to filter swaps by (e.g. chainflip). Unknown values return a 400. Today chainflip is the only accepted value; the field exists so future providers can be added without a breaking change.

API Endpoint​

Example​

tip

Want to test first? Change the API base URL to https://perseverance.chainflip-broker.io. The Testing environment swaps testnet assets with no real value.

Swap the API key in the examples for your own production API key. Testing requires a separate testnet API key.

curl --location 'https://chainflip-broker.io/swaps?apiKey=87517a91d5f34dbabfc1e410946a3a3c&sort=ascending&offset=2&limit=3&status=receiving&status=swapping&status=sending&status=sent&status=completed&status=failed'

Example response captured on the testing environment; response shape is identical on production. These values are illustrative, not output from the production request above.

[
{
"id": 21,
"platform": "chainflip",
"status": {
"state": "completed",
"swapId": "1276",
"sourceAsset": "btc.btc",
"destinationAsset": "flip.eth",
"destinationAddress": "0xdc009de550099fb68a85214dd41ed94eb9c99ca6",
"depositChannel": {
"id": "1519086-Bitcoin-125",
"createdAt": 1719515250801,
"createdAtDate": "2024-06-27T19:07:30.801+00:00",
"brokerCommissionBps": 5,
"depositAddress": "tb1p9rj4vwst6u8h0kyz4uukf0ghkld7jn7jfurtgc0g3ltkmsxme4wqjtelyk",
"sourceChainExpiryBlock": "2862207",
"estimatedExpiryTime": 1719522960002,
"estimatedExpiryDate": "2024-06-27T21:16:00.002+00:00",
"isExpired": true,
"openedThroughBackend": false,
"affiliateBrokers": [
{
"account": "cFMTcq3p1C4Yhpw7NPn88Jdzj6ryVD8cTGPBuVMR4U6tFVdQb",
"commissionBps": 10
}
]
},
"boost": {
"maximumBoostFeeBps": 30,
"effectiveBoostFeeBps": 5,
"boostedAt": 1719515352000,
"boostedAtDate": "2024-06-27T19:09:12+00:00",
"boostedBlockIndex": "1519106-725"
},
"estimatedDurationSeconds": 3630,
"sourceChainRequiredBlockConfirmations": 6,
"fees": [
{
"type": "broker",
"asset": "btc.btc",
"amountNative": "294",
"amount": 0.00000294
},
{
"type": "boost",
"asset": "btc.btc",
"amountNative": "100",
"amount": 0.000001
},
{
"type": "ingress",
"asset": "btc.btc",
"amountNative": "3592",
"amount": 0.00003592
},
{
"type": "network",
"asset": "usdc.eth",
"amountNative": "360619",
"amount": 0.360619
},
{
"type": "liquidity",
"asset": "usdc.eth",
"amountNative": "7205",
"amount": 0.007205
},
{
"type": "egress",
"asset": "flip.eth",
"amountNative": "55763039571330911",
"amount": 0.055763039571330911
},
{
"type": "liquidity",
"asset": "btc.btc",
"amountNative": "294",
"amount": 0.00000294
}
],
"deposit": {
"amountNative": "200000",
"amount": 0.002,
"witnessedAt": 1719515352000,
"witnessedAtDate": "2024-06-27T19:09:12+00:00",
"witnessedBlockIndex": "1519106-724"
},
"swap": {
"originalInputAmountNative": "196114",
"originalInputAmount": 0.00196114,
"remainingInputAmountNative": "0",
"remainingInputAmount": 0,
"swappedInputAmountNative": "196114",
"swappedInputAmount": 0.00196114,
"swappedIntermediateAmountNative": "360258786",
"swappedIntermediateAmount": 360.258786,
"swappedOutputAmountNative": "4316942943975497390",
"swappedOutputAmount": 4.31694294397549739,
"regular": {
"inputAmountNative": "196114",
"inputAmount": 0.00196114,
"intermediateAmountNative": "360258786",
"intermediateAmount": 360.258786,
"outputAmountNative": "4316942943975497390",
"outputAmount": 4.31694294397549739,
"scheduledAt": 1719515352000,
"scheduledAtDate": "2024-06-27T19:09:12+00:00",
"scheduledBlockIndex": "1519106-724",
"executedAt": 1719515364000,
"executedAtDate": "2024-06-27T19:09:24+00:00",
"executedBlockIndex": "1519108-278",
"retryCount": 0
}
},
"swapEgress": {
"amountNative": "4261179904404166479",
"amount": 4.261179904404166479,
"scheduledAt": 1719515364000,
"scheduledAtDate": "2024-06-27T19:09:24+00:00",
"scheduledBlockIndex": "1519108-279",
"transactionReference": "0xc31ae05f009b480da83d3cd6be45a641ccd31d80e3467c5b7db6d9d058530f9d",
"witnessedAt": 1719515742000,
"witnessedBlockIndex": "1519169-825"
}
}
},
{
"id": 212,
"platform": "chainflip",
"status": {
"state": "completed",
"swapId": "2193",
"sourceAsset": "eth.eth",
"destinationAsset": "dot.hub",
"destinationAddress": "1BzDB5n2rfSJwvuCW9deKY9XnUyys8Gy44SoX8tRNDCFBhx",
"depositChannel": {
"id": "2294758-Ethereum-22",
"createdAt": 1724242335733,
"createdAtDate": "2024-08-21T12:12:15.733+00:00",
"brokerCommissionBps": 5,
"depositAddress": "0x5060ba7b0cfff0d528e90f33cfaa345d2de80e8b",
"sourceChainExpiryBlock": "6543574",
"estimatedExpiryTime": 1724248506000,
"estimatedExpiryDate": "2024-08-21T13:55:06+00:00",
"isExpired": true,
"openedThroughBackend": false,
"affiliateBrokers": [
{
"account": "cFMTcq3p1C4Yhpw7NPn88Jdzj6ryVD8cTGPBuVMR4U6tFVdQb",
"commissionBps": 10
}
]
},
"estimatedDurationSeconds": 108,
"sourceChainRequiredBlockConfirmations": 7,
"fees": [
{
"type": "broker",
"asset": "eth.eth",
"amountNative": "13394236325775",
"amount": 0.000013394236325775
},
{
"type": "ingress",
"asset": "eth.eth",
"amountNative": "1070509116150000",
"amount": 0.00107050911615
},
{
"type": "network",
"asset": "usdc.eth",
"amountNative": "90670",
"amount": 0.09067
},
{
"type": "liquidity",
"asset": "usdc.eth",
"amountNative": "1811",
"amount": 0.001811
},
{
"type": "egress",
"asset": "dot.hub",
"amountNative": "197450000",
"amount": 0.019745
},
{
"type": "liquidity",
"asset": "eth.eth",
"amountNative": "4458048323762",
"amount": 0.000004458048323762
}
],
"deposit": {
"amountNative": "10000000000000000",
"amount": 0.01,
"transactionReference": "0x99989d865337b1346dc46481860c6a4bb78cac0759c3a2f5878b140638ecf5b7",
"witnessedAt": 1724242422001,
"witnessedAtDate": "2024-08-21T12:13:42.001+00:00",
"witnessedBlockIndex": "2294775-820"
},
"swap": {
"originalInputAmountNative": "8916096647524225",
"originalInputAmount": 0.008916096647524225,
"remainingInputAmountNative": "0",
"remainingInputAmount": 0,
"swappedInputAmountNative": "8916096647524225",
"swappedInputAmount": 0.008916096647524225,
"swappedIntermediateAmountNative": "90579377",
"swappedIntermediateAmount": 90.579377,
"swappedOutputAmountNative": "103659397682",
"swappedOutputAmount": 10.3659397682,
"regular": {
"inputAmountNative": "8916096647524225",
"inputAmount": 0.008916096647524225,
"intermediateAmountNative": "90579377",
"intermediateAmount": 90.579377,
"outputAmountNative": "103659397682",
"outputAmount": 10.3659397682,
"scheduledAt": 1724242422001,
"scheduledAtDate": "2024-08-21T12:13:42.001+00:00",
"scheduledBlockIndex": "2294775-820",
"executedAt": 1724242434001,
"executedAtDate": "2024-08-21T12:13:54.001+00:00",
"executedBlockIndex": "2294777-653",
"retryCount": 0
}
},
"swapEgress": {
"amountNative": "103461947682",
"amount": 10.3461947682,
"scheduledAt": 1724242434001,
"scheduledAtDate": "2024-08-21T12:13:54.001+00:00",
"scheduledBlockIndex": "2294777-654",
"transactionReference": "5141306-2",
"witnessedAt": 1724242584000,
"witnessedBlockIndex": "2294802-559"
}
}
},
{
"id": 214,
"platform": "chainflip",
"status": {
"state": "completed",
"swapId": "2194",
"sourceAsset": "eth.eth",
"destinationAsset": "dot.hub",
"destinationAddress": "1BzDB5n2rfSJwvuCW9deKY9XnUyys8Gy44SoX8tRNDCFBhx",
"depositChannel": {
"id": "2294832-Ethereum-12",
"createdAt": 1724242789342,
"createdAtDate": "2024-08-21T12:19:49.342+00:00",
"brokerCommissionBps": 5,
"depositAddress": "0xdc91b85ebd6e2618a38fc97eb241231fe0d811ae",
"sourceChainExpiryBlock": "6543609",
"estimatedExpiryTime": 1724248962000,
"estimatedExpiryDate": "2024-08-21T14:02:42+00:00",
"isExpired": true,
"openedThroughBackend": false,
"affiliateBrokers": [
{
"account": "cFMTcq3p1C4Yhpw7NPn88Jdzj6ryVD8cTGPBuVMR4U6tFVdQb",
"commissionBps": 10
}
]
},
"estimatedDurationSeconds": 108,
"sourceChainRequiredBlockConfirmations": 7,
"fees": [
{
"type": "broker",
"asset": "eth.eth",
"amountNative": "11574402976725",
"amount": 0.000011574402976725
},
{
"type": "ingress",
"asset": "eth.eth",
"amountNative": "2283731348850000",
"amount": 0.00228373134885
},
{
"type": "network",
"asset": "usdc.eth",
"amountNative": "78319",
"amount": 0.078319
},
{
"type": "liquidity",
"asset": "usdc.eth",
"amountNative": "1564",
"amount": 0.001564
},
{
"type": "egress",
"asset": "dot.hub",
"amountNative": "197450000",
"amount": 0.019745
},
{
"type": "liquidity",
"asset": "eth.eth",
"amountNative": "3852347124087",
"amount": 0.000003852347124087
}
],
"deposit": {
"amountNative": "10000000000000000",
"amount": 0.01,
"transactionReference": "0xd15c8b27a8cbb6ed098227d6fd07812ca0bfc207e8986175e772984da43a7c95",
"witnessedAt": 1724242890000,
"witnessedAtDate": "2024-08-21T12:21:30+00:00",
"witnessedBlockIndex": "2294851-900"
},
"swap": {
"originalInputAmountNative": "7704694248173275",
"originalInputAmount": 0.007704694248173275,
"remainingInputAmountNative": "0",
"remainingInputAmount": 0,
"swappedInputAmountNative": "7704694248173275",
"swappedInputAmount": 0.007704694248173275,
"swappedIntermediateAmountNative": "78240741",
"swappedIntermediateAmount": 78.240741,
"swappedOutputAmountNative": "89499099997",
"swappedOutputAmount": 8.9499099997,
"regular": {
"inputAmountNative": "7704694248173275",
"inputAmount": 0.007704694248173275,
"intermediateAmountNative": "78240741",
"intermediateAmount": 78.240741,
"outputAmountNative": "89499099997",
"outputAmount": 8.9499099997,
"scheduledAt": 1724242890000,
"scheduledAtDate": "2024-08-21T12:21:30+00:00",
"scheduledBlockIndex": "2294851-900",
"executedAt": 1724242902001,
"executedAtDate": "2024-08-21T12:21:42.001+00:00",
"executedBlockIndex": "2294853-751",
"retryCount": 0
}
},
"swapEgress": {
"amountNative": "89301649997",
"amount": 8.9301649997,
"scheduledAt": 1724242902001,
"scheduledAtDate": "2024-08-21T12:21:42.001+00:00",
"scheduledBlockIndex": "2294853-752",
"transactionReference": "5141384-2",
"witnessedAt": 1724243052000,
"witnessedBlockIndex": "2294877-573"
}
}
}
]