LiraScope
Entwickler-API

API-Dokumentation

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

Preise Kundenportal

Erste Schritte

Basis-URL
BASE 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.

KI-Agenten- & Entwickler-Ressourcen

Maschinenlesbare Dateien, mit denen KI-Agenten und Entwicklertools die LiraScope-API schnell verstehen.

API-Referenz (Markdown)/api-docs.mdSkill-Leitfaden für KI-Agenten/SKILLS.mdllms.txt Agenten-Index/llms.txt

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

GET/rates/latest

Aktuelle Kurse abrufen

Rufen Sie die aktuellen Wechselkurse von der Zentralbank und Schwarzmarktquellen ab

Abfrageparameter
currenciesOptional

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

langOptional

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

Beispielanfrage
cURL
curl "https://lirascope.syria-cloud.sy/api/v1/rates/latest?currencies=USD,EUR&lang=de"
Beispielantwort
JSON
{
  "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": [...]
}
GET/rates/usd-based

USD-Kurse abrufen

Aktuelle Wechselkurse mit USD als Basiswährung abrufen

Abfrageparameter
langOptional

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

Beispielanfrage
cURL
curl "https://lirascope.syria-cloud.sy/api/v1/rates/usd-based?lang=de"
Beispielantwort
JSON
{
  "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
base

Basiswährung (USD)

date

Datum der letzten Kurs-Aktualisierung

rates[].currency

ISO-4217-Währungscode (z. B. EUR, GBP)

rates[].mid

Mittelkurs (Referenzkurs) — 1 USD = X Einheiten

rates[].buy

Aus Marktdaten abgeleiteter Kaufkurs

rates[].sell

Aus Marktdaten abgeleiteter Verkaufskurs

GET/crypto/latest

Aktuelle Krypto-Preise

Erhalten Sie die aktuellen Kryptowährungspreise in USD mit 24-Stunden-Änderungsdaten.

Abfrageparameter
langOptional

Antwortsprache (ar, en, de)

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

Aktuelle Goldpreise

Erhalten Sie die aktuellen Goldpreise in USD mit 24-Stunden-Änderungsdaten.

Abfrageparameter
langOptional

Antwortsprache (ar, en, de)

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

Antwortfelder

disclaimer

Haftungsausschlussmeldung (lokalisiert)

timestampUtc

UTC-Zeitstempel

cbsRates

Zentralbankkurse

marketRates

Marktkurse

effectiveRates

Effektive Kurse (manuelle Überschreibungen oder Markt)

[].currency

Währungscode

[].buy

Kaufkurs

[].sell

Verkaufskurs

[].mid

Mittelkurs

[].timestampUtc

Aktualisierungszeit

[].isManualOverride

Ob es ein manueller Kurs ist

Ratenlimits

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

StufeAuthentifizierungMonatlichPro MinutePro Stunde
Kostenlos (IP)Keine Auth3005100
StarterAPI-Schlüssel erforderlich10,0001001,000
ProfessionalAPI-Schlüssel erforderlich500,00050020,000
EnterpriseAPI-Schlüssel erforderlichUnbegrenztUnbegrenztUnbegrenzt

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

Ratenlimit-Header

Alle API-Antworten enthalten Ratenlimit-Informationen:

HTTP
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:

JSON
{
  "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-Key

Ihr öffentlicher Schlüssel (lsp_pub_...)

X-Api-Secret

Ihr privater Schlüssel (lsp_prv_...)

cURL
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.
GET/client/me

Client-Profil

Zeigen Sie Ihre Kontoinformationen und die Anzahl registrierter Webhooks an.

Beispielantwort
JSON
{
  "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
PUT/client/webhooks/{id}— Webhook aktualisieren
DELETE/client/webhooks/{id}— Webhook löschen
Beispielanfrage
cURL
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 — ABOVE

Auslösen wenn Kurs ≥ Schwellenwert

1 — BELOW

Auslösen wenn Kurs ≤ Schwellenwert

2 — CHANGE_INCREASE

Auslösen bei Kursanstieg um Schwellenwert %

3 — CHANGE_DECREASE

Auslösen bei Kursrückgang um Schwellenwert %

Webhook-Payload

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

Header
HTTP
Content-Type: application/json
X-LiraScope-Signature: sha256=<hex-digest>
X-LiraScope-Event: rate_alert
Beispielantwort
JSON
{
  "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.

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