Loam Customer API · Pratinjau

Pusat Pengembang

Mulai di sini untuk membangun di atas Loam Customer API.

Lima menit Panduan cepat Berpindah dari klien API baru ke respons nyata: buat token, baca saldo yang sudah diselesaikan, lalu gunakan alur marketplace saat kemampuan tersebut diaktifkan. Ikuti panduan cepat OpenAPI 3.1 Referensi API Baca kontrak yang dipublikasikan per endpoint — setiap scope, skema permintaan dan respons, serta kode kesalahan, dengan pembuat permintaan untuk tiap rute. Buka referensi API

Kedua jalur memerlukan kredensial. Mulailah dengan membuat klien API.

Permintaan pertama

Satu panggilan HTTPS dengan bearer token. Autentikasi menggunakan OAuth 2.0 client credentials, jadi tidak ada redirect yang perlu ditangani dan tidak perlu memasang SDK.

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

Apa yang dicakup API hari ini

Akses pratinjau sengaja lebih terbatas dibandingkan kontrak yang dipublikasikan. Semua yang tercantum di bawah dapat dipanggil sekarang atau menyebutkan izin yang sedang ditunggu.

Buka di pratinjau Izin read dan write

  • Perdagangan dan faktur terkait · Kemampuan marketplace (404 kecuali diaktifkan; membutuhkan pembayaran + penagihan) GET /api/v1/trades
  • Saldo yang telah diselesaikan GET /api/v1/balances
  • Istilah brankas treasury GET /api/v1/vaults
  • Listing di marketplace · Kemampuan marketplace (404 kecuali diaktifkan; membutuhkan pembayaran + penagihan) GET /api/v1/listings
  • Penawaran, yang terdaftar dan yang dibuat · Kemampuan marketplace (404 kecuali diaktifkan; membutuhkan pembayaran + penagihan) POST /api/v1/offers
  • Kutipan valuta asing POST /api/v1/fx/quotes

Tertutup selama pratinjau Izin money.write

  • Pembayaran ke tujuan yang disetujui POST /api/v1/payments
  • Dana masuk dari rekening bank POST /api/v1/onramp
  • Dana keluar ke rekening bank POST /api/v1/offramp
  • Setoran dan penarikan brankas POST /api/v1/vaults/…

Pergerakan dana memerlukan pemilik organisasi manusia untuk memberikan izin di bawah autentikasi step-up, menetapkan batas per transaksi, dan menyetujui tujuan sebelumnya. Endpoint tersebut tetap tertutup sampai pratinjau berakhir.

Bagaimana API berfungsi

  • OAuth 2.0

    Grant kredensial klien

    Tukar client id dan secret dengan token bearer berdurasi singkat melalui satu permintaan form-encoded. Scope dibaca dari klien setiap permintaan, jadi mempersempitnya berlaku segera.

  • Amplop

    Satu format untuk setiap rute

    Sukses adalah ok lalu data; kegagalan adalah ok: false dengan kode kesalahan yang dapat dibaca mesin.

  • Idempotensi

    Percobaan ulang tidak dikenakan biaya

    Setiap operasi tulis memerlukan Idempotency-Key. Kunci yang sama dengan body yang sama akan memutar ulang hasil pertama alih-alih menulis dua kali.

  • Paginasi

    Kursor, bukan offset

    Rute daftar mengembalikan page.next_cursor. Kirim kembali sebagai cursor sampai nilainya menjadi null.

Pilih jalur dari sini: panduan cepat jika Anda ingin memiliki permintaan yang berfungsi terlebih dahulu, atau referensi jika Anda sudah tahu panggilan yang Anda perlukan.

Ikuti panduan cepat Buka referensi API