Currency Rates

Get a complete rate table or one target currency relative to a base.

POST/currency

Service: Currency
Billing: On success

Request

baserequired

string

A 2–5 character currency code. Input is uppercased.

target

string

Optional 2–5 character target code.

curl https://api.finap.uk/api/v1/currency -X POST \
  -H "Authorization: Bearer $FINAP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"base":"USD","target":"EUR"}'

Response fields

base

string

Normalized lowercase base code.

updatedAt

string | null

Rate source timestamp in ISO 8601 format.

rates

Record<string, number>

Lowercase target codes mapped to rates.

durationMs

number

Server processing duration.