Quickstart · EXDZ API

Before you start

You need an active EXDZ API entitlement and a live API key. A newly issued key is shown exactly once.

EXDZ_API_KEY=exdz_live_your_key_here

Make a request

The API base URL is https://api.exchangedz.com/v1. Send the key as a Bearer token.

curl "https://api.exchangedz.com/v1/rates/latest?currency=EUR&source=parallel" \
  -H "Authorization: Bearer $EXDZ_API_KEY"

const response = await fetch(
  'https://api.exchangedz.com/v1/rates/latest?currency=EUR&source=parallel',
  { headers: { Authorization: `Bearer ${process.env.EXDZ_API_KEY}` } }
);

if (!response.ok) {
  const problem = await response.json();
  throw new Error(`EXDZ API: ${problem.error.code}`);
}

const { data, meta } = await response.json();
console.log(data[0].buy, data[0].sell, meta.requestId);

Read the response

data

The endpoint result. Latest rates returns one object per matching currency.

meta.requestId

A unique diagnostic ID for this request. Log it with failures.

buy / sell

DZD values for one unit of the requested foreign currency. Review the precise market semantics before presenting them to users.

updatedAt

The timestamp attached to the most recent stored observation returned by EXDZ.

Check usage

Quota headers accompany every authenticated response. The account endpoint also returns a compact summary for dashboards and health checks.

curl "https://api.exchangedz.com/v1/me" \
  -H "Authorization: Bearer $EXDZ_API_KEY"