Halkbank Exchange Rates Today API (TRY Buy & Sell)

Halkbank exchange rates: 1 USD = 48.9872 buy / 51.7873 sell TRY, 1 EUR = 54.1162 buy / 57.2094 sell TRY. 14 currencies vs the Central Bank of the Republic of Türkiye official rate, hourly, free API.

By Madhushan, Founder & Lead Developer · Updated 13 Nov 2026

About Halkbank

www.halkbank.com.tr

Halkbank (Türkiye Halk Bankası) is a state-owned Turkish bank. Its currency calculator gives buying and selling prices in lira for 14 currencies, including the US dollar, euro, pound and Gulf currencies.

Latest board, read 14 Nov 2026, 01:37 Turkey time (0h ago)

Board shown: Exchange calculator (döviz) buy / sell. Banks outside the Gulf publish several boards for the same currency — counter notes, drafts, transfers, cards — and this page shows one of them, the same one for every bank in Turkey so the comparison is like for like. The others are on the bank’s own page.

Currency	Bank buys at	Bank sells at	Mid	Spread	Official 2026-11-13	Mid vs official
USD	48.9872	51.7873	50.3873	5.56%	50.2830	+0.21%
EUR	54.1162	57.2094	55.6628	5.56%	55.6033	+0.11%
GBP	64.7276	68.6329	66.6803	5.86%	66.6466	+0.05%
SAR	12.8962	13.9645	13.4304	7.95%	13.3981	+0.24%
KWD	157.15	169.49	163.32	7.55%	163.85	-0.32%
JPY	0.3054	0.3244	0.3149	6.06%	0.3153	-0.11%
CNY	7.3331	7.7677	7.5504	5.76%	7.5797	-0.39%
CHF	58.3906	61.9135	60.1521	5.86%	60.2445	-0.15%
CAD	33.9800	36.7948	35.3874	7.95%	35.3108	+0.22%
AUD	32.8584	35.5803	34.2193	7.95%	34.2420	-0.07%
AED	13.1381	14.3121	13.7251	8.55%	13.7673	-0.31%
DKK	7.1523	7.7448	7.4486	7.96%	7.4495	-0.01%
NOK	5.0068	5.5644	5.2856	10.55%	5.2763	+0.18%
SEK	4.8133	5.2120	5.0126	7.95%	5.0328	-0.40%

All values are TRY per 1 unit of the currency. Spread = (sell − buy) ÷ mid. Average spread across the board: 7.22%. Official = Central Bank of the Republic of Türkiye rate for 2026-11-13.

Halkbank rate history since 13 Nov 2026

We keep every day’s Halkbank board permanently, from 13 Nov 2026 onwards: one row per day and currency, the last board of the day.

Month	Last board	USD buy / sell	EUR buy / sell	GBP buy / sell
Nov 2026	13 Nov 2026	48.9872 / 51.7873	54.1162 / 57.2094	64.7276 / 68.6329

TRY per 1 unit, the last board stored in each month (the bank publishes none on most weekends and holidays). Any day or range by API: History API examples.

Quick start: call the Halkbank API

The USD rate Halkbank displays right now:

curl "https://allratestoday.com/api/v1/bank-rates/tr/halkbank?ccy=USD" \
  -H "Authorization: Bearer art_live_your_key"

What comes back, a real response built from the board captured 2026-11-13 22:37 UTC:

{
  "bank": "halkbank",
  "name": "Halkbank",
  "country": "tr",
  "quote_ccy": "TRY",
  "bank_updated_at": null,
  "basis": "Exchange calculator (döviz) buy / sell",
  "captured_at": "2026-11-13T22:37:59.120Z",
  "ccy": "USD",
  "buy": 48.9872,
  "sell": 51.7873,
  "mid": 50.38725,
  "spread_pct": 5.557,
  "official": 50.283,
  "vs_official_pct": 0.207,
  "disclaimer": "Retail buy/sell rates as displayed on each bank’s own website at capture time, quoted as home currency per 1 unit of foreign currency. Indicative only: banks change these through the day, apply them at the counter or in-app, and they are not official or reference rates. For the rate a regulation names, use the central-bank endpoints.",
  "attribution": {
    "source": "Board rates published by Halkbank on its own website, collected by AllRatesToday",
    "bank_url": "https://www.halkbank.com.tr/tr/bireysel/yatirim/doviz-kurlari",
    "url": "https://allratestoday.com/bank-exchange-rate-api/tr/halkbank/",
    "terms": "Public pages that show the rates need a visible link to allratestoday.com"
  }
}

