GET /v1/market/premium

Returns a currency only when both a parallel and an official observation are available.

Bearer key required JSON response

How it is calculated

amount
parallel − official, calculated separately for buy and sell.
percent
(parallel − official) / official × 100, rounded to four decimal places.

Parameters

ParameterTypeDescription
currency optional string

Comma-separated asset codes. Duplicate codes are removed; a maximum of 25 is accepted.

Default: EUR,USD,GBP,CAD

Example request

curlEUR and USD premium
curl "https://api.exchangedz.com/v1/market/premium?currency=EUR,USD" \
  -H "Authorization: Bearer $EXDZ_API_KEY"

Response

json200 OK
{
  "data": [
    {
      "currency": "EUR",
      "quote": "DZD",
      "parallel": {
        "buy": 274.67,
        "sell": 277.17,
        "updatedAt": "2026-08-24T00:00:00.000Z"
      },
      "official": {
        "buy": 151.42,
        "sell": 151.47,
        "updatedAt": "2026-08-24T00:00:00.000Z"
      },
      "premium": {
        "buy": { "amount": 123.25, "percent": 81.3961 },
        "sell": { "amount": 125.70, "percent": 82.9874 }
      }
    }
  ],
  "meta": {
    "requestId": "req_01J6EXDZ...",
    "count": 1,
    "quote": "DZD",
    "currencies": ["EUR"],
    "missingCurrencies": ["USD"]
  }
}

meta.missingCurrencies lists requested codes that could not be compared because one source family was unavailable. Missing data is never converted to zero.