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 langsung: mencetak token, membaca saldo yang telah terselesaikan, lalu meminta kuotasi valuta asing. Alur marketplace disertakan ketika fitur 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.

Pembayaran yang dapat Anda baca hari ini

Daftar pembayaran organisasi menggunakan token bearer. Halaman kosong berarti sukses — belum ada yang tercatat. Mengirim uang adalah panggilan berbeda: membutuhkan scope money.write, pemberian izin pemilik melalui autentikasi step-up, serta tujuan yang disetujui, dan panggilan ini tetap tidak tersedia di pratinjau.

GET /api/v1/payments
curl -H "Authorization: Bearer $LOAM_TOKEN" \  "$LOAM_API_BASE/payments"// Response
{
  "ok": true,
  "data": [
    {
      "id": "c4d8e2f0-1a3b-45cd-8e9f-0a1b2c3d4e5f",
      "state": "settled",
      "source_kind": "wallet_transfer",
      "fiat_amount": 2500000,
      "fiat_currency": "USD",
      "crypto_amount": null,
      "crypto_currency": null,
      "trade_id": null,
      "created_at": "2026-07-14T09:12:04.118Z",
      "updated_at": "2026-07-14T09:14:11.004Z",
      "settled_at": "2026-07-14T09:14:11.004Z",
      "failed_at": null
    }
  ],
  "page": { "next_cursor": null }
}

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

  • Saldo yang telah diselesaikan GET /api/v1/balances
  • Pembayaran, tercantum GET /api/v1/payments
  • Istilah brankas treasury GET /api/v1/vaults
  • 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