BOT (BOT_POLICY_RATE) Interest Rate

BOT (BOT_POLICY_RATE) Interest Rate

Shipping lending and treasury features often stalls on “where do we source a clean, up‑to‑date policy rate, and how do we wire it into code?” By the end of this article you will query the Bank of Thailand policy rate (BOT_POLICY_RATE), interpret dates and units, cache results safely, compute spreads and payment factors, and plug the data into dashboards, pricing models, or risk pipelines using seven GET endpoints from interestratesapi.com.

What the Bank of Thailand policy rate represents

BOT_POLICY_RATE is the Bank of Thailand’s main policy rate, the signal rate used by the central bank for monetary policy in Thailand (THB). It anchors short‑term funding costs and ripples into loans, deposits, and fixed‑income pricing. In the Interest Rates API, this symbol:

Illustration: BOT (BOT_POLICY_RATE) Interest Rate
  • Category: central_bank
  • Currency: THB
  • Frequency: monthly (effectively step‑wise across days; a given decision applies through the month until superseded)
  • Unit: percent per annum

Developers typically consume it to: power interest dashboards, set hurdle rates or pricing floors, drive scenario analysis, or benchmark Thai Baht product rates against central bank policy.

How the API expresses values and dates

The Interest Rates API returns rates as decimal percentages (e.g., 1.25 means 1.25% per annum) and includes a currency code per symbol. For monthly series like BOT_POLICY_RATE:

  • Latest endpoint returns the most recent published monthly value and its effective date.
  • Historical endpoint will align a requested date inside a month to the last day with data for that month.
  • Timeseries and OHLC re-express monthly data along a daily index; values remain constant across business days until a new decision is recorded.

Plan your caching around publication cadence: BOT decisions are not daily; daily polling can be cached for hours or a full business day unless you expect an announced policy meeting outcome. See endpoint-specific notes below.

Quick start: fetch the latest BOT policy rate

All endpoints are HTTP GET, under the base URL https://interestratesapi.com/api/v1/, and authenticate with an api_key query parameter.

Official latest example (copy/paste)

curl -s "https://interestratesapi.com/api/v1/latest?api_key=YOUR_API_KEY&symbols=BOT_POLICY_RATE"
{
    "success": true,
    "date": "2026-10-31",
    "base": "THB",
    "rates": {
        "BOT_POLICY_RATE": 1
    },
    "dates": {
        "BOT_POLICY_RATE": "2026-10-31"
    },
    "currencies": {
        "BOT_POLICY_RATE": "THB"
    },
    "base_filter_note": null
}

Field guide:

  • success: request status.
  • date: the API’s response date stamp.
  • rates: a map from symbol to numeric percent (per annum).
  • dates: per-symbol effective date (for monthly series, the date within the latest month with data).
  • currencies: per-symbol currency code (THB for BOT_POLICY_RATE).
  • base/base_filter_note: echo data about currency filtering when used.

Language snippets for latest

Python (requests):

import requests

url = 'https://interestratesapi.com/api/v1/latest'
params = dict(symbols='BOT_POLICY_RATE', api_key='YOUR_API_KEY')
resp = requests.get(url, params=params)
data = resp.json()

bot_rate = data['rates']['BOT_POLICY_RATE'] # percent p.a.
bot_effective_date = data['dates']['BOT_POLICY_RATE'] # YYYY-MM-DD
bot_currency = data['currencies']['BOT_POLICY_RATE'] # 'THB'

print(bot_rate, bot_effective_date, bot_currency)

JavaScript (fetch):

const response = await fetch(
'https://interestratesapi.com/api/v1/latest?symbols=BOT_POLICY_RATE&api_key=YOUR_API_KEY'
);
const data = await response.json();
const botRate = data.rates.BOT_POLICY_RATE;
const botDate = data.dates.BOT_POLICY_RATE;
const botCcy = data.currencies.BOT_POLICY_RATE;
console.log(botRate, botDate, botCcy);

PHP:

<?php
$url = 'https://interestratesapi.com/api/v1/latest?symbols=BOT_POLICY_RATE&api_key=YOUR_API_KEY';
$json = file_get_contents($url);
$data = json_decode($json, true);

$botRate = $data['rates']['BOT_POLICY_RATE'];
$botDate = $data['dates']['BOT_POLICY_RATE'];
$botCcy = $data['currencies']['BOT_POLICY_RATE'];

