Retrieve a Quote

Once you have created a Quote, you may want to retrieve it later using its unique id.

Quote Expiration

Quotes have a limited time window for execution:

Created at: When the quote was initially generated
Expires at: The exact expiration time is provided in the quote response
Time-sensitive: Quotes must be converted before the expires_at timestamp

Example timing:

Quote created: 2025-07-30T02:34:58Z
Quote expires: 2025-07-30T02:35:07Z

⚠️ Important: Once expired, quotes cannot be retrieved and will return a quote_not_found error.

Endpoint URL

You can retrieve a previously created quote using the following endpoint:

GET https://api.bitso.com/rfq/v1/quotes/{quote_id}

Request

Path Fields

You can use the following query parameters in your request

Parameter	Description	Required
`quote_id`	The Quote ID to be retrieved	Yes

Example

GET https://api.bitso.com/rfq/v1/quotes/552fd39c-1b1a-438f-b408-c06a51e00bd4

Response

Fields

Field	Type	Description
`id`	string	UUID that uniquely identify the Quote
`source`	string	Source currency or asset of the Quote
`target`	string	Target currency or asset of the Quote
`source_amount`	string	The amount related to the `source` field
`target_amount`	string	The amount related to the `target`field
`rate`	string	source:target Quote price
`status`	string	The status of the Quote: `ACTIVE`, `EXPIRED`, `ACCEPTED`, `REJECTED`
`created_at`	string	The date when the Quote was created
`expires_at`	string	The date when the Quote will expire

Payload Example

{
  "id": "552fd39c-1b1a-438f-b408-c06a51e00bd4",
  "source": "BTC",
  "target": "USDT",
  "source_amount": "0.00100000",
  "target_amount": "114.52",
  "rate": "114520.19",
  "status": "ACTIVE",
  "created_at": "2025-07-25T03:43:15Z",
  "expires_at": "2025-07-25T04:03:15Z"
}

Error

Responses

Status Code	Error Code	Error Message
400	`quote_not_found`	Quote not found

Payload Example

{
  "errors": [
    {
      "code": "quote_not_found",
      "message": "Quote not found"
    }
  ]
}