Exchange Rates API Documentation

POSThttps://www.brainiac.software/api/v1/fx/rates/latest$0.01 USDC

Get latest exchange rates

Retrieve latest available exchange rates from the Frankfurter API (ECB data). Rates are delayed reference rates, not real-time market rates.

Body

Field	Required	Notes
`base`	No	string
`symbols`	No	—

Request exampleJSON

{
  "base": "USD",
  "symbols": [
    "EUR",
    "GBP"
  ]
}

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/fx/rates/latest" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "base": "USD",
  "symbols": [
    "EUR",
    "GBP"
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/fx/rates/historical$0.02 USDC

Get historical exchange rates

Retrieve exchange rates for a specific date from the Frankfurter API (ECB data). Returns rates for the closest working day.

Body

Field	Required	Notes
`date`	Yes	string; date
`base`	No	string
`symbols`	No	—

Request exampleJSON

{
  "date": "2024-01-01",
  "base": "USD",
  "symbols": [
    "EUR",
    "GBP"
  ]
}

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/fx/rates/historical" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "date": "2024-01-01",
  "base": "USD",
  "symbols": [
    "EUR",
    "GBP"
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/fx/rates/timeseries$0.05 USDC

Get timeseries exchange rates

Retrieve exchange rates over a date range from the Frankfurter API (ECB data). Returns rates for each working day in the range.

Body

Field	Required	Notes
`from`	Yes	string; date
`to`	Yes	string; date
`base`	No	string
`symbols`	No	—

Request exampleJSON

{
  "from": "2024-01-01",
  "to": "2024-01-05",
  "base": "USD",
  "symbols": [
    "EUR",
    "GBP"
  ]
}

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/fx/rates/timeseries" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "from": "2024-01-01",
  "to": "2024-01-05",
  "base": "USD",
  "symbols": [
    "EUR",
    "GBP"
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/fx/rates/convert$0.02 USDC

Convert currency amount

Convert an amount between currencies using delayed reference rates from the Frankfurter API (ECB data). Rates are not real-time market rates.

Body

Field	Required	Notes
`amount`	Yes	number
`from`	Yes	string
`to`	Yes	string
`date`	No	string; date

Request exampleJSON

{
  "amount": 100,
  "from": "USD",
  "to": "EUR"
}

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/fx/rates/convert" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "amount": 100,
  "from": "USD",
  "to": "EUR"
}
JSON

POSThttps://www.brainiac.software/api/v1/fx/currencies/list$0.01 USDC

List supported currencies

Retrieve the list of supported currencies from the Frankfurter API. All currencies are ISO 4217 codes.

Body

Send the JSON body shown in the request example.

Request exampleJSON

{}

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/fx/currencies/list" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{}
JSON