Daleelak
العربية
API

API changelog

What changed in the v1 public API, newest first. Additions are backwards compatible. A breaking change would ship as a new version, listed here with its version marked.

Consuming this programmatically? GET /api/v1/changelog.json Atom feed

API v1 #

#

Fixed
  • sellerAr is now always present on every seller and on best, and is null when a seller has no Arabic name. Before, the key was left out, which broke strict clients. The United Bank and First Abu Dhabi Bank (FAB) also lost their Arabic names after a source renamed them, and have them back. The OpenAPI spec now marks every field as required, matching what the feed has always sent, so a generated client can treat each key as always there. Thanks to ahmedmohamedm-dev for reporting it.

#

Added
  • Added an embeddable price card: frame /embed/{lang}/{category}/{slug}/{side} to show today's best price and day reading on any site, with no key. The snippet is on this site's API page.

#

Fixed
  • Fixed two seller errors in the currency sellers lists. Banque du Caire carried the wrong sellerAr (Credit Agricole's Arabic name), and is now بنك القاهرة (BDC). Bank of Alexandria, Al Baraka Bank, and Credit Agricole could appear twice in one asset under two spellings, and now appear once. The fix applies from the next daily update. Thanks to ahmedmohamedm-dev for reporting it.

#

Added
  • Each day in series now carries benchBuy and benchSell (the official buy and sell rates) and global (that day's global mid). A chart can now compare the best seller price with the official and global rates on the same side, day by day. Each is null on a day without it, and metals have no official rate. bench, the old name for benchBuy, still works but is deprecated and will be dropped in v2. Thanks to ahmedmohamedm-dev for suggesting it.

#

Added
  • The OpenAPI contract now links the public status page (info.x-status), so tools and AI agents that read only the spec can find live uptime and incident history.
  • Each asset's confidence now carries providers: how many independent price providers fed it today, counted only, never named. Official and global reference rates do not count. It sits beside checks, which counts the sources that quoted the same seller, so an asset whose providers quote different sellers no longer looks single-sourced.
Fixed
  • The OpenAPI contract now allows signals.position.lean to be null, which the feed returns while a verdict is still calibrating (too little history to place today). The feed itself did not change. The spec is now checked against the real feed on every build, so the two cannot drift apart again.
  • The OpenAPI contract now says what each seller's buy and sell mean: buy is what the seller pays you when you sell, sell is what you pay when you buy. confidence.checks is described as what it counts, the most sources that quoted the same seller today. signals.trend.direction is typed as the integer the feed has always returned (1, 0 or -1), and the sample confidence level is a real value. The feed itself did not change.

#

Added
  • A public status page at status.getdaleelak.com shows live uptime and incident history for the website, the API, and data freshness. It is measured by an independent monitor, not by our own servers. The discovery document now carries a status link.
  • Responses now include Daily-Limit, Daily-Used and Daily-Reset headers: the fair-use daily amount, how many requests your address made today, and the seconds until the count resets at midnight Cairo time. Nothing is blocked at the daily amount.
  • A discovery document at /api/v1 lists every endpoint, the accepted filters, and the free-tier limits, so you can orient in one request. Each feed response now also includes a _self link to the exact request that produced it.
  • Responses now include a RateLimit-Policy header with your full quota, so you can pace requests up front instead of only reacting to a 429. Browser apps can also read it and send the optional X-Contact header across origins.
  • When an API version is retired, its responses will carry Deprecation and Sunset dates plus a Link to the successor version, so you are warned inside the response with time to migrate. Nothing is deprecated today.
Changed
  • The limits now read as one clear model: about 1,000 requests a day is the free allowance, and the per-minute limit only stops bursts. The 20-second minimum gap between calls is retired. Prices change at most about once an hour, so calling every 5 minutes or so is plenty. In the discovery document and the OpenAPI limits block, minIntervalSeconds is replaced by recommendedPollSeconds (300, guidance only).

#

Added
  • Filter the feed to specific assets with ?asset= (by slug or id, comma-separated, and combinable with ?category=).
  • The API now documents itself for tools and AI agents: a Link header pointing to the spec and docs, documented values for every field, the sell and buy reading rules, and a full example response.
Changed
  • Errors now return application/problem+json (RFC 9457), keeping the existing fields so nothing breaks.
  • The free feed now returns the most recent 30 days of history per asset (see seriesWindowDays). Longer and per-seller history is reserved for the paid tier.
Fixed
  • Browser apps can now read the ETag and rate-limit headers and use conditional requests across origins.

#

Added
  • Public API launched. The free JSON feed at /api/v1/feed.json returns the best licensed seller by direction, the day's verdict, the official and global rates, and daily history, with a versioned URL, a category filter, conditional requests using ETag, a published OpenAPI contract, no key, and CORS open.

Open the OpenAPI spec