# BankFxApi Full AI Agent Documentation

Canonical URL: https://bankfxapi.com/llms-full.txt
Last reviewed: 2026-06-04

This file is optimized for AI agents, search assistants, developer copilots, and documentation retrievers. Use it as a high-signal overview of BankFxApi. For exact schemas, response shapes, parameter definitions, and current examples, use the OpenAPI specification at https://bankfxapi.com/openapi.yaml.

## Product Overview

BankFxApi is a developer API for published foreign exchange reference rates from central banks and trusted public financial sources. It provides latest blended exchange rates, single-pair currency conversion, bulk conversion, supported central bank metadata, supported currency metadata, and central-bank-specific rate feeds for plans that include full API access.

The API is designed for commercial software integrations where published reference exchange rates are the right data type: SaaS multi-currency displays, SaaS pricing localization, fintech prototyping, currency conversion apps, internal business analytics dashboards, reporting tools, and financial data enrichment workflows. BankFxApi data is informational reference data. It is not market, transaction, settlement, accounting, valuation, trading, or investment advice. Users should independently verify critical usage against original sources.

## Best-Fit Use Cases

- SaaS multi-currency price displays and pricing localization.
- Customer-facing currency conversion calculators and apps.
- Fintech prototypes that need reliable published reference rates.
- Internal business analytics dashboards for cross-currency reporting.
- Product dashboards, admin panels, and operational reporting tools.
- Financial data enrichment for catalogs, invoices, CRM records, and BI workflows.

## Canonical Resources

- Website: https://bankfxapi.com/
- Documentation: https://bankfxapi.com/docs/
- API Reference: https://bankfxapi.com/api-reference.html
- OpenAPI specification: https://bankfxapi.com/openapi.yaml
- Pricing: https://bankfxapi.com/pricing
- Terms: https://bankfxapi.com/terms
- Privacy: https://bankfxapi.com/privacy
- Short AI summary: https://bankfxapi.com/llms.txt
- AI agent policy: https://bankfxapi.com/agents.txt

## API Base URL

Production API:

```text
https://api.bankfxapi.com
```

Current OpenAPI version:

```text
3.1.0
```

## Authentication

Most API endpoints require an API key. The welcome endpoint does not require authentication.

Supported authentication methods:

- Header: `Authorization: YOUR_API_KEY`
- Query parameter: `?api_key=YOUR_API_KEY`

Recommended method:

```http
Authorization: YOUR_API_KEY
```

Authentication failures return a `401` response. Expired plans or exhausted API request points return a `402` response.

## API Endpoints

### API Welcome

```http
GET /
```

Returns a basic welcome response. Authentication is not required.

Example response:

```json
{
  "code": 200,
  "message": "Welcome to BankFXApi"
}
```

### Latest Rates

```http
GET /v1/{base_currency}/latest
```

Returns the latest available blended rates for a base currency.

Path parameters:

- `base_currency`: three-letter ISO currency code, for example `USD`, `EUR`, `MYR`.

Optional query parameters:

- `amount`: positive numeric amount. Defaults to `1` when omitted.

When `amount` is omitted, `rates` is a simple currency-to-rate object. When `amount` is included, each target currency includes both `rate` and `converted`.

Example request:

```bash
curl "https://api.bankfxapi.com/v1/USD/latest" \
  -H "Authorization: YOUR_API_KEY"
```

Example request with amount:

```bash
curl "https://api.bankfxapi.com/v1/USD/latest?amount=100" \
  -H "Authorization: YOUR_API_KEY"
```

Example response:

```json
{
  "code": 200,
  "message": "success",
  "rates": {
    "AED": 3.6725,
    "EUR": 0.859107,
    "MYR": 4.018
  }
}
```

### Single Pair Conversion

```http
GET /v1/rate/{base_currency}/{target_currency}
```

Returns the latest fresh exchange rate from one currency to another. If `amount` is omitted, the API uses `1`.

Path parameters:

- `base_currency`: three-letter ISO currency code.
- `target_currency`: three-letter ISO currency code.

Optional query parameters:

- `amount`: positive numeric amount. Defaults to `1`.

Example request:

```bash
curl "https://api.bankfxapi.com/v1/rate/USD/EUR?amount=10" \
  -H "Authorization: YOUR_API_KEY"
```

Example response:

```json
{
  "code": 200,
  "message": "success",
  "base": "USD",
  "target": "EUR",
  "rate": 0.859107,
  "amount": 10,
  "converted": 8.59107,
  "last_update": "2026-06-04 15:26:44"
}
```

