Forex

Convert between currencies

Changed on

Convert between two currencies on the /rates panel.

Both codes must appear on GET /api/v1/forex/rates. The applied rate is a central-bank reference, not a tradable market rate. /currencies remains the ECB subset used by /latest and /history.

get/api/v1/forex/convert

Request

  • Base URL: https://sugra.ai
  • URL: https://sugra.ai/api/v1/forex/convert
  • Auth: API key in header x-api-key

Query parameters

amountnumber required

Amount to convert (positive number).

fromstring required

Source currency (3-letter ISO 4217 code).

tostring required

Target currency (3-letter ISO 4217 code).

Response

Converted amount, applied rate, reference date, and the two panel rows used.

Example response

{
  "data": {
    "from_currency": "USD",
    "to_currency": "EUR",
    "amount": 100,
    "result": 91.97,
    "rate": 0.9197,
    "date": "2026-03-13",
    "path": "bdi-direct",
    "basis": "central-bank reference, not tradable",
    "legs": [
      {
        "currency": "USD",
        "rate": 1.1622,
        "as_of": "2026-09-04",
        "cadence": "daily",
        "source": "bdi"
      }
    ]
  },
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "data_age_days": 8.532,
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ],
    "stale_since": "2026-09-08T12:00:00Z",
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes