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 onsortif 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 tocompletedonly, 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. Todaychainflipis the only accepted value; the field exists so future providers can be added without a breaking change.
API Endpoint
/swaps- View swaps.
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"
}
}
}
]