API-Dokumentation

Verwenden Sie unsere öffentliche API, um Echtzeit-Wechselkursdaten für das syrische Pfund abzurufen

Basis-URL

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

🆓

Freier API-Zugang

Öffentliche Endpunkte sind kostenlos ohne Konto oder API-Schlüssel erreichbar. Bis zu 300 Anfragen/Monat pro IP-Adresse.

Authentifizierung

Die API ist öffentlich und erfordert keine Authentifizierung für öffentliche Endpunkte

Keine AuthÖffentliche Endpunkte

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

300 Anfragen/Monat pro IP — völlig kostenlos

API-Schlüssel erforderlichPrivate Endpunkte

/client/*

Abonnieren für höhere Limits und erweiterte Funktionen

Endpunkte

Aktuelle Kurse abrufen

Rufen Sie die aktuellen Wechselkurse von der Zentralbank und Schwarzmarktquellen ab

GET/rates/latest

Abfrageparameter

currencies(Optional)

Kommagetrennte Liste von Währungen (z. B. USD,EUR)

lang(Optional)

Sprachcode (ar, en, de) - Standard: ar

Beispielanfrage

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

Beispielantwort

{
  "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": [...]
}

USD-Kurse abrufen

Aktuelle Wechselkurse mit USD als Basiswährung abrufen

GET/rates/usd-based

Abfrageparameter

lang(Optional)

Sprachcode (ar, en, de) - Standard: ar

Beispielanfrage

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

Beispielantwort

{
  "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 }
  ]
}

Antwortfelder

baseBasiswährung (USD)

dateDatum der letzten Kurs-Aktualisierung

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

Abfrageparameter

lang(Optional)

Response language (ar, en, de)

Beispielanfrage

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

Latest Gold Prices

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

GET/gold/latest

Abfrageparameter

lang(Optional)

Response language (ar, en, de)

Beispielanfrage

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

Antwortfelder

disclaimerHaftungsausschlussmeldung (lokalisiert)

timestampUtcUTC-Zeitstempel

cbsRatesZentralbankkurse

marketRatesMarktkurse

effectiveRatesEffektive Kurse (manuelle Überschreibungen oder Markt)

currencyWährungscode

buyKaufkurs

sellVerkaufskurs

midMittelkurs

timestampUtcAktualisierungszeit

isManualOverrideOb es ein manueller Kurs ist

Ratenlimits

Um die API vor Missbrauch zu schützen, gelten die folgenden Ratenlimits für alle öffentlichen Endpunkte.

Stufe	Authentifizierung	Monatlich	Pro Minute	Pro Stunde
Kostenlos (IP)	Keine Auth	300	5	100
Starter	API-Schlüssel erforderlich	10,000	100	1,000
Professional	API-Schlüssel erforderlich	500,000	500	20,000
Enterprise	API-Schlüssel erforderlich	Unbegrenzt	Unbegrenzt	Unbegrenzt

Upgrade auf einen bezahlten Plan für höhere Limits. Pläne anzeigen

Ratenlimit-Header

Alle API-Antworten enthalten Ratenlimit-Informationen:

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

HTTP 429 Antwort

Wenn das Ratenlimit überschritten wird:

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

Private API & Webhooks

Die Private API ermöglicht Integrationen mit signierten Webhook-Benachrichtigungen für Wechselkursbedingungen.

Authentifizierung der privaten API

Alle /client/*-Endpunkte erfordern einen öffentlichen und einen privaten Schlüssel in den Anfrage-Headern.

X-Api-KeyIhr öffentlicher Schlüssel (lsp_pub_...)

X-Api-SecretIhr privater Schlüssel (lsp_prv_...)

Beispielanfrage

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..."

⚠️ Der private Schlüssel wird nur einmal bei der Erstellung angezeigt. Speichern Sie ihn sofort sicher ab.

Client-Profil

Zeigen Sie Ihre Kontoinformationen und die Anzahl registrierter Webhooks an.

GET/client/me

Beispielantwort

{
  "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
}

Webhooks

Registrieren Sie URLs, um automatische Benachrichtigungen bei Kursbedingungen zu erhalten.

GET/client/webhooks— Alle Webhooks auflisten

POST/client/webhooks— Neuen Webhook erstellen

Beispielanfrage

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"
  }'

Benachrichtigungstypen

0 — ABOVEAuslösen wenn Kurs ≥ Schwellenwert

1 — BELOWAuslösen wenn Kurs ≤ Schwellenwert

2 — CHANGE_INCREASEAuslösen bei Kursanstieg um Schwellenwert %

3 — CHANGE_DECREASEAuslösen bei Kursrückgang um Schwellenwert %

PUT/client/webhooks/{id}— Webhook aktualisieren

DELETE/client/webhooks/{id}— Webhook löschen

Webhook-Payload

Wenn eine Benachrichtigungsbedingung erfüllt ist, sendet LiraScope eine POST-Anfrage an Ihre Webhook-URL.

Headers

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

Beispielantwort

{
  "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"
}

Signaturüberprüfung

Überprüfen Sie die Payload-Authentizität mit HMAC-SHA256 und Ihrem öffentlichen Schlüssel als Geheimnis.

// 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)
  );
}

Webhook-Zuverlässigkeit

Webhooks, die 10 Mal hintereinander fehlschlagen, werden automatisch deaktiviert.
Reaktivieren Sie über das Dashboard oder den PUT /client/webhooks/{id}-Endpunkt.
Die Felder lastDeliveryStatusCode und consecutiveFailures zeigen den Zustellungsstatus.

Support

Für Support oder um Probleme zu melden, kontaktieren Sie bitte info@omarino.de