Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.pan.tech/llms.txt

Use this file to discover all available pages before exploring further.

Crea una nueva wallet para un usuario de tu aplicación.

​
Endpoint

POST https://api.pan.tech/v1/wallets

​
Autenticación

Solo API Key. X402 no soportado para operaciones de escritura.

​
Request

​
Headers

HeaderValor
AuthorizationBearer pan_sk_...
Content-Typeapplication/json

​
Body

{
  "userId": "usuario_123",
  "chainType": "ethereum",
  "email": "usuario@ejemplo.com",
  "metadata": {
    "nombre": "Juan Perez",
    "plan": "premium"
  }
}

​
Parámetros

CampoTipoRequeridoDescripción
userIdstringSiID único del usuario en tu app
chainTypestringNoethereum (default) o tron
emailstringNoEmail para notificaciones
metadataobjectNoDatos adicionales (JSON)

​
Response

​
201 Created

{
  "id": "pan_wallet_a1b2c3d4e5f6",
  "userId": "usuario_123",
  "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  "chainType": "ethereum",
  "chains": [
    "ethereum",
    "ethereum-sepolia",
    "arbitrum",
    "arbitrum-sepolia",
    "base",
    "base-sepolia"
  ],
  "metadata": {
    "nombre": "Juan Perez",
    "plan": "premium"
  },
  "createdAt": "2024-01-15T10:30:00Z"
}

​
Errores

CódigoErrorDescripción
400INVALID_REQUESTBody inválido
401UNAUTHORIZEDAPI key inválida
403WALLET_LIMIT_EXCEEDEDLímite de wallets del plan
409WALLET_ALREADY_EXISTSUsuario ya tiene wallet

​
Ejemplos

curl -X POST https://api.pan.tech/v1/wallets \
  -H "Authorization: Bearer $PAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "usuario_123",
    "metadata": {"nombre": "Juan Perez"}
  }'