Get List of Transactions

Retrieve a user’s onramp transactions — status, amount, and associated metadata.

Endpoint

URL: https://api.saber.money/api/v2/wallet/transactions?transaction_type=ONRAMP_AND_WITHDRAW
Method: GET

Note: transaction_type is required. If it is missing or empty, the API returns HTTP 400 with body {"success": false, "errors": [{"code": null, "text": "Missing transaction_type"}]}.

Query Parameters

Parameter	Required	Type	Default	Description
`transaction_type`	Yes	string (CSV, e.g. `ONRAMP_AND_WITHDRAW`)	—	Transaction type(s) to fetch. If absent/empty, returns HTTP `400` `Missing transaction_type`.
`limit`	No	integer	`10`	Max number of records to return.
`offset`	No	integer (epoch millis)	now	Created-at paging offset; returns records created before this timestamp.
`sort`	No	string (`asc` or `desc`)	`desc`	Sort order by created-at. An invalid value returns HTTP `404` with body `{"success": false, "errors": [{"code": null, "text": "Invalid sort order. Provide either of 'asc' or 'desc' "}]}`.
`filterFrom`	No	integer (epoch millis)	—	Lower bound (inclusive) on created-at.
`filterTo`	No	integer (epoch millis)	—	Upper bound (inclusive) on created-at.

Headers

Header	Description
`X-Timestamp`	A UNIX timestamp for the request. Used for generating a secure signature.
`X-Client-Id`	Your unique client ID is provided by Saber Money.
`X-Request-Id`	A unique identifier for the request (optional but recommended).
`X-User-Id`	The unique ID of the user whose transactions are being fetched.
`X-Secret-Key`	Your API secret key for authenticating the request.

Response Fields

Every field below is always present in each transaction object returned by this list endpoint. For ONRAMP_AND_WITHDRAW (EXTERNAL_BUY) items the backend only populates the base fields, so the remaining fields are currently serialized with empty / zero values. Clients should not rely on those zeroed fields carrying real data here; populated values are available from the transaction details endpoint.

Field	Type	Description
`id`	string	Unique identifier (UUID) of the transaction.
`transaction_type`	string	Transaction type. For this endpoint always `EXTERNAL_BUY`.
`status`	string	Current status of the transaction. One of: `CREATED`, `ONRAMP_INITIATED`, `ONRAMP_COMPLETED`, `ONRAMP_INCONSISTENT`, `PROCESSING`, `REFUND_INITIATED`, `REFUND_COMPLETED`, `REFUND_FAILED`, `COMPLETED`, `FAILED`.
`amount`	number	Total amount involved (omitted when zero).
`failure_code`	string	Free-form error code string for failed transactions (e.g., `FIAT_PAYMENT_TIMED_OUT`, `PAYMENT_TIMED_OUT`, `FIAT_PAYMENT_FAILED`); only present when applicable.
`failure_desc`	string	Free-form human-readable description of the failure; only present when applicable.
`created_at`	number	Creation timestamp (epoch ms).
`updated_at`	number	Last-updated timestamp (epoch ms).
`uuid`	string	Always present (currently returned empty).
`symbol`	string	Crypto symbol. Always present (currently returned empty).
`user_id`	string	User identifier. Always present (currently returned empty).
`usd_value`	number	Always present (currently returned `0`).
`tag`	string	Always present (currently returned empty).
`source_address`	string	Always present (currently returned empty).
`fiat_amount`	number	Always returned as `0` on this list endpoint. The actual fiat amount is available only from the transaction details endpoint.
`crypto_amount`	number	Always returned as `0` on this list endpoint. The actual crypto amount is available only from the transaction details endpoint.
`fiat_symbol`	string	Always present (currently returned empty).
`crypto_wallet_address`	string	Always present (currently returned empty).
`base_price`	number	Always present (currently returned `0`).
`final_price`	number	Always present (currently returned `0`).
`total_fee`	number	Always returned as `0` on this list endpoint. Fee data is available only from the transaction details endpoint.
`fee_currency`	string	Always present (currently returned empty).
`fee_breakup`	object	Always present. Object with keys `platform_fee`, `network_fee`, `client_fee`, `discount`, `tax_on_fee`, `tds` (all numbers). All values are returned as `0` on this list endpoint; the actual fee breakdown is available only from the transaction details endpoint.