echo $botRate . " " . $botDate . " " . $botCcy;
?>

Explore the full API at interestratesapi.com. To start building, get your key here: Register.

Endpoint 1: /symbols — discover and filter available rates

Use this to confirm symbol codes, categories, base currencies, and frequencies. For BOT integration, you can filter by category=central_bank or by base=THB.

cURL

JSON example

Notes: symbols is an array; each item includes frequency and currency_code you should persist in your metadata store. For BOT, the symbol is BOT_POLICY_RATE and its frequency is monthly.

Python

import requests

resp = requests.get(
'https://interestratesapi.com/api/v1/symbols',
params=dict(category='central_bank', base='THB', api_key='YOUR_API_KEY')
)
symbols = resp.json()
print(symbols)

JavaScript

const res = await fetch(
'https://interestratesapi.com/api/v1/symbols?category=central_bank&base=THB&api_key=YOUR_API_KEY'
);
const symbols = await res.json();
console.log(symbols);

PHP

<?php
$url = 'https://interestratesapi.com/api/v1/symbols?category=central_bank&base=THB&api_key=YOUR_API_KEY';
echo file_get_contents($url);
?>

Endpoint 2: /latest — get the most recent BOT policy rate

Use this to display the current policy rate and to compute current‑period loan pricing or spreads against other benchmarks.

cURL

JSON example

Python

import requests
response = requests.get(
'https://interestratesapi.com/api/v1/latest',
params=dict(symbols='BOT_POLICY_RATE', api_key='YOUR_API_KEY')
)
data = response.json()
print(data['rates']['BOT_POLICY_RATE'], data['dates']['BOT_POLICY_RATE'])

JavaScript

const response = await fetch(
'https://interestratesapi.com/api/v1/latest?symbols=BOT_POLICY_RATE&api_key=YOUR_API_KEY'
);
const data = await response.json();
console.log(data.rates.BOT_POLICY_RATE, data.dates.BOT_POLICY_RATE);

PHP

<?php
echo file_get_contents('https://interestratesapi.com/api/v1/latest?symbols=BOT_POLICY_RATE&api_key=YOUR_API_KEY');
?>

Caching tip: For monthly series, cache the latest value for at least several hours or a business day. Refresh on known policy decision days or after the end of month.

Endpoint 3: /historical — value on a specific date

Request a date to backtest pricing or align to month‑end accounting. For monthly symbols, the API uses the last day with data within that month.

cURL

JSON example

Field notes: date echoes your request date; the rate returned corresponds to the applicable monthly value. If a 404 appears, inspect any details field for available ranges. Treat numeric values as percentages per annum.

Python

import requests

resp = requests.get(
'https://interestratesapi.com/api/v1/historical',
params=dict(date='2025-06-15', symbols='BOT_POLICY_RATE', api_key='YOUR_API_KEY')
)
print(resp.json())

JavaScript

const res = await fetch(
'https://interestratesapi.com/api/v1/historical?date=2025-06-15&symbols=BOT_POLICY_RATE&api_key=YOUR_API_KEY'
);
console.log(await res.json());

PHP

<?php
$url = 'https://interestratesapi.com/api/v1/historical?date=2025-06-15&symbols=BOT_POLICY_RATE&api_key=YOUR_API_KEY';
echo file_get_contents($url);
?>

Endpoint 4: /timeseries — build a range for charts and models

Pull a continuous series between two dates. For BOT_POLICY_RATE (monthly), the series will show daily entries repeating the monthly level across business days.

cURL

JSON example

Field notes: rates is a nested map of date to value; frequencies informs how to interpret sampling; currencies gives the currency per symbol. Use this to render charts or compute rolling changes.

Python

import requests

resp = requests.get(
'https://interestratesapi.com/api/v1/timeseries',
params=dict(start='2025-11-15', end='2026-11-15', symbols='BOT_POLICY_RATE', api_key='YOUR_API_KEY')
)
series = resp.json()
dates_values = series['rates']['BOT_POLICY_RATE']
print(list(dates_values.items())[:5])

JavaScript

const res = await fetch(
'https://interestratesapi.com/api/v1/timeseries?start=2025-11-15&end=2026-11-15&symbols=BOT_POLICY_RATE&api_key=YOUR_API_KEY'
);
const ts = await res.json();
console.log(Object.entries(ts.rates.BOT_POLICY_RATE).slice(0, 5));

PHP

