Belgeyên API

API-ya me ya giştî ji bo gihîştina daneyên nirxê guhertina lîreya Sûriyeyê di dema rastîn de bikar bînin

URL-ya Bingehîn

https://lirascope.syria-cloud.sy/api/v1

🆓

Gihiştina API-ya Belaş

Xalên giştî bê hesab an mifteya API-yê bi belaş in. Heta 300 daxwaz/meh ji bo her IP-yekê.

Nasîn û Nasîn

API-yê giştî ye û ji bo xalên giştî hewceyî nasînê tune ye

Nasnameyê NaxwazeXalên Giştî

/rates/*
/crypto/*
/gold/*
/pricing

300 daxwaz/meh ji bo her IP — bi tevahî belaş

Mifteya API Lazim eXalên Taybet

/client/*

Ji bo sînorên bilindtir bibin endamên plan

Xalên Dawiyê

Nirxên Dawî Bistînin

Nirxên dawî yên guhertinê ji Banka Navendî û çavkaniyên bazara reş bistînin

GET/rates/latest

Parametreyên Pirsan

currencies(Vebijêrk)

Navnîşana diravên bi komayî veqetandî (mînak: USD,EUR)

lang(Vebijêrk)

Zimanê bersivê (ar, en, de, tr, ku, kmr) - Bingehîn: ar

Daxwaza Mînak

curl "https://lirascope.syria-cloud.sy/api/v1/rates/latest?currencies=USD,EUR&lang=kmr"

Bersiva Mînak

{
  "disclaimer": "...",
  "timestampUtc": "2026-01-29T02:00:00Z",
  "cbsRates": [
    {
      "currency": "USD",
      "buy": 110.00,
      "sell": 111.00,
      "mid": 110.50,
      "timestampUtc": "2026-01-29T01:59:47Z",
      "isManualOverride": false
    }
  ],
  "marketRates": [
    {
      "currency": "USD",
      "buy": 116.80,
      "sell": 117.50,
      "mid": 117.15,
      "timestampUtc": "2026-01-29T01:54:46Z",
      "isManualOverride": false
    },
    {
      "currency": "EUR",
      "buy": 138.40,
      "sell": 140.30,
      "mid": 139.35,
      "timestampUtc": "2026-01-29T01:54:46Z",
      "isManualOverride": false
    }
  ],
  "effectiveRates": [...]
}

Rêjeyên Ser Bingeha USD Bîne

Rêjeyên herî dawî yên diravê bi USD wekî bingehê bistîne

GET/rates/usd-based

Parametreyên Pirsan

lang(Vebijêrk)

Zimanê bersivê (ar, en, de, tr, ku, kmr) - Bingehîn: ar

Daxwaza Mînak

curl "https://lirascope.syria-cloud.sy/api/v1/rates/usd-based?lang=kmr"

Bersiva Mînak

{
  "disclaimer": "...",
  "base": "USD",
  "date": "2026-03-10",
  "timestampUtc": "2026-03-10T12:00:00Z",
  "rates": [
    { "currency": "AED", "buy": 3.6594, "sell": 3.6814, "mid": 3.6704 },
    { "currency": "CHF", "buy": 0.8798, "sell": 0.8851, "mid": 0.8824 },
    { "currency": "EGP", "buy": 49.721, "sell": 50.019, "mid": 49.870 },
    { "currency": "EUR", "buy": 0.9174, "sell": 0.9229, "mid": 0.9201 },
    { "currency": "GBP", "buy": 0.7820, "sell": 0.7867, "mid": 0.7843 },
    { "currency": "KWD", "buy": 0.3066, "sell": 0.3085, "mid": 0.3075 },
    { "currency": "SAR", "buy": 3.7477, "sell": 3.7702, "mid": 3.7590 },
    { "currency": "TRY", "buy": 43.945, "sell": 44.209, "mid": 44.077 }
  ]
}

Qadên Bersivê

baseDiravê bingehê (USD)

dateDîroka nûvekirina rêjeyê ya dawî

rates[].currencyISO 4217 currency code (e.g. EUR, GBP)

rates[].midMid (reference) rate — 1 USD = X units

rates[].buyBuy rate derived from market data

rates[].sellSell rate derived from market data

Latest Crypto Prices

Get the latest cryptocurrency prices in USD with 24h change data.

GET/crypto/latest

Parametreyên Pirsan

lang(Vebijêrk)

Response language (ar, en, de)

Daxwaza Mînak

curl "https://lirascope.syria-cloud.sy/api/v1/crypto/latest?lang=kmr"

Latest Gold Prices

Get the latest gold prices in USD with 24h change data.

GET/gold/latest

Parametreyên Pirsan

lang(Vebijêrk)

Response language (ar, en, de)

Daxwaza Mînak

curl "https://lirascope.syria-cloud.sy/api/v1/gold/latest?lang=kmr"

Qadên Bersivê

disclaimerMesaja redkeriya fermî

timestampUtcDema nûvekirina daneyê (UTC)

cbsRatesNirxên Banka Navendî

marketRatesNirxên bazarê

effectiveRatesNirxên bandorker (guherînên destan an bazar)

currencyKoda diravê

buyNirxa kirînê

sellNirxa firotinê

midNirxa navîn

timestampUtcDema nûvekirinê

isManualOverrideGelo guherina destan e

Sînorên Nirxê

Ji bo parastina API-yê ji karanîna xelet, sînorên nirxê li jêr li hemû xalên giştî tên sepandin.

Ast	Nasname	Mehane	Di Deqîqeyekê de	Di Saetekê de
Belaş (IP)	Nasnameyê Naxwaze	300	5	100
Destpêk	Mifteya API Lazim e	10,000	100	1,000
Profesyonel	Mifteya API Lazim e	500,000	500	20,000
Pargîdaniyê	Mifteya API Lazim e	Bê Sînor	Bê Sînor	Bê Sînor

Ji bo sînorên bilindtir, pêşve biçin planeke dayînî. Planan bibînin

Serêyên Sînorê Nirxê

Hemî bersivên API-yê agahiyên sînorê nirxê dihewîne:

X-Rate-Limit-Limit: 5
X-Rate-Limit-Remaining: 3
X-Rate-Limit-Reset: 2026-02-04T10:15:00Z

Bersiva HTTP 429

Dema sînorê nirxê derbas bibe:

{
  "error": "Rate limit exceeded. Please retry after 45 seconds.",
  "retryAfter": 45
}

API-ya Taybet & Webhook

API-ya taybet dihêle ku hûn entegrasyonan bi hişyariyên webhook yên îmzekirî ji bo mercên nirxê ava bikin.

Nasîna API-ya Taybet

Hemû xalên /client/* hewceyî mifteyek giştî û mifteyekî taybet di sernavên daxwazê de ne.

X-Api-KeyMifteya we ya giştî (lsp_pub_...)

X-Api-SecretMifteya we ya taybet (lsp_prv_...)

Daxwaza Mînak

curl -X GET https://lirascope.syria-cloud.sy/api/v1/client/me \
  -H "X-Api-Key: lsp_pub_a1b2c3..." \
  -H "X-Api-Secret: lsp_prv_d4e5f6..."

⚠️ Mifteya taybet tenê carekê di dema afirandinê de tê nîşandan. Wê yekser li cihekî ewle tomar bikin.

Profîla Xerîdar

Agahdariya hesabê xwe û jimara webhook yên tomarkirî bibînin.

GET/client/me

Bersiva Mînak

{
  "id": "3fa85f64-...",
  "name": "My Integration",
  "publicKey": "lsp_pub_a1b2c3...",
  "isActive": true,
  "createdUtc": "2026-03-08T00:00:00Z",
  "lastUsedUtc": "2026-03-08T12:00:00Z",
  "webhookCount": 2
}

Webhook

URL-yan tomar bikin da ku hişyariyên otomatîk werbigirin dema ku mercên nirxê pêk tên.

GET/client/webhooks— Hemû webhook lîste bikin

POST/client/webhooks— Webhookek nû biafirînin

Daxwaza Mînak

curl -X POST https://lirascope.syria-cloud.sy/api/v1/client/webhooks \
  -H "X-Api-Key: lsp_pub_a1b2c3..." \
  -H "X-Api-Secret: lsp_prv_d4e5f6..." \
  -H "Content-Type: application/json" \
  -d '{
    "webhookUrl": "https://my-server.com/hooks/rate-alert",
    "currency": "USD",
    "source": "MARKET",
    "alertType": 0,
    "thresholdValue": 15000.0,
    "label": "USD high alert"
  }'

Cureyên Hişyariyê

0 — ABOVEDema ku nirx ≥ sînor e bişkê

1 — BELOWDema ku nirx ≤ sînor e bişkê

2 — CHANGE_INCREASEDema ku nirx bi sînor% zêde dibe bişkê

3 — CHANGE_DECREASEDema ku nirx bi sînor% kêm dibe bişkê

PUT/client/webhooks/{id}— Webhookê nûve bikin

DELETE/client/webhooks/{id}— Webhookê jêbirin

Barkirina Webhook

Dema ku mercek hişyariyê pêk tê, LiraScope daxwazek POST ji URL-ya webhookê ya we re dişîne.

Headers

Content-Type: application/json
X-LiraScope-Signature: sha256=<hex-digest>
X-LiraScope-Event: rate_alert

Bersiva Mînak

{
  "event": "rate_alert",
  "currency": "USD",
  "source": "MARKET",
  "alertType": "ABOVE",
  "threshold": 15000.0,
  "currentRate": 15250.0,
  "previousRate": 14800.0,
  "label": "USD high alert",
  "webhookId": "7c9e6679-...",
  "timestampUtc": "2026-03-08T12:30:00Z"
}

Piştrastkirina Îmzeyê

Bi HMAC-SHA256 û mifteya xwe ya giştî wekî nepenî rastbûna barkirinê kontrol bikin.

// JavaScript / Node.js
const crypto = require('crypto');

function verifySignature(body, publicKey, signatureHeader) {
  const expected = crypto.createHmac('sha256', publicKey)
    .update(body).digest('hex');
  const received = signatureHeader.replace('sha256=', '');
  return crypto.timingSafeEqual(
    Buffer.from(expected), Buffer.from(received)
  );
}

Pêbawerbûna Webhook

Webhookên ku 10 caran li pey hev têk diçin bi otomatîk tên neçalakkirin.
Bi rêya panelê an xala PUT /client/webhooks/{id} dîsa çalak bikin.
Qadên lastDeliveryStatusCode û consecutiveFailures rewşa gihandînê nîşan didin.

Piştgirî

Ji bo piştgirî yan raporkirin xeletî, ji kerema xwe bi me re têkilî daynin info@omarino.de