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.

Una primera cotización

Una escritura HTTPS con un token bearer y una clave de idempotencia. La cotización bloquea una tasa del proveedor — 10,000 unidades menores USD a 9,125 EUR en el ejemplo — y no mueve fondos.

POST /api/v1/fx/quotes
curl --fail-with-body --silent --show-error \  --request POST "$LOAM_API_BASE/fx/quotes" \  --header "Authorization: Bearer $LOAM_TOKEN" \  --header "Content-Type: application/json" \  --header "Idempotency-Key: $(uuidgen | tr '[:upper:]' '[:lower:]')" \  --data '{"from_currency":"USD","to_currency":"EUR","amount":10000}'// Response
HTTP/1.1 202 Accepted
Location: /api/v1/fx/quotes/a6bbdbeb-ed3b-42cb-85b1-af3112f2fe06

{
  "ok": true,
  "data": {
    "id": "a6bbdbeb-ed3b-42cb-85b1-af3112f2fe06",
    "from_amount": 10000,
    "from_currency": "USD",
    "to_amount": 9125,
    "to_currency": "EUR",
    "rate_decimal": "0.9125",
    "fee_amount": -25,
    "fee_currency": "USD",
    "expires_at": "2099-08-14T16:35:00.000Z",
    "state": "active"
  }
}

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