<?php
$url = 'https://interestratesapi.com/api/v1/timeseries?start=2025-11-15&end=2026-11-15&symbols=BOT_POLICY_RATE&api_key=YOUR_API_KEY';
echo file_get_contents($url);
?>

Endpoint 5: /fluctuation — summary change stats over a window

This endpoint returns start/end values, absolute and percentage change, and observed high/low in the range. Ideal for performance tiles in dashboards.

cURL

JSON example

Field notes: change_pct is null only if start_value is zero (division by zero). Use this for alerting or compact summaries without pulling the full timeseries.

Python

import requests

resp = requests.get(
'https://interestratesapi.com/api/v1/fluctuation',
params=dict(start='2025-11-15', end='2026-11-15', symbols='BOT_POLICY_RATE', api_key='YOUR_API_KEY')
)
fx = resp.json()['rates']['BOT_POLICY_RATE']
print(fx['change'], fx['change_pct'], fx['high'], fx['low'])

JavaScript

const res = await fetch(
'https://interestratesapi.com/api/v1/fluctuation?start=2025-11-15&end=2026-11-15&symbols=BOT_POLICY_RATE&api_key=YOUR_API_KEY'
);
const data = await res.json();
const s = data.rates.BOT_POLICY_RATE;
console.log(s.change, s.change_pct, s.high, s.low);

PHP

<?php
$url = 'https://interestratesapi.com/api/v1/fluctuation?start=2025-11-15&end=2026-11-15&symbols=BOT_POLICY_RATE&api_key=YOUR_API_KEY';
echo file_get_contents($url);
?>

Endpoint 6: /ohlc — candlesticks for charting

Derive open-high-low-close per period from daily-level values. For BOT_POLICY_RATE, use monthly OHLC to visualize decision steps over time.

cURL

JSON example

Field notes: data_points is the count of daily observations included in the period; use it to annotate chart reliability or detect sparse windows.

Python

import requests

resp = requests.get(
'https://interestratesapi.com/api/v1/ohlc',
params=dict(symbols='BOT_POLICY_RATE', period='monthly', start='2025-11-15', end='2026-11-15', api_key='YOUR_API_KEY')
)
ohlc = resp.json()['rates']['BOT_POLICY_RATE']
print(ohlc[0]['period'], ohlc[0]['open'], ohlc[0]['close'])

JavaScript

const res = await fetch(
'https://interestratesapi.com/api/v1/ohlc?symbols=BOT_POLICY_RATE&period=monthly&start=2025-11-15&end=2026-11-15&api_key=YOUR_API_KEY'
);
const o = await res.json();
console.log(o.rates.BOT_POLICY_RATE[0]);

PHP

<?php
$url = 'https://interestratesapi.com/api/v1/ohlc?symbols=BOT_POLICY_RATE&period=monthly&start=2025-11-15&end=2026-11-15&api_key=YOUR_API_KEY';
echo file_get_contents($url);
?>

Endpoint 7: /convert — interest cost comparison across benchmarks

Compare simple loan interest cost using the latest rates from two symbols. This is useful to present “BOT vs. ECB” cost differences, or to compute a spread widget quickly.

cURL

JSON example

Field notes: total_interest is computed as a simple interest cost over term_months at the latest rate; difference.rate_spread is the arithmetic spread between the two latest rates.

Python

import requests

resp = requests.get(
'https://interestratesapi.com/api/v1/convert',
params=dict(from='BOT_POLICY_RATE', to='ECB_MRO', amount=250000, term_months=24, api_key='YOUR_API_KEY')
)
print(resp.json())

JavaScript

const url = 'https://interestratesapi.com/api/v1/convert?from=BOT_POLICY_RATE&to=ECB_MRO&amount=250000&term_months=24&api_key=YOUR_API_KEY';
const res = await fetch(url);
console.log(await res.json());

PHP

<?php
$url = 'https://interestratesapi.com/api/v1/convert?from=BOT_POLICY_RATE&to=ECB_MRO&amount=250000&term_months=24&api_key=YOUR_API_KEY';
echo file_get_contents($url);
?>

Interpreting publication frequency, business days, and caching

BOT_POLICY_RATE is monthly in the API. Practical implications:

  • Business days: Daily values within a month repeat the policy level; weekends/holidays are typically omitted from daily maps. Timeseries start/end bounds include only days with observations.
  • Caching: Cache /latest for a business day unless you anticipate a rate decision. Timeseries and OHLC can be cached for weeks; refresh at month‑end or after official meeting dates.
  • Backfills: Historical backfills may occur if source providers revise metadata; design idempotent loaders that tolerate unchanged re-ingest.

