Skip to content
TurkpidyaOpen data for Türkiye Try the data
A little Türkiye. A lot you can build.

Türkiye’s data.
Your next idea.

Bring Türkiye into your next idea. Get exchange rates, gold prices, prayer times and more through a simple web link.

For your app, your website, or your very first experiment. We’ll show you how it works.

Let’s try it What’s an API, anyway?
Free to use No account No API key
Many pieces of Türkiye. One simple connection.
Information with a source.TCMBHarem AltınKandilliEPDKAladhanSee what’s included
The simple version

A web link goes in.
Useful information comes out.

An API is just a way for programs to share information. You ask for something. It sends back an answer your app can read.

1
“What’s the dollar rate?”

Choose your question

Each topic has its own web address. Pick the information you want to use.

2
/fx/USD

Open its link

Try it in your browser or let your program ask. No login or secret key needed.

3
currencyTRYthe labelthe answer

Use the answer

You get labelled text called JSON. Your app can turn it into something useful.

Your first request

Don’t just read about it.
Try it for yourself.

Pick a topic, then ask for the data. Switch between a friendly explanation and the exact answer a program receives.

Exchange rates

How much is a dollar in lira?

Official lira exchange rates for dollars, euros and other currencies. Useful for a travel budget or an invoice.

This makes a real, read-only request.

Where it comes fromTCMB, Türkiye’s central bank
Ready when you are

Your answer lands here.

Press “Get the data” to see what comes back.
No setup. No code. Just try it.

GEThttps://turkpidya.com/wp-json/turkpidya-data/v1/fx/USD

Ready to put it in your project?

This code asks the same question as the explorer above. If a browser blocks a request from your own website, run it on your server.

const response = await fetch('https://turkpidya.com/wp-json/turkpidya-data/v1/fx/USD');
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);
The data collection

Six ways to start something.

A price board. A travel tool. A more helpful assistant. Start with the information your idea needs.

Exchange rates

Official lira exchange rates for dollars, euros and other currencies. Useful for a travel budget or an invoice.

TCMB, Türkiye’s central bank
Addresses & details
GET /fxGET /fx/{currency}
currency
A three-letter currency code in the address, such as USD or EUR. Leave it out to see all currencies.

Update schedule: Each business day
Reuse an answer for: 1 hour

These are central-bank reference rates. A bank or exchange office may offer a different rate.

Open this API address

Gold & silver

Gold by weight and purity, familiar Turkish gold coins, and silver. A starting point for a price board or savings tracker.

Harem Altın
Addresses & details
GET /gold
category
Choose all, gram, coin or silver. The default is all.

Update schedule: Expected every 5 minutes
Reuse an answer for: 5 minutes

Buy and sell are separate prices. All amounts are in Turkish lira; check the record date before using them.

Open this API address

Prayer times

Daily prayer times for supported Turkish cities, including dawn, noon and sunset. Useful for a calendar or reminder.

Aladhan, using the Diyanet calculation method
Addresses & details
GET /prayer-timesGET /prayer-times/cities
city
Required city name in the URL, such as istanbul, ankara or izmir. The cities route lists supported names.
date
Optional date as YYYY-MM-DD. Leave it out for today in Istanbul time.

Update schedule: For the requested day
Reuse an answer for: Up to 24 hours

Calculated times may differ from a local mosque’s timetable. Some dates may not be available.

Open this API address

Fuel prices

Reported petrol and diesel prices by city. Useful for estimating a trip or comparing running costs.

EPDK distributor reports
Addresses & details
GET /fuel
city
Optional: istanbul, ankara, izmir or antalya. Leave it out for all available cities.

Update schedule: Expected every 6 hours
Reuse an answer for: 1 hour

The answer gives city averages, not a guaranteed price at a particular station. A fuel type can be missing.

Open this API address

Earthquakes

Reported earthquakes in and around Türkiye, with location, magnitude and depth. Useful for a map or research dashboard.

