# Turkey Market API > Live Turkish market prices for the lira (TRY): foreign currencies, the famous Turkish gold market (gram, quarter/half/full and Republic coins, 14/18/22-carat, silver) and key market instruments (the BIST 100 index, Bitcoin in lira, Brent crude and the gold ounce). Turkey's high-inflation economy makes physical gold a primary store of value, and the gram-altın and coin prices quoted here are what the bazaar trades on. The currencies endpoint returns every foreign currency against the lira with buy/sell and daily change; the gold endpoint returns the full Turkish gold/silver market; the quote endpoint returns any single instrument by code (also BIST 100, Bitcoin, Brent); the convert endpoint converts between any currency and the lira. Read live, nothing stored. This is Turkey's own live market FX + gold-bazaar layer — distinct from the central bank's official reference rates. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/turkey-api/..." ``` ## Pricing - **Free** (Free) — 3,000 calls/Mo, 2 req/s - **Starter** ($8/Mo) — 75,000 calls/Mo, 12 req/s - **Pro** ($22/Mo) — 380,000 calls/Mo, 35 req/s - **Scale** ($50/Mo) — 2,400,000 calls/Mo, 110 req/s ## Endpoints ### Quote #### `GET /v1/quote` — Any single instrument by code **Parameters:** - `symbol` (query, required, string) — Instrument code (usd, gram, bist100, btc, brent …) Example: `gram` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/turkey-api/v1/quote?symbol=gram" ``` **Response:** ```json { "data": { "code": "GRA", "name": "Gram Gold", "type": "Gold", "quote": "TRY", "buying": 6058.29, "source": "finans.truncgil.com", "selling": 6059.18, "updated": "2026-06-11 19:50:01", "change_pct": 0.33 }, "meta": { "timestamp": "2026-06-11T16:50:43.793Z", "request_id": "9c940b6f-8bd6-4ba6-8de3-f52bc9aec2c8" }, "status": "ok", "message": "Quote retrieved successfully", "success": true } ``` ### Currencies #### `GET /v1/currencies` — Every foreign currency vs the lira **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/turkey-api/v1/currencies" ``` **Response:** ```json { "data": { "count": 63, "quote": "TRY", "source": "finans.truncgil.com", "updated": "2026-06-11 19:50:01", "currencies": [ { "code": "AED", "name": null, "quote": "TRY", "buying": 12.5633, "selling": 12.567, "change_pct": 0.04 }, { "code": "ALL", "name": null, "quote": "TRY", "buying": 0.5591, "selling": 0.5592, "change_pct": -0.11 }, { "code": "ARS", "name": null, "quote": "TRY", "buying": 0.0323, "selling": 0.0323, "change_pct": 0.34 }, { "code": "AUD", "name": null, "quote": "TRY", "buying": 32.268, "selling": 32.2833, "change_pct": 0 }, { "code": "AZN", "name": null, "quote": "TRY", "buying": 27.1459, "selling": 27.1525, "change_pct": 0.06 }, { "code": "BAM", "name": null, "quote": "TRY", "buying": 27.2227, "selling": 27.2294, "chang …(truncated, see openapi.json for full schema) ``` ### Gold #### `GET /v1/gold` — Full Turkish gold & silver market **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/turkey-api/v1/gold" ``` **Response:** ```json { "data": { "gold": [ { "code": "GRA", "name": "Gram Gold", "quote": "TRY", "buying": 6058.29, "selling": 6059.18, "change_pct": 0.33 }, { "code": "HAS", "name": "Gram Pure Gold", "quote": "TRY", "buying": 6028, "selling": 6028.88, "change_pct": 0.33 }, { "code": "CEYREKALTIN", "name": "Quarter Gold Coin", "quote": "TRY", "buying": 9801.16, "selling": 10027.48, "change_pct": -2.1 }, { "code": "YARIMALTIN", "name": "Half Gold Coin", "quote": "TRY", "buying": 19541.06, "selling": 20054.97, "change_pct": -2.1 }, { "code": "TAMALTIN", "name": "Full Gold Coin", "quote": "TRY", "buying": 39204.63, "selling": 39987.27, "change_pct": -2.1 }, { "code": "CUMHURIYETALTINI", "name": "Republic Gold Coin", "quote": "TRY", "buying": 40663, "selling": 41278, "change_pct": -1.96 …(truncated, see openapi.json for full schema) ``` ### Convert #### `GET /v1/convert` — Convert between any currency and the lira **Parameters:** - `amount` (query, required, string) — Amount to convert Example: `100` - `from` (query, optional, string) — From currency code Example: `USD` - `to` (query, optional, string) — To currency code Example: `TRY` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/turkey-api/v1/convert?amount=100&from=USD&to=TRY" ``` **Response:** ```json { "data": { "to": "TRY", "from": "USD", "amount": 100, "result": 4615.51, "source": "finans.truncgil.com", "updated": "2026-06-11 10:51:01", "try_per_to": 1, "try_per_from": 46.1551 }, "meta": { "timestamp": "2026-06-11T07:51:19.169Z", "request_id": "087f824c-7376-46ba-9b22-bfa6efb6ca0e" }, "status": "ok", "message": "Conversion completed", "success": true } ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/turkey-api/v1/meta" ``` **Response:** ```json { "data": { "note": "Prices in TRY; buy = Buying, sell = Selling. quote also serves BIST100 (XU100), Bitcoin (DBITCOIN) and Brent.", "source": "finans.truncgil.com (Turkish market feed, live)", "service": "turkey-api", "usd_try": null, "endpoints": { "GET /v1/gold": "Full Turkish gold & silver market (gram, coins, carat bars, silver, ounce).", "GET /v1/meta": "This document.", "GET /v1/quote": "Any single instrument by code (symbol=usd, gram, bist100, btc, brent …).", "GET /v1/convert": "Convert between any currency and the lira (amount=100, from=USD, to=TRY).", "GET /v1/currencies": "Every foreign currency vs the lira with buy/sell and daily change." }, "description": "Live Turkish market prices for the lira (TRY): foreign currencies, the famous Turkish gold market (gram, quarter/half/full and Republic coins, 14/18/22-carat, silver) and key instruments (BIST 100 index, Bitcoin in lira, Brent crude, gold ounce). Turkey's high-inflation economy makes physical gold a primary store of value, and the gram-altın and coin prices quoted here are what the bazaar trades on. The currencies endpoint returns every foreign currency against the lira with buy/sell and daily change; the gold endpoint returns the full Turkish gold/silver market; the quote endpoint returns any single instrument by code; the convert endpoint converts between any currency and the lira. Live, …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/turkey-api OpenAPI spec: https://www.oanor.com/api/turkey-api/openapi.json