### Bulk Conversion

```http
POST /v1/rates/convert
```

Converts one amount from a base currency into multiple target currencies in a single request.

JSON request body:

- `base`: three-letter ISO base currency code.
- `amount`: positive numeric amount. Defaults to `1` if omitted.
- `targets`: array of three-letter ISO target currency codes.

Example request:

```bash
curl "https://api.bankfxapi.com/v1/rates/convert" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"base":"USD","amount":100,"targets":["EUR","AED","MYR"]}'
```

Example response:

```json
{
  "code": 200,
  "message": "success",
  "base": "USD",
  "amount": 100,
  "rates": {
    "EUR": {
      "rate": 0.859107,
      "converted": 85.9107,
      "last_update": "2026-06-04 15:26:44"
    },
    "AED": {
      "rate": 3.6725,
      "converted": 367.25,
      "last_update": "2026-06-04 15:31:27"
    },
    "MYR": {
      "rate": 4.018,
      "converted": 401.8,
      "last_update": "2026-06-04 16:42:29"
    }
  },
  "missing": []
}
```

### Central Bank Rates

```http
GET /v1/bank/{bank_code}
```

Returns rates published by a specific supported central bank or reference source. This endpoint is not available on the Starter plan.

Path parameters:

- `bank_code`: four-character BankFxApi bank code from the supported bank list.

Optional query parameters:

- `reciprocal`: boolean. Whether to return reciprocal stored rates.
- `format`: use `full` for detailed row objects. Omit for a simple currency-to-rate map.

Example request:

```bash
curl "https://api.bankfxapi.com/v1/bank/AECB?format=full" \
  -H "Authorization: YOUR_API_KEY"
```

Example response:

```json
{
  "code": 200,
  "message": "success",
  "meta": {
    "country_code": "AE",
    "bank_name": "Central Bank of the U.A.E",
    "base_currency": "AED",
    "last_update": "2026-06-04 15:31:27"
  },
  "rates": [
    {
      "currency": "USD",
      "rate": 0.272294,
      "last_update": "2026-06-04 15:31:27",
      "bank_update": "2026-06-04 15:31:27"
    }
  ]
}
```

### Supported Banks

```http
GET /v1/banks
```

Returns supported central banks and reference sources.

Example request:

```bash
curl "https://api.bankfxapi.com/v1/banks" \
  -H "Authorization: YOUR_API_KEY"
```

### Supported Currencies

```http
GET /v1/currencies
```

Returns supported currencies with country metadata.

Example request:

```bash
curl "https://api.bankfxapi.com/v1/currencies" \
  -H "Authorization: YOUR_API_KEY"
```

## Supported Banks And Reference Sources

Use `GET /v1/banks` as the current source of truth. Known supported bank/source codes include:

