UPP Docs
Exchange

List exchanges

GET
/exchanges

The merchant's exchanges, newest first, with cursor pagination.

Authorization

merchantApiKeymerchantTimestampmerchantNoncemerchantSignature
headerX-API-KEY<token>

Merchant API key (starts with upk_, also accepts api-key); signing headers are also required

headerX-Timestamp<token>

Unix timestamp in seconds, within 300 seconds of server time

headerX-Nonce<token>

Unique per request; cannot be reused with the same credential during the timestamp validity window

headerX-Signature<token>

Hex HMAC-SHA256 signature (either letter case) of the method, full path, timestamp, nonce and body digest

Query Parameters

status?string
  • pending: sell amount held, waiting for the provider's result
  • completed: completed and booked
  • failed: failed, see failure_reason; the held amount is released and no fee is charged
Value in"pending""completed""failed"
limit?integer

Page size, 1 to 100, default 20

Range1 <= value <= 100
cursor?string

next_cursor from the previous page

Response Body

Exchanges; next_cursor is null when there are no more

application/json
  1. response
data*array<>
next_cursor*string|null
Example Request
curl -X GET 'https://sandbox.getupp.net/api/v1/exchanges'
Example Response
{  "data": [    {      "id": "string",      "quote_id": "string",      "status": "pending",      "sell_amount": "string",      "sell_currency": "string",      "buy_amount": "string",      "buy_currency": "string",      "rate": "string",      "fee": "string",      "fee_currency": "string",      "failure_reason": "string",      "created_at": "2019-08-24T14:15:22Z",      "completed_at": "2019-08-24T14:15:22Z"    }  ],  "next_cursor": "string"}