Always persist effective dates alongside values. If your logic keys accruals to month-end, use /historical with a billing cutoff date to ensure correct alignment.

Computing spreads and monthly payments safely

Rate spread from API responses

You can compute two common spreads:

  • Arithmetic spread: spread = rate_A − rate_B (both in percent p.a.).
  • Relative spread: rel_spread = (rate_A − rate_B) / rate_B, handling division-by-zero if rate_B is 0.

Use /latest for both symbols, or /convert which returns rate_spread directly for a pair.

Monthly payment using BOT_POLICY_RATE

Given a loan principal P, annual rate r_percent, and term in months n:

  • Convert to monthly rate: r_m = (r_percent / 100) / 12.
  • Amortized payment: payment = P × r_m × (1 + r_m)^n / [(1 + r_m)^n − 1].
  • For simple interest (non-amortizing), monthly interest = P × r_m; total interest over n months = n × P × r_m.

Use the returned BOT_POLICY_RATE as r_percent. Persist the effective date to document which policy decision underpins your calculation window.

Error handling and rate limiting

Common error shapes are predictable; always branch on success and inspect HTTP status codes:

  • 401: Missing/invalid api_key.
  • 403: Account not active.
  • 404: No symbols matched or no data for requested range (may include details with available date ranges).
  • 422: Validation error (date format, invalid symbol).
  • 429: Quota exhausted — read Retry-After and X-RateLimit-* headers to back off and retry.

Recoverable errors (404, 422) should surface actionable messages in UI. For 429, implement exponential backoff aligned to the Reset timestamp.

Real-world uses for BOT_POLICY_RATE

  • Interest rate dashboards: show current BOT policy and a sparkline of changes via /timeseries or /ohlc.
  • Loan pricing: compute BOT-linked floors or BOT plus spread for Thai Baht facilities using /latest and your pricing logic.
  • Macro research: feature tiles summarizing monthly changes via /fluctuation, and export clean CSVs built from /timeseries.
  • Risk and ALM: backtest sensitivity to policy steps, pulling historical end-of-month levels via /historical.
  • Comparative analytics: contrast BOT vs. other policy rates using /convert rate_spread for quick decision support.

For schema and operational details, see the reference at MCP. When you’re ready to build, Register for an API key.

End-to-end example: from discovery to decision tile

  1. Confirm availability: call /symbols with category=central_bank and base=THB; assert BOT_POLICY_RATE exists and note frequency=monthly.
  2. Fetch current level: call /latest for BOT_POLICY_RATE; cache for a business day.
  3. Render context: call /fluctuation for the past 6–12 months to show change, high, low, and change_pct.
  4. Chart history: call /ohlc with period=monthly for the past 24 months, and surface data_points per bar.
  5. Benchmark: call /convert to show how BOT-linked cost compares to an alternative (e.g., ECB_MRO) for a notional amount and term.

This pipeline supports a compact “policy rate card” in a treasury app with minimal latency and predictable caching.

FAQ

Is BOT_POLICY_RATE returned as a percent or decimal?
Percent per annum (e.g., 1 means 1.00% p.a.). Convert to monthly by dividing by 12 and by 100 when computing interests.

What date should I display to end users?
Use dates.BOT_POLICY_RATE from /latest. For historical backtests, rely on your requested date and the returned value which aligns to the correct month’s last available day.

How often should I poll for BOT decisions?
Monthly cadence suffices for most apps. Consider refreshing after scheduled BoT meeting announcements. Between meetings, cache for hours or a full business day.

Can I combine BOT_POLICY_RATE with interbank rates in one call?
Yes. /latest, /historical, /timeseries, /fluctuation, and /ohlc accept comma-separated symbols. The response includes per-symbol currencies and, where applicable, per-symbol frequencies.

What’s the easiest way to get a cost differential?
Use /convert with from=BOT_POLICY_RATE and to=AnotherSymbol. It returns rate_spread and simple total_interest comps at the latest rates.

Build your BOT policy rate integration now. Get an API key with a quick signup: Register. Explore endpoints and schema on interestratesapi.com and the MCP.

Ready to get started?

Get your API key and start validating bank data in minutes.

Get API Key