List Pairs

The method GET /pairs enables you to retrieve a list of pairs that can be used to Request a Quote.

Endpoint URL

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

Request

Query Fields

You can use the following query parameters in your request

Parameter	Description	Required
`source`	Allows you to filter pairs by the source currency or asset	No
`target`	Allows you to filter pairs by the target currency or asset	No

Example

GET https://api.bitso.com/rfq/v1/pairs?source=BTC

Response

Fields

Field	Type	Description
`source`	string	Source currency or asset
`target`	string	Target currency or asset
`source_precision`	string	Max number of decimals for the `source` field
`target_precision`	string	Max number of decimals for the `target` field

Payload Example

The response for this request will be an array of pairs, based on the filters provided.

{
  "pairs": [
    {
      "source": "BTC",
      "target": "USDT",
      "source_precision": "8",
      "target_precision": "6"
    },
    {
      "source": "USDT",
      "target": "BTC",
      "source_precision": "6",
      "target_precision": "8"
    },
    {
      "source": "USDT",
      "target": "MXN",
      "source_precision": "8",
      "target_precision": "2"
    },
    {
      "source": "MXN",
      "target": "USDT",
      "source_precision": "2",
      "target_precision": "8"
    }
  ]
}

Error

Responses

Status Code	Error Code	Error Message
500	`fetching_pairs_api_error`	Error fetching trading pairs

Payload Example

{
  "errors": [
    {
      "code": "fetching_pairs_api_error",
      "message": "Error fetching trading pairs"
    }
  ]
}