Search for trades

GET

/v1/trades/search

This endpoint allows you to search for finished trades by date range, trade ID, offer 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

🟢200OK

application/json

List trades that match the search query parameters

Bodyapplication/json

🟠401Unauthorized

🟠422Parameter Error

🟠429

🔴500Server Error

🔴503Service Unavailable

Request Example

Shell

JavaScript

Java

curl --location 'https://test.whitelabel.bitpanda.com/v1/trades/search?date_start=2021-04-25&date_end=2021-06-25&status=all&internal_trade_id=2e4c89ac-1290-426f-8de0-4c7b40b91d3a&external_transaction_id=77b5d766-e5da-4dd9-bd18-58a43c35b8ac&offer_id=abc5d766-e5da-4dd9-bd18-58a43c35b8ac&user_pid=abc2d123-a5db-4dd9-bd18-58a43c35b9ab&initiated_by=all&page_size=10&page=1' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "data": [
        {
            "id": "abcc89ac-1290-426f-8de0-4c7b40b91d3a",
            "offer_id": "2e4c89ac-1290-426f-8de0-4c7b40b91d3a",
            "type": "buy",
            "fiat_id": 1,
            "asset_id": 1,
            "fiat_amount": "1.89",
            "tax_amount": "0.10",
            "total_amount": "1.99",
            "asset_amount": "0.00060120",
            "asset_price": "11278.15044158",
            "time": "2022-09-30T14:56:45+03:00",
            "external_transaction_id": "abc-ext-123-123",
            "user_pid": "abc170cc-abcb-4318-abc5-24abc9210d75",
            "status": "finished",
            "fiat_symbol": "EUR",
            "asset_symbol": "BTC",
            "gross_fee": "11278.15044158",
            "fees_after_cost": "0.00000000",
            "final_revenue_share": "0.00000000",
            "initiated_by": "user"
        }
    ],
    "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"
    }
}

Modified at 2026-06-03 14:26:41

Get trades history for user using asset and fiat uuid

Lightweight Search for trades V2