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​

Testnet Example​

curl --location 'https://perseverance.chainflip-broker.io/swaps?apiKey=93c2bff017e243f29ffb14e42dccbec8&sort=ascending&offset=2&limit=3&status=receiving&status=swapping&status=sending&status=sent&status=completed&status=failed'
[
{
"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.dot",
"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.dot",
"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.dot",
"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.dot",
"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"
}
}
}
]