> For the complete documentation index, see [llms.txt](https://docs.blockz.fi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blockz.fi/api/submit-intent/swap-history.md).

# Swap History

Retrieve swap history associated with specific wallet addresses or a Partner user identifier.

This endpoint returns a paginated list of swaps along with their current status and metadata.

```http
GET /affiliate/v1/swaps/history
```

#### Query parameters

| Name       | Type      | Required | Description                                                |
| ---------- | --------- | -------- | ---------------------------------------------------------- |
| limit      | integer   | false    | Maximum number of swaps to return                          |
| offset     | integer   | false    | Number of swaps to skip before starting to return results  |
| active     | bool      | false    |                                                            |
| wallet     | string\[] | false    | Wallets to query history for. Example: `wallet=1&wallet=2` |
| retail\_id | string    | false    | Retail user ID to query history for                        |

{% hint style="info" %}
Either wallet array or retail\_id must be specified. Failing to specify either will result in a client error.
{% endhint %}

***

#### Response

Returns a paginated list of swaps. Each item includes intent status, transaction metadata, and swap details.

**Response example**

```json
{
  "items": [
    {
      "intent_id": "fe5601fb-60f2-4cb0-8a67-c55bd3640411",
      "status": "Fulfilled",
      "kyc_link": null,
      "swap_metadata": {
        "id": "19b44362-bc4d-4b2e-824f-f712c6c80eff",
        "proxy_address": "0x000000000000000000000000000000000000000",
        "user_deposit_tx": "0x...",
        "fulfill_tx": "0x...",
        "swap_tx": "0x...",
        "created_at": "2026-01-15T12:00:00Z",
        "fulfilled_at": "2026-01-15T12:10:00Z"
      },
      "source_chain": 1,
      "source_token": "0x000000000000000000000000000000000000000",
      "source_amount_decimals": 18,
      "source_amount_lots": "123456",
      "dest_chain": 2,
      "dest_token": "0x000000000000000000000000000000000000000",
      "dest_amount_decimals": 6,
      "min_dest_amount_lots": "123456",
      "max_dest_amount_lots": "123456"
    }
  ],
  "limit": 20,
  "offset": 0,
  "total": 1
}
```