BlueHouse API

Convert a batch

Live

Converts several dated peso amounts with the same rate type and quote side.

POST/api/v1/convert/batch

Items may mix date and datetime. A date resolves to the end of that Buenos Aires day.

Request body

Field	Type	Description
currency*	HouseName	Rate type used for every item.
side*	"buy" \| "sell" \| "mid"	Quote side used for every item.
items*	ConversionItem[]	Items containing id, amount, and either date or datetime.

Response

Field	Type	Description
data	object	Batch conversion result.
currency	HouseName	Rate type used.
side	"buy" \| "sell" \| "mid"	Quote side used.
items	object[]	Converted items, echoing each input id.
queryTime	number	Database query duration in milliseconds.

Example

{
  "data": {
    "currency": "blue",
    "side": "sell",
    "items": [
      {
        "id": "invoice-123",
        "amount": 125000,
        "convertedAmount": 96.15,
        "rate": 1300,
        "requestedAt": "2026-07-16T02:59:59.999-03:00",
        "rateDate": "2026-07-15T14:22:11.000-03:00",
        "interpolated": false,
        "rateSources": [
          {
            "rateDate": "2026-07-15T14:22:11.000-03:00",
            "value": 1300
          }
        ]
      },
      {
        "id": "subscription-456",
        "amount": 39990,
        "convertedAmount": 30.76,
        "rate": 1300,
        "requestedAt": "2026-07-22T14:32:00.000-03:00",
        "rateDate": "2026-07-22T13:58:40.000-03:00",
        "interpolated": false,
        "rateSources": [
          {
            "rateDate": "2026-07-22T13:58:40.000-03:00",
            "value": 1300
          }
        ]
      }
    ]
  },
  "queryTime": 5
}