v1.0Blockonomics 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.
API Reference
Search
Look up Bitcoin addresses, transaction histories, balances, and OP_RETURN data directly on the blockchain.
Wallets
Add and manage xPub (BTC) or EVM (USDT) wallets, track balances, and configure wallet settings.
Stores
Create and manage merchant stores, configure callback URLs, and attach wallets to accept Bitcoin payments.
Merchants
Generate payment addresses, track incoming payments, monitor USDT transactions, and fetch live Bitcoin prices.
Payment Buttons and Checkouts
Embed payment buttons and hosted checkout flows to accept Bitcoin in your website or app.
Payment Intents
List, create or get payment intent details.
Payer API
The payer's half of Payment Intents. Public endpoints called with only the intent ID. Check what is due, get crypto address and amount to pay, and submit USDT transaction hash.
Machine-readable formats
The full reference is published in formats built for tooling and AI assistants.
- llms.txtIndex of every endpoint and guide.
- llms-full.txtComplete reference as plain text.
- openapi.jsonRaw OpenAPI 3 specification.
Guides
Getting Started
Create your Blockonomics account, connect a wallet, get your API key, and start accepting crypto payments.
Receiving Payments
Unified API to accept crypto payments on your website. One crypto-agnostic interface, built for both humans and AI agents.
Raw Payments API
Low-level address, price and transaction-monitoring endpoints for special cases, such as a permanent deposit address per user. For a normal checkout, use Receiving Payments.
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 Chui Wallet or any browser wallet.