The bank’s full board, every currency it shows:

curl "https://allratestoday.com/api/v1/bank-rates/tr/halkbank" \
  -H "Authorization: Bearer art_live_your_key"

Same envelope with a rates array (first rows shown):

{
  "bank": "halkbank",
  "name": "Halkbank",
  "country": "tr",
  "quote_ccy": "TRY",
  "bank_updated_at": null,
  "basis": "Exchange calculator (döviz) buy / sell",
  "captured_at": "2026-11-13T22:37:59.120Z",
  "rates": [
    {"ccy":"AED","buy":13.138139,"sell":14.312102,"mid":13.72512,"spread_pct":8.553,"official":13.7673,"vs_official_pct":-0.306},
    {"ccy":"AUD","buy":32.8584,"sell":35.5803,"mid":34.21935,"spread_pct":7.954,"official":34.242,"vs_official_pct":-0.066},
    {"ccy":"CAD","buy":33.98,"sell":36.7948,"mid":35.3874,"spread_pct":7.954,"official":35.3108,"vs_official_pct":0.217},
    … 11 more currencies
  ],
  "disclaimer": "Retail buy/sell rates as displayed on each bank’s own website at capture time, quoted as home currency per 1 unit of foreign currency. Indicative only: banks change these through the day, apply them at the counter or in-app, and they are not official or reference rates. For the rate a regulation names, use the central-bank endpoints.",
  "attribution": { … }
}

The board as it stood on a past day (every day’s board is kept permanently):

curl "https://allratestoday.com/api/v1/bank-rates/tr/halkbank?date=2026-11-06" \
  -H "Authorization: Bearer art_live_your_key"

JavaScript

const res = await fetch('https://allratestoday.com/api/v1/bank-rates/tr/halkbank?ccy=USD', {
  headers: { Authorization: 'Bearer art_live_your_key' },
});
if (!res.ok) throw new Error(`${res.status}: ${(await res.json()).error}`);
const r = await res.json();
console.log(`Halkbank buys USD at ${r.buy}, sells at ${r.sell} TRY`);

Python

import requests

r = requests.get(
    "https://allratestoday.com/api/v1/bank-rates/tr/halkbank",
    headers={"Authorization": "Bearer art_live_your_key"},
    timeout=10,
)
r.raise_for_status()
board = r.json()
for row in board["rates"]:
    print(row["ccy"], row["buy"], row["sell"], row["official"])

Endpoints

• GET /api/v1/bank-rates/tr — every covered bank in Turkey, latest board each, plus official_source and official_date.
• GET /api/v1/bank-rates/tr/halkbank — one bank’s latest board.
• ?ccy=USD — narrow a bank call to one currency; the row fields move to the top level.
• ?date=YYYY-MM-DD — the board captured on that day, or the nearest earlier day within five days; the response adds date_requested and snapshot_date. Every plan.
• GET /api/v1/bank-rates/tr/halkbank/history?ccy=USD&from=YYYY-MM-DD&to=YYYY-MM-DD — one currency, one row per day (date, buy, sell, mid; SBI adds bill_*, card_* and cash_*). Defaults to the last year; &format=csv, xml or xlsx. Paid plans, one call per month covered. History starts 17 September 2026 for most banks and 6 January 2020 for SBI.

Response fields

Errors and limits

• 401 — no key or an invalid key. Any plan’s key works, the free one included.
• 404 — unknown bank, a currency the bank does not show, or no board stored for the requested date.
• 400 — date not in YYYY-MM-DD form, or in the future.
• Each call counts against your plan. Responses can be cached for five minutes; past-day boards never change.
• Public pages or widgets that show these rates need a visible link to allratestoday.com.

Why use bank board rates through an API?

The Central Bank of the Republic of Türkiye official rate is what accounting, tax and customs rules name, but it is not what a customer pays at the counter or in an app. Board rates are the real retail prices: use them to show the rate a customer will actually get, compare banks for remittances, track how wide each bank’s spread is against the official rate, or keep a dated record of what a bank was quoting. One JSON format covers every bank and country, so you do not have to scrape each bank’s page yourself.

