Skip to main content

​
API Key

El metodo principal de autenticacion es usando una API key en el header Authorization: 
Authorization: Bearer pan_sk_tu_api_key

​
Ejemplo

curl -X GET https://api.pan.dev/v1/yields \
  -H "Authorization: Bearer pan_sk_a1b2c3d4e5f6..."

​
Formato de API Key

pan_sk_a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456
  • Prefijo: pan_sk_
  • Longitud: 64 caracteres hexadecimales

​
Obtener API Key

  1. Registrate en app.pan.dev
  2. Ve a Settings > API Keys
  3. Click en Create New Key
  4. Copia la key inmediatamente
La API key solo se muestra una vez. Guardala de forma segura.

​
X402 Protocol

Para endpoints de solo lectura, puedes usar el protocolo X402 de micropagos:
HeaderValor
X-Payment-ProofProof de pago en USDC

​
Endpoints Soportados

EndpointX402
GET /wallets/:userIdSi
GET /balances/:walletIdSi
GET /yieldsSi
GET /intents/:intentIdSi
POST /walletsNo
POST /intentsNo

​
Costo

$0.001 USD por request en USDC (Base, Ethereum, o Sei)

​
Errores de Autenticacion

​
401 Unauthorized

{
  "error": "UNAUTHORIZED",
  "message": "Invalid or missing API key"
}
Causas:
  • API key no incluida
  • API key mal formateada
  • API key revocada

​
403 Forbidden

{
  "error": "FORBIDDEN",
  "message": "Wallet limit exceeded for your plan"
}
Causas:
  • Limite de plan excedido
  • Creditos agotados
  • Acceso a recurso no permitido

​
Mejores Practicas

Usa variables de entorno

export PAN_API_KEY=pan_sk_...

No commitees la key

.env
.env.local

Rota periodicamente

Crea nuevas keys cada 90 dias

Keys por entorno

Usa keys separadas para dev/staging/prod