List RFQ Conversions

The method GET /conversions enables you to retrieve a list of RFQ conversions that were previously created.

Endpoint URL

GET https://api.bitso.com/rfq/v1/conversions

Request

Query Fields

You can use the following query parameters in your request

Parameter	Description	Required	Default Value
`status`	Allows you to filter conversions by status	No
`page_size`	Allows you to define the maximum number of records returned by page	No	100
`page_token`	Encrypted value used to retrieve records from next page of the pagination. This value is returned by the endpoint itself in case there are more records to be retrieved.	No

Example

GET https://api.bitso.com/rfq/v1/conversions?status=COMPLETED&page_size=1

Response

Fields

Field	Type	Description
`id`	string	Unique conversion transaction ID
`source`	string	Source currency (what was sold)
`target`	string	Target currency (what was bought)
`source_amount`	string	Amount of source currency converted
`target_amount`	string	Amount of target currency received
`quote_id`	string	Original quote ID that was executed
`rate`	string	Exchange rate applied (including fees)
`fee_amount`	string	Total fee charged for the conversion
`fee_currency`	string	Currency in which the fee was charged
`status`	string	Conversion status: `INITIATED`, `TERMINATED`, `COMPLETED`, `FAILED`
`quoted_at`	string	When the original quote was created
`created_at`	string	When the conversion was executed
`updated_at`	string	Last update timestamp

Payload Example

{
  "conversions": [
    {
      "id": "38c441b2-b192-401d-a33e-8c36d03ad90c",
      "source": "USDT",
      "target": "BTC",
      "source_amount": "10.0000000000",
      "target_amount": "0.0000866500",
      "quote_id": "38c441b2-b192-401d-a33e-8c36d03ad90c",
      "rate": "115406.8090017311",
      "fee_amount": "0.0000000000",
      "fee_currency": "USDT",
      "status": "COMPLETED",
      "quoted_at": "2025-08-07T10:26:42Z",
      "created_at": "2025-08-07T10:26:42Z",
      "updated_at": "2025-08-07T10:26:43Z"
    }
  ],
  "next_page_token": "eyJwYXlsb2FkIjoiMiIsInNpZ25hdHVyZSI6InRuaWQwQ3BVRmdOS3E1dUMifQ",
  "total_count": 4
}

Error

Responses

Status Code	Error Code	Description
400	`invalid_page_token_received`	Invalid page_token provided
500	`failed_creating_page_token`	Failed to create next page token
500	`unexpected`	Internal server error

Payload Example

{
  "errors": [
    {
      "code": "invalid_page_token_received",
      "message": "Invalid page_token provided"
    }
  ]
}