Kandilli Observatory (KOERI)
Addresses & details
GET /earthquakesGET /earthquakes/latest
hours
Look back 1–168 hours. The default is 24.
min_magnitude
Only show events at or above this magnitude. Default: 0.
city
Optional text to match in the location, such as balikesir.
limit
Return 1–100 events. The default is 20.

Update schedule: Expected every 5 minutes
Reuse an answer for: 5 minutes

This is a record of reported events, not an emergency alert service. An empty answer does not prove no earthquake occurred.

Open this API address

Medicine lookup

Look up a foreign medicine name or active ingredient and find related Turkish product records to discuss with a pharmacist.

TİTCK and SGK, with foreign medicine registries
Addresses & details
GET /meds/lookupGET /meds/suggest
q
Required brand or active ingredient. Suggestions need at least 2 characters.
limit
Lookup only: 1–25 products per result group. Default: 10. Full totals are in counts.

Update schedule: When source datasets are updated
Reuse an answer for: Check response headers

Matching an ingredient does not mean two medicines can be safely substituted. Strength, formulation and other details matter. Always confirm with a pharmacist.

Open this API address Use the medicine web tool

All addresses start with https://turkpidya.com/wp-json/turkpidya-data/v1. Existing turkpidya-gold/v1 and turkpidya-earthquake/v1 integrations still work.

For curious humans and helpful AI

Let your assistant
do the asking.

Connect Turkpidya to an AI assistant that supports MCP. Then ask a normal question, and it can look up the answer using these same data sources.

MCP is simply the connector between the assistant and the tools it can use.

Explore the open-source connector
An example of how it works
“Can you check the euro exchange rate for me?”
Your assistant checks Turkpidya

It can read the rate, name the source, and tell you the date of the record.

Connect with Claude Code

Requires Node.js 18+ and Claude Code. Run this in your terminal:

claude mcp add turkey-data -- npx -y turkey-data-mcp

The connector covers currency, gold, fuel, prayer times and earthquakes. Check the repository for other clients and setup instructions.

Less jargon. More understanding.

A small dictionary
for the road.

Technical words are easier when someone explains them. Tap any term.

API

A way for one program to ask another for information. Here, the question is a web address and the answer is data about Türkiye.

Endpoint

The address for one kind of information. For example, /gold asks for gold prices and /fx/USD asks for the dollar exchange rate.

JSON

Text organised with labels. In "currency": "TRY", the label is currency and the value is TRY. Your app can read each value separately.

GET

A request to read information. All the addresses on this page use GET. Asking for data does not change it.

Cache

A saved answer you reuse for a while. It makes your app faster and avoids asking for the same information repeatedly.

Rate limit

The maximum number of requests allowed in a period. The public API allows up to 60 per minute per IP address.

CORS

A browser permission that lets a page on another website request this API. If your browser blocks a request from another website, make that request from your server instead.

MCP

A shared way to connect AI assistants to tools. The Turkpidya MCP server lets a compatible assistant ask this API for information.

Timestamp

A date and time attached to a record. For example, +03:00 at the end means the time is three hours ahead of UTC, as in Istanbul.

HTTP status

A short number explaining the result of a request. 200 means it worked; 404 means the requested record was not found; 429 means wait before trying again.

A good neighbour’s guide

Free to use. Built to share.

A few simple rules keep the service useful for everyone.

60/ minute

Give the API room to breathe

Up to 60 requests per minute per IP. If you receive 429, pause and follow the Retry-After header before trying again.

Save an answer for a while

Follow the Cache-Control header. Always check the date in the answer: a successful request can still return an older record.

Give the source a little credit

When you show the data publicly, add a visible link to Turkpidya. Please don’t resell the raw feeds or repeatedly request the same data.

What if something goes wrong?

Empty answer: no records are available for that request. Check any note and the source date. 400: check your filters. 404: the requested record or date is unavailable. 429: wait before trying again. 503: the service or dataset is temporarily unavailable. Other server or network errors can also happen; keep a saved answer and retry later.

Use the API in apps, research and personal projects within these limits. Data is provided as available, without a guarantee of freshness or uptime. It is not financial, medical or emergency advice.

Need higher limits, historical data or a service agreement?
Talk to us at [email protected]