Commercial bank buy/sell board rates
get_bank_ratesRetail buy and sell rates a commercial bank displays on its own website (e.g. SBI's TT buying rate, an Emirates NBD or HSBC Hong Kong board), read hourly.
Instructions
Retail buy and sell rates a commercial bank displays on its own website (e.g. SBI's TT buying rate, an Emirates NBD or HSBC Hong Kong board), read hourly. Use for 'what rate does bank X give for USD today?', remittance comparisons between banks in one country, or rules that name a bank's card rate (India Income-tax Rule 115 uses SBI's TT buying rate). These are bank prices, NOT official or mid-market rates: for those use get_official_rates or get_exchange_rate. Give country alone for every covered bank there, or add bank for one board; ccy narrows one bank to a currency and date returns the stored board for a past day. Covers 1,200+ commercial banks in 120+ countries (ae, lk, in, pk, bd, np, vn, id, ph, am, az, ge, kz, tw, jp, kr, hk, cn, au, cz, pl, hu, tr, eg, za, ke, us); codes are listed at https://allratestoday.com/bank-exchange-rate-api/. Requires ALLRATES_API_KEY (the free key works).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"country": "<country>"
},
"name": "get_bank_rates"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ccy | No | Narrow one bank's board to a single currency, e.g. 'USD'. Needs `bank`. | |
| bank | No | Bank code within the country, e.g. 'sbi', 'fab', 'hsbchk'. Omit for every covered bank. | |
| date | No | Stored board for a past day, YYYY-MM-DD (kept about 400 days). Needs `bank`. | |
| country | Yes | Two-letter country code, e.g. 'in', 'ae', 'hk'. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| buy | No | One currency: what the bank pays per unit | |
| ccy | No | ||
| bank | No | ||
| name | No | ||
| sell | No | One currency: what the bank charges per unit | |
| banks | No | Every covered bank (country call) | |
| basis | No | Which board this is, e.g. Telegraphic transfer | |
| rates | No | One bank: its board | |
| country | Yes | ||
| quote_ccy | Yes | Home currency every rate is quoted in | |
| disclaimer | No | ||
| captured_at | No | ||
| snapshot_date | No | ||
| bank_updated_at | No | The bank's own last-updated stamp |