Welcome to the Wallbit API
Wallbit is a global neobank and the world’s first to offer a public API for complete programmatic control of your account. Access your US account balances, manage investments in ETFs, stocks and bonds, view transaction history, execute trades, and manage crypto wallets. All through code.OpenAPI Specification
View the complete OpenAPI specification file
Base URL
All API requests should be made to:Authentication
All API endpoints require authentication using an API Key. Include your API key in theX-API-Key header with every request.
Getting your API Key
- Log in to your Wallbit account (in the app or in the Wallbit Dashboard)
- Navigate to Settings → API Keys
- Create a new API key with the appropriate permissions
Permissions
API keys can have different permission levels:| Permission | Description |
|---|---|
read | Read account balances, transactions, and asset information |
trade | Execute buy/sell trades |
Rate Limiting
The API implements rate limiting to ensure fair usage. When you exceed the rate limit, you’ll receive a429 Too Many Requests response.
| Header | Description |
|---|---|
X-RateLimit-Limit | Total requests allowed per minute |
X-RateLimit-Remaining | Requests remaining in current window |
X-RateLimit-Reset | Unix timestamp when rate limit resets |
Retry-After | Seconds to wait before retrying |
Error Handling
The API uses standard HTTP status codes to indicate success or failure:| Code | Description |
|---|---|
200 | Success |
400 | Bad request - Invalid parameters |
401 | Unauthorized - Missing or invalid API key |
403 | Forbidden - Insufficient permissions |
404 | Not found - Resource doesn’t exist |
412 | Precondition failed - KYC incomplete or account locked |
422 | Validation error - Invalid data |
429 | Too many requests - Rate limit exceeded |
500 | Server error |
Available Endpoints
Balance
Query checking and investment account balances
Transactions
View transaction history with filters
Trades
Execute buy and sell orders for stocks
Account Details
Get bank account details for deposits
Wallets
Retrieve crypto wallet addresses
Assets
Browse available stocks and ETFs
API Key
Revoke the current API key