Loam Customer API · Preview

Developer Hub

Begin hier om te bouwen op de Loam Customer API.

Vijf minuten Quickstart Ga van een nieuwe API-client naar een live-respons: maak een token aan, lees verrekende saldi en gebruik daarna de marketplace-flow wanneer die functionaliteit is ingeschakeld. Volg de quickstart OpenAPI 3.1 API-referentie Lees het gepubliceerde contract endpoint voor endpoint — elke scope, request- en response-schema, en foutcodes, met een request-builder voor elke route. Open de API-referentie

Beide paden hebben referenties nodig. Begin met het aanmaken van een API-client.

Een eerste verzoek

Een HTTPS-aanroep met een bearer-token. Authenticatie gebeurt via OAuth 2.0 client credentials, dus er is geen redirect om af te handelen en geen SDK om te installeren.

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

Wat de API vandaag dekt

Preview-toegang is opzettelijk beperkter dan het gepubliceerde contract. Alles hieronder is nu aanroepbaar of vermeldt welke machtiging het nog verwacht.

Openen in preview Scopes read en write

  • Trades en hun facturen · Marketplace-functionaliteit (404 tenzij ingeschakeld; vereist betalingen en facturering) GET /api/v1/trades
  • Afgewikkelde saldi GET /api/v1/balances
  • Voorwaarden voor de treasury-kluis GET /api/v1/vaults
  • Marketplace-vermeldingen · Marketplace-functionaliteit (404 tenzij ingeschakeld; vereist betalingen en facturering) GET /api/v1/listings
  • Aanbiedingen, gepubliceerd en aangemaakt · Marketplace-functionaliteit (404 tenzij ingeschakeld; vereist betalingen en facturering) POST /api/v1/offers
  • Wisselkoersen POST /api/v1/fx/quotes

Gesloten in preview Scope money.write

  • Betalingen naar een goedgekeurde bestemming POST /api/v1/payments
  • Ontvangst van gelden vanaf een bankrekening POST /api/v1/onramp
  • Uitgaande betalingen naar een bankrekening POST /api/v1/offramp
  • Stortingen en opnames in de kluis POST /api/v1/vaults/…

Geldverplaatsingen vereisen dat een menselijke eigenaar van de organisatie de scope verleent onder step-up-authenticatie, een limiet per transactie instelt en de bestemming vooraf goedkeurt. Die eindpunten blijven gesloten totdat de preview eindigt.

Hoe de API zich gedraagt

  • OAuth 2.0

    Client credentials-grant

    Ruil een client-id en secret in voor een kortlevende bearer-token met één form-gecodeerd verzoek. Scopes worden per verzoek uit de client gelezen, dus het vernauwen van een scope geldt direct.

  • Envelop

    Één vorm voor elke route

    Succes is ok en daarna data; fout is ok: false met een machinaal leesbare foutcode.

  • Idempotentie

    Herhalingen kosten niets

    Elke schrijfactie vereist een Idempotency-Key. Dezelfde key met dezelfde body geeft het eerste resultaat terug in plaats van twee keer te schrijven.

  • Paginering

    Cursors, geen offsets

    Lijstroutes geven page.next_cursor terug. Geef het terug als cursor totdat het null wordt.

Kies vanaf hier een pad: de quickstart als je eerst een werkend verzoek wilt, de referentie als je de benodigde aanroep al kent.

Volg de quickstart Open de API-referentie