Fondea una wallet con tokens de testnet para pruebas.
Solo funciona en testnet. No disponible en produccion.
Endpoint
POST https://api.pan.dev/v1/demo/fund
Autenticacion
API Key
Request
{
"walletId": "pan_wallet_abc123"
}
Parametros
| Campo | Tipo | Requerido | Descripcion |
|---|
walletId | string | Si | ID de la wallet Pan |
La cantidad y chain son fijos: 1 USDC en arbitrum-sepolia. Esto es para evitar abuso del faucet.
Response
200 OK
{
"success": true,
"walletId": "pan_wallet_abc123",
"amount": 1,
"chain": "arbitrum-sepolia",
"asset": "USDC",
"txHash": "0x123abc...",
"explorerUrl": "https://sepolia.arbiscan.io/tx/0x123abc..."
}
Campos de Respuesta
| Campo | Tipo | Descripcion |
|---|
success | boolean | Siempre true si exitoso |
walletId | string | ID de la wallet fondeada |
amount | number | Cantidad enviada (1 USDC) |
chain | string | Chain usada (arbitrum-sepolia) |
asset | string | Token enviado (USDC) |
txHash | string | Hash de la transaccion |
explorerUrl | string | Link al block explorer |
Errores
| Codigo | Error | Descripcion |
|---|
| 401 | UNAUTHORIZED | API key invalida |
| 404 | WALLET_NOT_FOUND | Wallet no existe |
| 429 | RATE_LIMITED | Espera 60 segundos entre requests |
| 500 | FUNDING_FAILED | Error al enviar fondos |
Ejemplos
curl -X POST https://api.pan.dev/v1/demo/fund \
-H "Authorization: Bearer $PAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"walletId": "pan_wallet_abc123"
}'
Rate Limiting
| Escenario | Respuesta |
|---|
| Dentro del limite | 200 OK + txHash |
| Rate limited | 429 Too Many Requests - esperar 60 segundos |
Notas
- Rate limit: 1 request por wallet cada 60 segundos
- Cantidad fija: 1 USDC por request
- Chain fija: arbitrum-sepolia
- Solo desarrollo: No disponible en produccion
- Los fondos llegan casi instantaneamente (~10-30 segundos)
