Skip to main content

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:
https://api.wallbit.io

Authentication

All API endpoints require authentication using an API Key. Include your API key in the X-API-Key header with every request.
curl -X GET "https://api.wallbit.io/api/public/v1/balance/checking" \
  -H "X-API-Key: your_api_key_here"
Never share your API key or commit it to version control. Keep it secure and rotate it regularly.

Getting your API Key

  1. Log in to your Wallbit account (in the app or in the Wallbit Dashboard)
  2. Navigate to Settings → API Keys
  3. Create a new API key with the appropriate permissions

Permissions

API keys can have different permission levels:
PermissionDescription
readRead account balances, transactions, and asset information
tradeExecute buy/sell trades

Rate Limiting

The API implements rate limiting to ensure fair usage. When you exceed the rate limit, you’ll receive a 429 Too Many Requests response.
HeaderDescription
X-RateLimit-LimitTotal requests allowed per minute
X-RateLimit-RemainingRequests remaining in current window
X-RateLimit-ResetUnix timestamp when rate limit resets
Retry-AfterSeconds to wait before retrying

Error Handling

The API uses standard HTTP status codes to indicate success or failure:
CodeDescription
200Success
400Bad request - Invalid parameters
401Unauthorized - Missing or invalid API key
403Forbidden - Insufficient permissions
404Not found - Resource doesn’t exist
412Precondition failed - KYC incomplete or account locked
422Validation error - Invalid data
429Too many requests - Rate limit exceeded
500Server error

Available Endpoints