Turkish Gold Price API: Live Gold & FX Prices from Türkiye
Hasfiyat Gold API delivers live prices from the Turkish gold market to your software: has gold, Turkish gold coins, 22 karat bracelet gold, silver, ounce gold and the Turkish lira against major currencies. Connect with REST, stream with WebSocket, or receive Webhook notifications when prices change.
Last updated: 5 October 2026 · by the Hasfiyat team
Short answer: Hasfiyat Gold API (altinapi.hasfiyat.com) is a commercial API for live Turkish gold and currency prices. It is built for jewellers' price screens, gold-indexed e-commerce pricing and fintech apps. New accounts get a 10-day free Pro trial with no credit card. Plans are billed monthly in Turkish lira.
What data is included?
- Gold: has gold (pure gold reference), gram and kilogram gold in USD and EUR, 22 and 14 karat gold.
- Turkish gold coins: quarter (çeyrek), half (yarım), full (tam), Ata, Ata five and Gremse, in new and old mintings.
- International: ounce gold, silver, platinum and palladium.
- Currencies: USD/TRY, EUR/TRY, GBP/TRY, CHF/TRY and other pairs, plus EUR/USD and GBP/USD.
Prices come from Turkish market sources such as Harem; you can pick a source per request or let your account's source priority decide. If the preferred source stops updating, the stream fails over to the next source automatically.
Access methods
| Method | Best for | How |
|---|---|---|
| REST | Periodic jobs, server-side price updates | GET https://api.hasfiyat.com/api/prices?source=harem |
| WebSocket | Live price screens and dashboards | wss://api.hasfiyat.com/stream?source=harem&token=… |
| Webhook | Event-driven workflows | A POST to your URL when prices change |
Quick start
curl -H "Authorization: Bearer YOUR_API_KEY" \ "https://api.hasfiyat.com/api/prices?source=harem&symbols=HAS,CEYREK,USD"
The response contains the source, the number of items, a data array and freshness fields:
{
"source": "harem",
"count": 3,
"data": [
{ "title": "HAS ALTIN", "buy": "6.584,13", "sell": "6.600,42" },
...
],
"dataAgeMs": 1200,
"stale": false,
"lastUpdate": "2026-10-05T07:00:00.000Z"
}
Values are strings in Turkish number format (dot for thousands, comma for decimals). The example values are illustrative. Add birim=1 to receive the unit and currency of each item. Full reference: documentation and OpenAPI file.
Marketplace and e-commerce integrations
Many Turkish shops sell gold jewellery whose price follows the gold price. Hasfiyat updates gold-indexed product prices automatically on Trendyol, Hepsiburada, N11, Amazon Türkiye, Çiçeksepeti, Pazarama and PTTAVM, and on platforms such as Ticimax, İkas, IdeaSoft, T-Soft, Shopify, WooCommerce, OpenCart and PrestaShop. The number of integrations depends on your plan.
Plans
| Plan | Monthly price (VAT incl.) | Notes |
|---|---|---|
| Starter | 1,250 TRY | Single shop, basic live feed |
| Pro | 2,500 TRY | More sources, higher request quota, marketplace integrations |
| Enterprise | 9,000 TRY | All sources and marketplaces, priority support |
Every new account starts with a 10-day free Pro trial; no credit card is required. There is no permanent free plan.
Not affiliated with altinapi.com
Hasfiyat Gold API is a product of Hasfiyat and is served from altinapi.hasfiyat.com. "AltinAPI" at altinapi.com is a different company's service; the two are not affiliated. For a dated comparison of Turkish gold APIs, see our comparison guide (Turkish).
FAQ
Is there an API for Turkish gold prices?
Yes. Hasfiyat Gold API provides live prices from the Turkish market, including has gold, gram gold, Turkish gold coins such as quarter, half, full and Ata, 22 karat bracelet gold, silver, ounce gold and major currency pairs against the Turkish lira. Data is available through REST, WebSocket and Webhook.
Is Hasfiyat Gold API the same as AltinAPI?
No. Hasfiyat Gold API is a product of Hasfiyat and is served from altinapi.hasfiyat.com. AltinAPI at altinapi.com is a service of a different company, and the two products are not affiliated.
Is there a free plan?
There is no permanent free plan. Every new account receives a 10-day free Pro trial and no credit card is required. After the trial you can switch to Starter, Pro or Enterprise and keep the same API key and integration code.
How are prices formatted?
Each item has a title, a buy price and a sell price. Prices are returned as strings in Turkish number format, for example 6.584,13, where the dot is the thousands separator and the comma is the decimal separator. Parse them accordingly before doing arithmetic.
Can I update marketplace product prices automatically?
Yes. Hasfiyat offers ready integrations that update gold-indexed product prices on Turkish marketplaces and e-commerce platforms such as Trendyol, Hepsiburada, N11, Amazon Türkiye, Çiçeksepeti, Pazarama, Ticimax, İkas, IdeaSoft, Shopify and WooCommerce, depending on your plan.