# ServiceBox APIs

> Turkish data APIs behind one API key: REST over HTTPS with Bearer auth, pay-per-call credits, Markdown docs and an OpenAPI document for every API and programmatic signup for agents.

## APIs

- [Fuel prices (SBX-AKY)](https://api.servicebox.io/docs/fuel.md): EPDK fuel prices for all 81 provinces: gasoline and diesel prices per dealer and distributor, with EPDK licence details and verified Google Maps details where a station can be matched. — OpenAPI: https://api.servicebox.io/v1/fuel/openapi.json
- [Cities & towns (SBX-CITY)](https://api.servicebox.io/docs/cities.md): 171k cities and towns with population, timezone and coordinates, plus nearest-city search. Turkey's 974 districts and 36k neighbourhood and village postal codes. — OpenAPI: https://api.servicebox.io/v1/cities/openapi.json
- [Crypto (SBX-CRY)](https://api.servicebox.io/docs/crypto.md): The top 500 crypto assets: USD, EUR and TRY price, market cap, volume and change (every 5 minutes), hourly and daily price history, and whole-market metrics. — OpenAPI: https://api.servicebox.io/v1/crypto/openapi.json
- [Nöbetçi Eczane (SBX-ECZ)](https://api.servicebox.io/docs/pharmacy.md): More than 30,000 pharmacies (on-duty and regular) across 81 provinces and ~960 districts, with on-duty status and shift windows plus nearest-to-point search — refreshed up to three times a day. — OpenAPI: https://api.servicebox.io/v1/pharmacy/openapi.json
- [Commodity futures positions (SBX-EMTIA)](https://api.servicebox.io/docs/commodity-futures.md): CFTC Commitments of Traders: weekly positions and open interest in 30 futures markets including wheat, cotton, copper, gold and crude oil, since 2006. — OpenAPI: https://api.servicebox.io/v1/commodity-futures/openapi.json
- [Finance news (SBX-FNEWS)](https://api.servicebox.io/docs/finance-news.md): Financial news from official sources: the Fed, the ECB, US companies' 8-K filings and Türkiye's Official Gazette, summarised by AI in Turkish and English with tags and importance. — OpenAPI: https://api.servicebox.io/v1/finance-news/openapi.json
- [Currencies (SBX-FX)](https://api.servicebox.io/docs/fx.md): TCMB indicative TRY rates since 2005 (forex and banknote, buying and selling) and ECB euro reference rates since 1999, with conversion and history. — OpenAPI: https://api.servicebox.io/v1/fx/openapi.json
- [Countries & states (SBX-GEO)](https://api.servicebox.io/docs/countries.md): 250 countries and territories, 3,865 states and provinces: ISO codes, Turkish names, capitals, dial codes, currencies and neighbours. — OpenAPI: https://api.servicebox.io/v1/countries/openapi.json
- [Geocoding (SBX-GEOC)](https://api.servicebox.io/docs/geocoding.md): Reverse geocoding (what is at a point: country, province, district, postal code, nearest city) and IP-address-to-country. Forward geocoding coming soon. — OpenAPI: https://api.servicebox.io/v1/geocoding/openapi.json
- [Gold & commodities (SBX-GOLD)](https://api.servicebox.io/docs/gold.md): Daily intrinsic value of gram, çeyrek, Cumhuriyet and ounce gold (TRY, USD, EUR; since 2013); daily spot prices of Brent, WTI, natural gas and fuels; monthly prices of 67 commodities. — OpenAPI: https://api.servicebox.io/v1/gold/openapi.json
- [Prayer times (SBX-PRAY)](https://api.servicebox.io/docs/prayer-times.md): Daily prayer times for any city or coordinate, by the Diyanet method by default or eleven others, with the Qibla direction. — OpenAPI: https://api.servicebox.io/v1/prayer-times/openapi.json
- [Validation (SBX-VAL)](https://api.servicebox.io/docs/validation.md): IBAN (87 countries, with the bank for Turkish IBANs), Turkish national id, tax number and phone number validation. — OpenAPI: https://api.servicebox.io/v1/validation/openapi.json
- [Historical weather (SBX-WHIST)](https://api.servicebox.io/docs/weather-history.md): Daily weather since 1981 and hourly since 2001, monthly climate normals, and heating and cooling degree days. — OpenAPI: https://api.servicebox.io/v1/weather-history/openapi.json
- [Current & forecast (SBX-WTHR)](https://api.servicebox.io/docs/weather.md): Current conditions, a 48-hour hourly and a 9-day daily forecast for any city or coordinate, with conditions in Turkish. — OpenAPI: https://api.servicebox.io/v1/weather/openapi.json

## Agents

- [MCP server](https://mcp.servicebox.io/mcp): Streamable HTTP MCP endpoint; send `Authorization: Bearer <api key>`. Each tool call is metered exactly like the REST call.
- [Sign up](https://api.servicebox.io/v1/accounts): `POST` `{"email": "...", "apis": ["<slug>"]}` → 202 with `poll_url` and `poll_token`; the mailbox owner approves by email, then polling returns a short-lived API key.
- [Ephemeral keys](https://api.servicebox.io/v1/keys/ephemeral): `POST` with `Authorization: Bearer <api key>` and `{"ttl_seconds": 3600}` → a short-lived child key for a sub-agent.

## Optional

- [Pricing](https://servicebox.io/pricing): plans and credit packs per API
- [Status](https://servicebox.io/status): uptime and latency per API