List Conversions

GET 
/v2/otc/conversions

deprecated

This endpoint has been deprecated and may be replaced or removed in future versions of the API.

Retrieve a list of currency conversions associated with the specified user. Optional filter parameters can be used to refine your search.

Request

Query Parameters

page number

Default value: 1

Page number.

size number

Possible values: <= 100

Default value: 20

Page size. Max size is 100.

sort string

Possible values: [created_at]

Page sort attribute.

order string

Possible values: [asc, desc]

Default value: asc

Page order.

operation_id string

Operation ID for conversion.

currency_symbol string

Currency Symbol for conversion.

quotation_id string

Quotation ID for conversion.

conversion_type string

Possible values: [buy, sell]

Conversion type.

client_name string

Conversion client name.

client_document string

Conversion client document.

created_at_start date-time

Created at start for any conversion.

created_at_end date-time

Created at end for any conversion.

Header Parameters

nonce stringrequired

The nonce ID is a UUID (v4) used to uniquely identify the request. All requests must have an identifier.

x-lang string

Possible values: [pt-BR, en-US]

Indicates the preferred language. Defaults to Brazilian Portuguese if unspecified.

x-product-uuid string

The product ID is a UUID (v4) used to identify the Z.ro product configuration.

x-product-target-user-uuid string

The product target user ID is a UUID (v4) used to identify what user account this request must be executed. Require: x-product-uuid.

Responses

200

The conversions returned successfully.

application/json

Schema

Schema

page numberrequired

Page number.

page_size numberrequired

Page size.

page_total numberrequired

Page total.

total numberrequired

Total of elements.

data object[]required
Conversion data.
Array [
id stringrequired
Conversion UUID.
operation_id stringrequired
Operation UUID. Used to track the conversion.
quotation_id string
Quotation UUID. Used to track the quotation for this conversion.
price numberrequired
Conversion price.
side stringrequired
Possible values: [buy, sell]
Conversion side.
quote_amount numberrequired
Conversion quote amount.
quote_currency_symbol stringrequired
Conversion quote currency symbol.
quote_currency_decimal numberrequired
Conversion quote currency decimal.
quote_currency_title stringrequired
Conversion quote currency title.
base_amount numberrequired
Conversion base amount.
base_currency_symbol stringrequired
Conversion base currency symbol.
base_currency_decimal numberrequired
Conversion base currency decimal.
base_currency_title stringrequired
Conversion base currency title.
created_at date-time
Conversion created at.
]

Example (from schema)

{
  "page": 1,
  "page_size": 20,
  "page_total": 20,
  "total": 100,
  "data": [
    {
      "id": "f6e2e084-29b9-4935-a059-5473b13033aa",
      "operation_id": "f6e2e084-29b9-4935-a059-5473b13033aa",
      "quotation_id": "f6e2e084-29b9-4935-a059-5473b13033aa",
      "price": 0,
      "side": "buy",
      "quote_amount": 0,
      "quote_currency_symbol": "BRL",
      "quote_currency_decimal": "2",
      "quote_currency_title": "Real",
      "base_amount": 0,
      "base_currency_symbol": "BTC",
      "base_currency_decimal": "8",
      "base_currency_title": "Real",
      "created_at": "2025-04-30T01:29:53.496Z"
    }
  ]
}

400

If any required params are missing or has invalid format or type.

401

User authentication failed.

422

If any required params are missing or has invalid format or type.

Authorization: http

name: bearertype: httpscheme: bearerbearerFormat: JWT

• curl
• python
• go
• nodejs
• ruby
• csharp
• php
• java
• powershell

• CURL

curl -L -X GET 'https://docs.zrobank.io/v2/otc/conversions' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

Request Collapse all

Auth

Bearer Token

Parameters

nonce — headerrequired

page — query

size — query

sort — query

---created_at

order — query

---ascdesc

operation_id — query

currency_symbol — query

quotation_id — query

conversion_type — query

---buysell

client_name — query

client_document — query

created_at_start — query

created_at_end — query

x-lang — header

---pt-BRen-US

x-product-uuid — header

x-product-target-user-uuid — header

ResponseClear

Click the Send API Request button above and see the response here!