API Documentation
Comprehensive guide to integrating with our secure blockchain custody platform.
Authentication
All API requests must include an Authorization header with a Bearer token.
POST https://api.wallett.network/v1/transactions
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"action": "send",
"amount": "0.5",
"recipient": "bc1qar0sdj76lknx0x643jqgj0jegmqf2v7tj7756r"
}
Token Generation
1. Create an app in your dashboard
2. Request a new API key
3. Store securely with environment variables
curl -X POST https://api.wallett.network/v1/auth/token \
-H "Content-Type: application/json" \
-d '{"client_id": "your_client_id", "client_secret": "your_client_secret"}'
Available Endpoints
Wallet Management
Create, monitor, and manage custody wallets with full transaction history access.
GET /v1/wallets/{wallet_id}
POST /v1/wallets
DELETE /v1/wallets/{wallet_id}
Transactions
Execute, verify, and monitor blockchain transactions with atomic operations.
POST /v1/transactions
GET /v1/transactions/{txid}
GET /v1/wallets/{wallet_id}/history
Security Operations
Verify transaction signatures, rotate keys, and manage biometric enrollment.
POST /v1/keys/rotate
GET /v1/wallets/{wallet_id}/signatures
POST /v1/biometrics/enroll
Analytics API
Access portfolio insights, transaction patterns, and risk metrics.
GET /v1/analytics/portfolio
GET /v1/analytics/transactions
GET /v1/analytics/risk
Error Handling
| Status Code | Error Type | Description |
|---|---|---|
| 401 Unauthorized | Authentication Required | Invalid/missing Bearer token |
| 404 Not Found | Invalid Request | Requested resource does not exist |
| 503 Service Unavailable | Maintenance Mode | System maintenance in progress |
Rate Limiting
1000 RPS
Standard API Tier
5000 RPS
Enterprise Tier
20,000 RPS
Whitelisted Tier
Headers: X-RateLimit-Remaining and X-RateLimit-Reset
Webhooks
Receive real-time notifications for transactions, balance changes, and security events.
POST /webhook-endpoint-url
Content-Type: application/json
{
"event": "wallet_balance_change",
"wallet_id": "1a2b3c",
"timestamp": "2025-04-05T14:30:00Z"
}