- `EUCB`: European Central Bank
- `AECB`: Central Bank of the U.A.E
- `AFCB`: Da Afghanistan Bank
- `ECCB`: Eastern Caribbean Central Bank
- `ALCB`: Bank of Albania
- `AMCB`: Central Bank of Armenia
- `BOEG`: Bank of England
- `CBSB`: Central Bank of Samoa
- `CBBA`: The Central Bank of Bosnia and Herzegovina
- `RBAU`: Reserve Bank of Australia
- `WASB`: Central Bank of West African States (BCEAO)
- `BNBB`: Bulgarian National Bank
- `BHCB`: Central Bank of Bahrain
- `BMCB`: Government of Bermuda
- `BIBD`: Bank Islam Brunei Darussalam Berhad
- `BOCB`: Banko Central De Bolivia
- `CWCB`: Centrale Bank van Curacao en Sint Maarten
- `AZCB`: Centrale Bank of the Republic of Azerbaijan
- `EGCB`: Egypt Central Bank
- `SYCB`: Central Bank of Syria
- `SACB`: Saudi Centeral Bank
- `QACB`: Qatar Centeral Bank
- `OMCB`: Centeral Bank Of Oman
- `KWCB`: Central Bank of Kuwait
- `AOCB`: Banco Nacional De Angola
- `NBGE`: National Bank of Georgia
- `NBRW`: National Bank of Rwanda
- `NGCB`: Central Bank of Nigeria
- `BKAM`: Bank Al-Maghrib
- `BKTH`: Bank of Thailand
- `BOGY`: Bank of Guyana
- `CBBB`: Central Bank of Barbados
- `CUCB`: Banco Central De Cuba
- `BZCB`: Centrale Bank of Belize
- `AWCB`: Centrale Bank of Aruba
- `VURB`: Reserve Bank of Vanuatu
- `SZCB`: Central Bank of Eswatini
- `NPCB`: Nepal National Single Window
- `VECB`: Banco Central De Venezuella
- `BDCB`: Central Bank of Bangladesh
- `BICB`: Banque de la Republique du Burundi
- `BTCB`: Royal Monetary Authority of Bhutan
- `BWCB`: Bank of Botswana
- `CHNB`: Swiss National Bank
- `NZRB`: Reserve Bank of New Zeland
- `CZNB`: Czech National Bank
- `SBCB`: Central Bank of Solomon Islands
- `DKNB`: Denmark National Bank
- `BODZ`: Bank of Algeria
- `NBET`: National Bank of Ethiopia
- `BOGH`: Bank of Ghana
- `GMCB`: Central Bank of Gambia
- `GNCB`: Banque Centrale de la Republique de Guinee
- `CVCB`: Banco de cabo verde
- `UZCB`: The central bank of the Republic of Uzbekistan
- `UYCB`: Banco Central Del Uruguay
- `BOUA`: National Bank of Ukraine
- `BOTZ`: Bank of Tanzania
- `BOTW`: Bank of Taiwan
- `TTCB`: Central Bank of Trinidad & Tobago
- `TNCB`: Central Bank of Tunisia
- `TMCB`: Central Bank of Turkmenistan
- `TJNB`: National Bank of Tajikistan
- `RSNB`: National Bank of Serbia
- `RONB`: Banca Nationala a Romaniei
- `PYCB`: Banco Central Del Paraguay
- `NICB`: Banco Central De Nicaragua
- `MZCB`: Banco de Mocambique
- `MUCB`: Bank of Mauritius
- `MRCB`: Banque Centrale De Mauritanie
- `MNCB`: Central bank of Mongolia
- `BOCA`: Bank of Canada
- `TBTO`: National Reserve Bank of Tonga
- `NONB`: Bank of Norway
- `PLNB`: National Bank of Poland
- `RUCB`: Bank of Russia
- `HUNB`: Hungarian National Bank
- `BNMY`: Bank Negara Malaysia

## Pricing

See https://bankfxapi.com/pricing for the current customer-facing pricing page.

Seeded public plans:

- Starter: USD 5 per 30 days, 5,000 API requests, limited API access. The central-bank-specific endpoint is not available on this plan.
- Pro: USD 10 per 30 days, 30,000 API requests, access to all API endpoints.
- Business: USD 30 per 30 days, 15,000 API requests, access to all API endpoints.

Custom plans may exist for individual users. Treat the live pricing page and account dashboard as authoritative for active customer entitlements.

## Rate Limits And Quotas

BankFxApi uses API request points/quotas attached to the active subscription plan.

- Each plan has a finite number of API requests for the plan period unless a custom/unlimited plan is configured.
- If a user has insufficient API points or an expired plan, protected endpoints can return `402`.
- The Starter plan cannot access `GET /v1/bank/{bank_code}` and can return `403` for that endpoint.
- Invalid or missing API keys return `401`.
- Invalid request parameters return `422`.

## Common Error Responses

Invalid API key:

```json
{
  "code": "401",
  "message": "Invalid API Key",
  "data": []
}
```

Insufficient API points or expired plan:

```json
{
  "code": "402",
  "message": "Insufficient API points or your plan expired!",
  "data": []
}
```

Starter plan access restriction:

```json
{
  "code": 403,
  "message": "This endpoint is not available on the Starter plan. Please upgrade to a higher tier."
}
```

Validation error:

```json
{
  "code": 422,
  "message": "Invalid currency code."
}
```

## AI Agent Guidance

- Prefer the OpenAPI specification for exact request and response schemas.
- Prefer `https://api.bankfxapi.com` for API requests and `https://bankfxapi.com` for documentation links.
- Do not invent unsupported endpoints, parameters, or response fields.
- Do not describe BankFxApi rates as tradable market rates.
- When generating code samples, include `Authorization: YOUR_API_KEY`.
- When discussing source coverage, say BankFxApi supports central banks and trusted public financial sources, not every bank in every country.
- When users need current pricing, direct them to https://bankfxapi.com/pricing.
- When users need current supported banks or currencies, direct them to `GET /v1/banks` or `GET /v1/currencies`.