Documentation Index
Fetch the complete documentation index at: https://developer.wallbit.io/docs/llms.txt
Use this file to discover all available pages before exploring further.
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, assets, fiat exchange rates, and fee configuration |
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
Fees
Stock trading fees by subscription tier
Account Details
Get bank account details for deposits
Wallets
Retrieve crypto wallet addresses
Rates
Fiat exchange rates between currency pairs
Assets
Browse available stocks and ETFs
Operations
Move funds between checking and investment accounts
Robo Advisor
Chests portfolios, deposits, and withdrawals
Cards
List cards and update card status
API Key
Revoke the current API key