{"openapi":"3.1.0","info":{"title":"jads.gg Turkey Data","version":"1.0.0","description":"Paid via x402: $0.01 USDC per request."},"servers":[{"url":"https://api.jads.gg"}],"paths":{"/api/tcmb/rates":{"get":{"operationId":"tcmb_exchange_rates","summary":"Official Turkish central bank (TCMB) exchange rates against the Turkish lira (TRY), latest or for a past date, as clean English JSON. Weekends/holidays return the last published bulletin.","parameters":[{"name":"date","in":"query","required":false,"description":"YYYY-MM-DD. Omit for the latest bulletin.","schema":{"type":"string"}},{"name":"currencies","in":"query","required":false,"description":"Comma-separated ISO 4217 codes, e.g. USD,EUR. Omit for all.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"source":"TCMB (Central Bank of the Republic of Turkey)","quote":"TRY per unit of currency","requestedDate":"2026-10-16","bulletinDate":"2026-10-16","bulletinNo":"2026/196","rates":[{"code":"USD","name":"US DOLLAR","unit":1,"forexBuying":49.3573,"forexSelling":49.4463,"banknoteBuying":49.3228,"banknoteSelling":49.5204,"crossRateUSD":null}]}}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment required (x402)"}}}},"/api/tr/holidays":{"get":{"operationId":"turkey_public_holidays","summary":"Turkish public holidays for a year, including religious holidays (Ramazan/Kurban Bayramı) and official half-day eves (arife, from 13:00), with English and Turkish names.","parameters":[{"name":"year","in":"query","required":false,"description":"Year (2000-2028). Omit for the current year.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"country":"TR","year":2026,"holidays":[{"date":"2026-03-19","weekday":"Thursday","name":"Eid al-Fitr Eve","localName":"Ramazan Bayramı Arifesi","type":"half","halfDayFrom":"13:00","tentative":false},{"date":"2026-03-20","weekday":"Friday","name":"Eid al-Fitr First Day","localName":"Ramazan Bayramı 1. Gün","type":"full","tentative":false}]}}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment required (x402)"}}}},"/api/tr/workday":{"get":{"operationId":"turkey_workday","summary":"Is a date a working day in Turkey (weekends, public holidays, half-day eves)? Optionally add or subtract N working days, e.g. for deadlines and delivery dates.","parameters":[{"name":"date","in":"query","required":false,"description":"YYYY-MM-DD. Omit for today.","schema":{"type":"string"}},{"name":"add","in":"query","required":false,"description":"Optional integer -365..365: working days to add (negative to subtract).","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"country":"TR","date":"2026-10-27","weekday":"Tuesday","isWorkday":true,"isHalfDay":false,"reason":null,"add":3,"result":{"date":"2026-11-02","weekday":"Monday","isWorkday":true,"isHalfDay":false,"reason":null}}}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment required (x402)"}}}}}}