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: acuña un token, consulta los saldos liquidados y solicita una cotización de cambio. El flujo del marketplace se incluye 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.

Pagos que puedes consultar hoy

Enumera los pagos de la organización con un token portador. Una página vacía es un éxito: aún no se ha registrado nada. Enviar dinero es otra llamada: requiere el ámbito money.write, una concesión del propietario mediante autenticación reforzada y un destino aprobado, y permanece cerrado en vista previa.

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

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

  • Saldos liquidados GET /api/v1/balances
  • Pagos, listados GET /api/v1/payments
  • Términos de la bóveda de tesorería GET /api/v1/vaults
  • 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