Search for swaps

GET

/v1/swaps/search

This endpoint allows you to search for finished swaps by date range, swap trade ID, or user ID, individually or in combination, with the search period limited to a maximum of 31 days.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Query Params

Responses

🟢200

application/json

List swap trades that match the search query parameters

Body

🟠401

🟠405

🟠422

🔴500

🔴503

🟠429429

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://test.whitelabel.bitpanda.com/v1/swaps/search?date_start=2023-06-28&date_end=2023-06-28&swap_trade_id=d969468d-2be6-4522-977e-ea4d92c45e86&user_id=1edfadad-9ab8-6a30-9760-0242ac120003&page_size=10&page=1' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "data": [
        {
            "id": "d969468d-2be6-4522-977e-ea4d92c45e86",
            "source_asset_id": 1,
            "source_asset_symbol": "BTC",
            "target_asset_id": 5,
            "target_asset_symbol": "ETH",
            "source_asset_amount": "0.00000001",
            "target_asset_amount": "12345.12345700",
            "status": "completed",
            "tax_amount": "0.10",
            "user_id": "1edfadad-9ab8-6a30-9760-0242ac120003",
            "time": "2023-07-19T12:14:28+00:00"
        }
    ],
    "meta": {
        "total_count": 48,
        "page": 3,
        "page_size": 10
    },
    "links": {
        "first": "?page=1&page_size=10",
        "last": "?page=5&page_size=10",
        "prev": "?page=2&page_size=10",
        "next": "?page=4&page_size=10",
        "self": "?page=3&page_size=10"
    }
}

Lightweight Search for trades V2

Swap details by swap offer ID