Blockonomics API
Accept Bitcoin payments, track addresses, manage wallets and stores — all through a single, straightforward API.
Base URL
https://www.blockonomics.co/apiErrors
The API uses standard HTTP status codes. Errors return JSON with a message field describing the problem.
200OK
Request succeeded.
400Bad Request
Missing or invalid parameters.
401Unauthorized
API key missing or invalid.
403Forbidden
Authenticated but not permitted.
404Not Found
Resource does not exist.
429Too Many Requests
Rate limit exceeded. Retry after the indicated delay.
500Server Error
Something went wrong on our end.
Guides
Getting Started
Create your Blockonomics account, connect a wallet, get your API key, and start accepting crypto payments.
Receiving Payments
Accept BTC and USDT payments on your website using the Blockonomics API — from checkout to confirmed callback.
Callbacks
Receive real-time payment notifications via HTTP callbacks when a payment status changes.
Testing
Simulate BTC and USDT payments without real funds using Blockonomics Test Mode.
Sending Bitcoin
Self-hosted wallet service for sending Bitcoin.
Web3 USDT Component
Embed a ready-made Web3 component that lets customers pay USDT from MetaMask or any browser wallet.
WebSocket Payment Notifications
Get real-time notifications when payments arrive at your Bitcoin addresses. No polling required.