Referencias

Límites

Tamaños máximos, valores por defecto y lo que todavía no está implementado.

Todavía no hay límite de peticiones

La API no limita aún el número de peticiones por clave ni devuelve 429. Está previsto antes de producción. Integra como si existiera: usa webhooks en lugar de consultar en bucle y trata un 429 como reintentable.

Peticiones#

Límite	Valor
Tamaño del cuerpo de una petición	64 KB
`external_id`	1 a 200 caracteres
`label` de una clave de API	Hasta 80 caracteres
`name` de una empresa	1 a 120 caracteres
`search` en listados	Hasta 200 caracteres
`type` al filtrar eventos	Hasta 60 caracteres
`limit` en clientes y depósitos	1 a 200 (por defecto 50)
`limit` en eventos	1 a 200 (por defecto 100)
`days` en resúmenes	1 a 365 (por defecto 30)
Depósitos en `/v1/customers/{id}/deposits`	Los últimos 100, sin paginación
Depósitos en `/pay/{id}/status`	Los últimos 10

Condiciones de la empresa#

Campo	Rango	Por defecto
`platform_fee_bps`	0 a 10000	100 (1 %)
`merchant_fee_bps`	0 a 10000	0
`merchant_fee_base`	`gross` o `net`	`gross`
`gas_mode`	`platform`, `merchant` o `customer`	`platform`
`min_deposit`	0 o más (USD)	0.5
`confirmations`	0 a 10000 bloques	4

Depósitos y gas#

Límite	Valor
Monto máximo de un depósito	Sin límite
Monto mínimo	`min_deposit` de la empresa; por debajo queda `below_minimum`
Decimales de un monto	Los del token (6 en USDT; 8 en el USDC de pruebas)
Gas descontado por barrido	Hasta 0.50 USD por token
Margen sobre el gas estimado	10 %
Garantía del gas de una cotización	15 minutos, solo con `customer_id`
Clientes por empresa	Sin límite

Webhooks#

Límite	Valor
Tiempo máximo de respuesta de tu servidor	10 segundos
Intentos por envío	13 (el primero y 12 reintentos), a lo largo de unos 3 días
Antigüedad máxima de la firma que debes aceptar	5 minutos
Redirecciones	No se siguen: un `3xx` cuenta como fallo
URL de webhooks por empresa	Una

Lo que aún no existe#

Límite de peticiones por clave. Pendiente.
Cabecera de idempotencia general. No hay Idempotency-Key. Ver Peticiones repetidas.
Cobros con monto fijo y vencimiento. Las direcciones aceptan cualquier monto en cualquier momento.
Filtrar qué eventos recibe el webhook o tener varias URL. Llegan todos a la única URL.
Cambiar las billeteras por la API. La tesorería y la billetera de comisiones solo se cambian en el contrato, con la billetera admin de la empresa.
Depósitos por otras redes. Solo Arbitrum.
Auditoría externa de los contratos. Pendiente. Ver Sin custodia.