Skip to main content
Bienvenido a la referencia de pan API. Esta documentación describe todos los endpoints disponibles, formatos de request/response, códigos de error, y métodos de autenticación.

​
URL Base

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

​
Autenticación

Todos los endpoints requieren autenticación 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 código del lado del cliente o repositorios publicos. Ver guia de autenticación.

​
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: Métodos 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"
  }
}

​
Códigos HTTP

pan API usa códigos HTTP estandar:
CódigoSignificadoDescripción
200OKRequest exitoso
201CreatedRecurso creado
400Bad RequestRequest inválido
401UnauthorizedAPI key faltante o inválida
403ForbiddenLímite 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

MétodoEndpointDescripción
POST/walletsCrear wallet
GET/wallets/:userIdObtener wallet por userId
GET/balances/:walletIdObtener balances

​
Intents

MétodoEndpointDescripción
POST/intentsCrear intent
GET/intents/:intentIdObtener estado de intent

​
Yields

MétodoEndpointDescripción
GET/yieldsObtener APYs disponibles

​
Demo

MétodoEndpointDescripción
POST/demo/fundFondear wallet de prueba

​
Rate Limits

Los rate limits dependen de tu plan de suscripción:
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

​
Créditos

Cada request consume créditos de tu cuenta:
EndpointCréditos
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

Email

support@pan.tech