Skip to main content
Bienvenido a la referencia de Pan API. Esta documentacion describe todos los endpoints disponibles, formatos de request/response, codigos de error, y metodos de autenticacion.

​
URL Base

Todas las requests deben hacerse a: 
https://api.pan.dev/v1
Entorno de staging: Para pruebas, usa https://api-staging.pan.dev/v1. Staging usa solo testnets y esta aislado de produccion.

​
Autenticacion

Todos los endpoints requieren autenticacion usando una API key. Incluye tu API key en el header Authorization: 
Authorization: Bearer pan_sk_tu_api_key
Manten tu API key secreta. Nunca la expongas en codigo del lado del cliente o repositorios publicos. Ver guia de autenticacion.

​
Versionado

Pan API usa versionado basado en URL. La version actual es v1, incluida en la URL base. Versiones futuras usaran paths diferentes (ej. /v2/) para mantener compatibilidad hacia atras.

​
Formato de Requests

Todas las requests deben usar:
  • Metodo: Metodos HTTP (GET, POST, etc.)
  • Content-Type: application/json para bodies
  • Encoding: UTF-8

​
Formato de Respuestas

Todas las respuestas retornan JSON:
Respuestas exitosas (codigos 2xx) retornan el recurso directamente:
{
  "id": "pan_wallet_abc123",
  "userId": "usuario_123",
  "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  ...
}
Respuestas de error (codigos 4xx, 5xx) retornan un objeto error:
{
  "error": "ERROR_CODE",
  "message": "Mensaje legible para humanos",
  "details": {
    "campo": "valor"
  }
}

​
Codigos HTTP

Pan API usa codigos HTTP estandar:
CodigoSignificadoDescripcion
200OKRequest exitoso
201CreatedRecurso creado
400Bad RequestRequest invalido
401UnauthorizedAPI key faltante o invalida
403ForbiddenLimite de recursos excedido
404Not FoundRecurso no existe
429Too Many RequestsRate limit excedido
500Internal Server ErrorError del servidor
503Service UnavailableServicio temporalmente no disponible

​
Resumen de Endpoints

​
Wallets

MetodoEndpointDescripcion
POST/walletsCrear wallet
GET/wallets/:userIdObtener wallet por userId
GET/balances/:walletIdObtener balances

​
Intents

MetodoEndpointDescripcion
POST/intentsCrear intent
GET/intents/:intentIdObtener estado de intent

​
Yields

MetodoEndpointDescripcion
GET/yieldsObtener APYs disponibles

​
Demo

MetodoEndpointDescripcion
POST/demo/fundFondear wallet de prueba

​
Rate Limits

Los rate limits dependen de tu plan de suscripcion:
PlanRequests por minutoWallets maximas
Free100100
Pro1,00010,000
EnterpriseCustomIlimitadas
Cuando excedes el rate limit, recibiras un 429 Too Many Requests: 
Retry-After: 60
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1642248000

​
Creditos

Cada request consume creditos de tu cuenta:
EndpointCreditos
POST /wallets1
GET /wallets/:id1
GET /balances/:id1
GET /yields1
POST /intents5
GET /intents/:id1

​
SDKs Oficiales

SDK JavaScript/TypeScript

SDK oficial con soporte TypeScript completo

Python SDK

SDK oficial con soporte async
Los SDKs son opcionales. Puedes usar cualquier cliente HTTP para interactuar con Pan API. Todos los endpoints son REST estandar.

​
Soporte