Loam Customer API · Vorschau

Entwickler-Hub

Beginnen Sie hier, um auf der Loam Customer API aufzubauen.

Fünf Minuten Schnellstart Vom neuen API-Client zur Live-Antwort: Token erstellen, abgewickelte Salden lesen und anschließend den Marktplatz‑Flow nutzen, wenn diese Funktion aktiviert ist. Folgen Sie dem Schnellstart OpenAPI 3.1 API-Referenz Lesen Sie den veröffentlichten Contract Endpunkt für Endpunkt — alle Scopes, Request- und Response‑Schemata sowie Fehlercodes, mit einem Request‑Builder für jede Route. API-Referenz öffnen

Beide Pfade benötigen Zugangsdaten. Beginnen Sie mit dem Erstellen eines API-Clients.

Eine erste Anfrage

Ein HTTPS-Aufruf mit einem Bearer-Token. Die Authentifizierung erfolgt über OAuth 2.0 Client Credentials, sodass kein Redirect zu behandeln ist und kein SDK installiert werden muss.

GET /api/v1/balances
curl --fail-with-body --silent --show-error \  --header "Authorization: Bearer $LOAM_TOKEN" \  "$LOAM_API_BASE/balances" | jq# Response{  "ok": true,  "data": [    {      "account_id": "6f9619ff-8b86-d011-b42d-00c04fc964ff",      "balance": 4250000,      "currency": "USD",      "last_settled_at": "2026-07-14T09:12:04.118Z"    }  ]}

Was die API heute abdeckt

Der Preview‑Zugang ist bewusst enger gefasst als der veröffentlichte Kontrakt. Alles unten ist jetzt aufrufbar oder nennt die Berechtigung, auf deren Erteilung noch gewartet wird.

In Vorschau öffnen Scopes read und write

  • Handelsgeschäfte und deren Rechnungen · Marktplatz‑Funktion (404, sofern nicht aktiviert; erfordert Zahlungen + Rechnungsstellung) GET /api/v1/trades
  • Abgewickelte Salden GET /api/v1/balances
  • Begriffe zum Treasury‑Vault GET /api/v1/vaults
  • Marktplatz‑Einträge · Marktplatz‑Funktion (404, sofern nicht aktiviert; erfordert Zahlungen + Rechnungsstellung) GET /api/v1/listings
  • Angebote, gelistet und erstellt · Marktplatz‑Funktion (404, sofern nicht aktiviert; erfordert Zahlungen + Rechnungsstellung) POST /api/v1/offers
  • Devisenkurse POST /api/v1/fx/quotes

In Vorschau geschlossen Scope money.write

  • Zahlungen an ein genehmigtes Ziel POST /api/v1/payments
  • Geldeingang von einem Bankkonto POST /api/v1/onramp
  • Auszahlungen auf ein Bankkonto POST /api/v1/offramp
  • Ein- und Auszahlungen im Vault POST /api/v1/vaults/…

Geldbewegungen erfordern, dass der menschliche Organisationsinhaber den Scope unter Step‑Up‑Authentifizierung gewährt, ein Transaktionslimit setzt und das Ziel im Voraus genehmigt. Diese Endpunkte bleiben geschlossen, bis die Vorschau endet.

Wie sich die API verhält

  • OAuth 2.0

    Client‑Credentials‑Grant

    Tauschen Sie eine Client‑ID und ein Secret gegen ein kurzlebiges Bearer‑Token mit einer formkodierten Anfrage aus. Scopes werden pro Anfrage aus dem Client gelesen, sodass eine Einschränkung sofort wirkt.

  • Umschlag

    Eine einheitliche Struktur für jede Route

    Erfolg ist ok dann data; Fehler ist ok: false mit einem maschinenlesbaren Fehlercode.

  • Idempotenz

    Wiederholungen kosten nichts

    Jeder Schreibvorgang erfordert einen Idempotency-Key. Derselbe Schlüssel mit demselben Body gibt das erste Ergebnis erneut zurück, anstatt zweimal zu schreiben.

  • Paginierung

    Cursors statt Offsets

    List‑Routen liefern page.next_cursor. Geben Sie es als cursor zurück, bis es null ist.

Wählen Sie einen Weg von hier: den Schnellstart, wenn Sie zuerst eine funktionierende Anfrage vor sich haben möchten; die Referenz, wenn Sie bereits wissen, welchen Aufruf Sie benötigen.

Folgen Sie dem Schnellstart API-Referenz öffnen