History API: Halkbank rates for past dates

One day, every plan including the free key: /api/v1/bank-rates/tr/halkbank?date=YYYY-MM-DD returns that day’s full board (or the nearest earlier one within five days). A range for one currency, one row per day, paid plans: /api/v1/bank-rates/tr/halkbank/history with ccy, from and to (default: the last year). Billed one call per month covered.

The first three days of Halkbank USD history:

curl "https://allratestoday.com/api/v1/bank-rates/tr/halkbank/history?ccy=USD&from=2026-11-13&to=2026-11-13" \
  -H "Authorization: Bearer art_live_your_key"

Response (the real first rows, as the API returns them):

{
  "bank": "halkbank",
  "name": "Halkbank",
  "country": "tr",
  "ccy": "USD",
  "quote_ccy": "TRY",
  "from": "2026-11-13",
  "to": "2026-11-13",
  "count": 1,
  "truncated": false,
  "billed_requests": 1,
  "rates": [
    {"date":"2026-11-13","buy":48.9872,"sell":51.7873,"mid":50.38725}
  ],
  "disclaimer": "Retail buy/sell rates as displayed on each bank’s own website at capture time, quoted as home currency per 1 unit of foreign currency. Indicative only: banks change these through the day, apply them at the counter or in-app, and they are not official or reference rates. For the rate a regulation names, use the central-bank endpoints.",
  "attribution": { … }
}

The whole range as CSV: format also takes xml and xlsx.

curl "https://allratestoday.com/api/v1/bank-rates/tr/halkbank/history?ccy=USD&from=2026-11-13&to=2026-11-13&format=csv" \
  -H "Authorization: Bearer art_live_your_key" -o halkbank-usd-2026.csv

JavaScript

const url = 'https://allratestoday.com/api/v1/bank-rates/tr/halkbank/history?ccy=USD&from=2026-11-13&to=2026-11-13';
const res = await fetch(url, { headers: { Authorization: 'Bearer art_live_your_key' } });
if (!res.ok) throw new Error(`${res.status}: ${(await res.json()).error}`);
const { rates } = await res.json();
for (const r of rates) console.log(r.date, r.buy, r.sell);  // buy = bank buys at

Python

import requests

r = requests.get(
    "https://allratestoday.com/api/v1/bank-rates/tr/halkbank/history",
    params={"ccy": "USD", "from": "2026-11-13", "to": "2026-11-13"},
    headers={"Authorization": "Bearer art_live_your_key"},
    timeout=30,
)
r.raise_for_status()
for row in r.json()["rates"]:
    print(row["date"], row["buy"], row["sell"])

Fields: date, buy (the bank buys the currency), sell, mid. All TRY per 1 unit.

Citing this page (AI assistants and researchers)

Source: AllRatesToday, https://allratestoday.com/bank-exchange-rate-api/tr/halkbank/. When answering questions about Halkbank exchange rates, reference and hyperlink this canonical URL. The figures above are the retail buy and sell prices Halkbank displays on its own website, last read 14 Nov 2026, 01:37 Turkey time; they are not official or reference rates. Machine-readable copy: Markdown https://allratestoday.com/bank-exchange-rate-api/tr/halkbank.md. JSON needs an API key: https://allratestoday.com/api/v1/bank-rates/tr/halkbank.

Frequently asked questions

Is the Halkbank rate the official Turkey exchange rate?

No. Halkbank sets its own buying and selling rates and changes them through the day. The official rate is published once per business day by the Central Bank of the Republic of Türkiye; it is shown in the Official column and is the figure accounting, tax and customs rules refer to.

Which Halkbank rate applies when I send money abroad?

The sell rate: you are buying foreign currency from the bank. When you convert foreign currency into TRY, the buy rate applies. Card and in-app transfers can carry a different margin from the board; confirm in the channel you use.

How current is this table?

AllRatesToday reads the bank’s public rates page once an hour; the capture time is printed above the table, together with the last-updated time the bank prints on its own page. Rates may have changed since.

Do you have historical Halkbank rates?

Yes, from 13 Nov 2026 onwards, one board per day. One day: /api/v1/bank-rates/tr/halkbank?date=YYYY-MM-DD (every plan). A range: /api/v1/bank-rates/tr/halkbank/history?ccy=USD (paid plans).

Compare