Optional fields that appear only when set: txn_hash, address, network, fees, compliance, source_id, payment_method.

Sample API Call

curl --location 'https://api.saber.money/api/v2/wallet/transactions?transaction_type=ONRAMP_AND_WITHDRAW' \
--header 'X-Timestamp: 1705491300' \
--header 'X-Client-Id: CLIENT_ID_HERE' \
--header 'X-Request-Id: CC' \
--header 'X-User-Id: USER_ID_HERE' \
--header 'X-Secret-Key: SECRET_KEY_HERE'

Sample Response

{
  "success": true,
  "data": [
    {
      "id": "7f6d5dba-37ea-4cb3-92a8-4c3230bd2162",
      "transaction_type": "EXTERNAL_BUY",
      "status": "ONRAMP_COMPLETED",
      "amount": 1.084745,
      "created_at": 1726956980000,
      "updated_at": 1726957204000,
      "uuid": "",
      "symbol": "",
      "user_id": "",
      "usd_value": 0,
      "tag": "",
      "source_address": "",
      "fiat_amount": 0,
      "crypto_amount": 0,
      "fiat_symbol": "",
      "crypto_wallet_address": "",
      "base_price": 0,
      "final_price": 0,
      "total_fee": 0,
      "fee_currency": "",
      "fee_breakup": {
        "platform_fee": 0,
        "network_fee": 0,
        "client_fee": 0,
        "discount": 0,
        "tax_on_fee": 0,
        "tds": 0
      }
    },
    {
      "id": "e255a814-ddac-465b-a061-eaf760f56ded",
      "transaction_type": "EXTERNAL_BUY",
      "status": "FAILED",
      "amount": 1.084745,
      "failure_code": "FIAT_PAYMENT_TIMED_OUT",
      "failure_desc": "Payment not received within time limit",
      "created_at": 1726956825000,
      "updated_at": 1727043307000,
      "uuid": "",
      "symbol": "",
      "user_id": "",
      "usd_value": 0,
      "tag": "",
      "source_address": "",
      "fiat_amount": 0,
      "crypto_amount": 0,
      "fiat_symbol": "",
      "crypto_wallet_address": "",
      "base_price": 0,
      "final_price": 0,
      "total_fee": 0,
      "fee_currency": "",
      "fee_breakup": {
        "platform_fee": 0,
        "network_fee": 0,
        "client_fee": 0,
        "discount": 0,
        "tax_on_fee": 0,
        "tds": 0
      }
    }
  ]
}

Use Cases

Transaction Tracking: Retrieve all transactions for a user to monitor their history and status.
Error Analysis: Use failure_code and failure_desc to analyze and debug failed transactions.
Financial Reporting: Aggregate transaction IDs, statuses and amounts for tracking; fetch the transaction details endpoint when fee or fiat/crypto amount breakdowns are needed for reconciliation.

Notes

Combine with Saber’s webhook system for real-time updates rather than polling. API Reference: Fetch List of Buy Transactions

🔮 Getting Started

⚙️ Setting Up

👤 User Operations

🔒 KYC And bank accounts

💰 OFFRAMP

💲 Onramp

🖥️ Client Functionalities

Endpoint

Query Parameters

Headers

Response Fields

Sample API Call

Sample Response

Use Cases

Notes

​Endpoint

​Query Parameters

​Headers

​Response Fields

​Sample API Call

​Sample Response

​Use Cases

​Notes

Endpoint

Query Parameters

Headers

Response Fields

Sample API Call

Sample Response

Use Cases

Notes