BlueHouse API

Compare rates

Live

Returns the latest quote for every requested type plus percentage spreads against the oficial rate.

GET/api/v1/rates/compare

Parameters

Field	Type	Description
types	HouseName CSV	Comma-separated houses to compare. Defaults to all houses.
field	"buy" \| "sell" \| "mid"	Quote side compared.

Response

Field	Type	Description
data	object	Rates keyed by house plus the spread object.
rates	Record<HouseName, number \| null>	Latest value of the selected field per requested house.
spread	Record<string, number \| null>	Percentage difference against oficial, keyed as typeVsOficial.
queryTime	number	Database query duration in milliseconds.

Example

{
  "data": {
    "field": "sell",
    "rates": {
      "oficial": 1025,
      "blue": 1310,
      "tarjeta": 1378
    },
    "spread": {
      "blueVsOficial": 27.8049,
      "tarjetaVsOficial": 34.439
    }
  },
  "queryTime": 3
}