Buy Transactions List

post

https://herald-otc-api-sandbox.heraldex.com:3292/api/v1/buy-transactions-list

This API retrieves a paginated list of a user’s buy (on-ramp) transactions, showing all fiat-to-crypto purchases made from the wallet or payment methods. It supports filtering by status, search keyword, and date range, and returns detailed transaction records including amounts, exchange rates, fees, and final credited crypto.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

page

integer

required

Defaults to 1

The page number used for paginated retrieval of transaction records.

string

A keyword to filter transactions based on user, transaction ID, or other relevant details.

status

string

enum

The status of transactions to filter by (e.g., pending, completed, failed).

0 - Pending, 1 - Success, 2 - Failed, 3 - Partially failed, 4 - Mismatch, 5 - Revert, 6 - Refund

Allowed:

start_date

string

The start date to filter transactions from a specific time period.

end_date

string

The end date to filter transactions up to a specific time period.

Headers

x-api-key

string

required

The unique API key assigned to the client for authenticating API requests.

x-api-signature

string

required

The cryptographic signature generated to verify the integrity and authenticity of the request.

x-api-timestamp

string

required

The timestamp of the API request used to prevent replay attacks.

Authorization

string

required

Bearer token used to authenticate and authorize access to the API.

Responses

200Success

422Unprocessable Entity