Loam Customer API · Vista previa

Developer Hub

Comienza aquí para construir sobre la Loam Customer API.

Cinco minutos Inicio rápido Pasa de un cliente API nuevo a una respuesta en vivo: genera un token, consulta los saldos liquidados y luego usa el flujo del marketplace cuando esa capacidad esté habilitada. Sigue el inicio rápido OpenAPI 3.1 Referencia de la API Consulta el contrato publicado endpoint por endpoint — cada scope, esquema de solicitud y de respuesta, y código de error, con un constructor de peticiones para cada ruta. Abre la referencia de la API

Ambos caminos requieren credenciales. Comienza por crear un cliente API.

Una primera solicitud

Una llamada HTTPS con un token Bearer. La autenticación utiliza OAuth 2.0 (client credentials), por lo que no hay redirección que manejar ni SDK que instalar.

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

Qué cubre la API hoy

El acceso en vista previa es deliberadamente más limitado que el contrato publicado. Todo lo siguiente se puede invocar ahora o indica la concesión que está esperando.

Abrir en la vista previa Alcances read y write

  • Operaciones (trades) y sus facturas · Capacidad de marketplace (404 salvo que esté habilitada; requiere pagos + facturación) GET /api/v1/trades
  • Saldos liquidados GET /api/v1/balances
  • Términos de la bóveda de tesorería GET /api/v1/vaults
  • Listados del marketplace · Capacidad de marketplace (404 salvo que esté habilitada; requiere pagos + facturación) GET /api/v1/listings
  • Ofertas, listadas y creadas · Capacidad de marketplace (404 salvo que esté habilitada; requiere pagos + facturación) POST /api/v1/offers
  • Cotizaciones de divisas POST /api/v1/fx/quotes

Cerrado en la vista previa Alcance money.write

  • Pagos a un destino aprobado POST /api/v1/payments
  • Fondos entrantes desde una cuenta bancaria POST /api/v1/onramp
  • Fondos salientes a una cuenta bancaria POST /api/v1/offramp
  • Depósitos y retiros de la bóveda POST /api/v1/vaults/…

El movimiento de dinero requiere que un propietario humano de la organización otorgue el alcance mediante autenticación reforzada, establezca un límite por transacción y apruebe el destino por adelantado. Esos endpoints permanecerán cerrados hasta que termine la vista previa.

Cómo se comporta la API

  • OAuth 2.0

    Concesión de credenciales de cliente

    Intercambia un client id y secret por un token bearer de corta duración con una sola petición codificada como formulario. Los alcances se leen del cliente por petición, por lo que restringir uno se aplica de inmediato.

  • Sobre

    Una misma estructura para todas las rutas

    El éxito es ok luego data; el fallo es ok: false con un código de error legible por máquina.

  • Idempotencia

    Los reintentos no cuestan nada

    Cada escritura requiere un Idempotency-Key. La misma clave con el mismo cuerpo reproduce el primer resultado en lugar de escribir dos veces.

  • Paginación

    Cursores, no desplazamientos

    Las rutas de listado devuelven page.next_cursor. Devuélvelo como cursor hasta que devuelva null.

Elige una ruta desde aquí: el inicio rápido si quieres tener primero una petición funcional; la referencia si ya sabes qué llamada necesitas.

Sigue el inicio rápido Abrir la referencia de la API