# 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

* [`/swaps`](https://chainflip-broker.io/docs/ui/index.html#tag/Swaps/operation/listSwaps) - View swaps.

## Example

> **Tip**
>
> Want to test first? Change the API base URL to `https://perseverance.chainflip-broker.io`. The [Testing](https://docs.chainflip-broker.io/environments/testing/) environment swaps testnet assets with no real value.
>
> Swap the API key in the examples for your own [production API key](https://chainflip-broker.io/register). Testing requires a separate [testnet API key](https://perseverance.chainflip-broker.io/register).

```bash
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.*

```json
[
  {
    "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"
      }
    }
  }
]
```
