# Blockonomics API Documentation > Blockonomics provides Bitcoin and USDT payment processing APIs. This site contains the complete API reference and developer guides. Base URL: https://www.blockonomics.co/api ## Authentication All endpoints require a Bearer token in the Authorization header, except GET /op_return and GET /price (public). Authorization: Bearer YOUR_API_KEY API keys: https://www.blockonomics.co/merchants#/api ## Key facts - Payment notifications arrive as HTTP GET callbacks to your callback URL. Include a secret query parameter in that URL and verify it on every callback. - Callbacks are retried and the same payment arrives several times with an increasing `status`. Make your handler idempotent. - Test Mode is enabled per store and fires real callbacks without real funds. See the Testing guide. ## Guides - [Getting Started](https://developers.blockonomics.co/docs/guides/getting-started.md): Create your Blockonomics account, connect a wallet, get your API key, and start accepting crypto payments. - [Receiving Payments](https://developers.blockonomics.co/docs/guides/receiving-payments.md): Accept BTC and USDT payments on your website using the Blockonomics API — from checkout to confirmed callback. - [Callbacks](https://developers.blockonomics.co/docs/guides/callbacks.md): Receive real-time payment notifications via HTTP callbacks when a payment status changes. - [Testing](https://developers.blockonomics.co/docs/guides/testing.md): Simulate BTC and USDT payments without real funds using Blockonomics Test Mode. - [Sending Bitcoin](https://developers.blockonomics.co/docs/guides/sending-bitcoin.md): Self-hosted wallet service for sending Bitcoin. - [Web3 USDT Component](https://developers.blockonomics.co/docs/guides/web3-usdt-component.md): Embed a ready-made Web3 component that lets customers pay USDT from Chui Wallet or any browser wallet. - [WebSocket Payment Notifications](https://developers.blockonomics.co/docs/guides/websocket-payment-notifications.md): Get real-time notifications when payments arrive at your Bitcoin addresses. No polling required. ## API Reference ### Search - [GET /balance — Get confirmed and unconfirmed balance](https://developers.blockonomics.co/docs/search/getbalance.md): Returns confirmed and unconfirmed balance for one or more Bitcoin addresses or xpubs. - [GET /searchhistory — Get transaction history for wallet addresses](https://developers.blockonomics.co/docs/search/gettransactionhistory.md): Returns the transaction history for one or more Bitcoin addresses or xpubs, treated as a single wallet. - [GET /tx_detail — Get transaction details](https://developers.blockonomics.co/docs/search/gettransactiondetails.md): Returns full details for a Bitcoin transaction including inputs, outputs, fee, size, and RBF status. - [GET /op_return — Search OP_RETURN data](https://developers.blockonomics.co/docs/search/searchopreturn.md): Search Bitcoin transactions by their OP_RETURN payload. ### Wallets - [GET /v2/wallets — List all wallets](https://developers.blockonomics.co/docs/wallets/get_v2-wallets.md): Returns a list of all wallets associated with your Blockonomics account. - [POST /v2/wallets — Add a wallet](https://developers.blockonomics.co/docs/wallets/post_v2-wallets.md): Attach a new wallet to your Blockonomics account. - [GET /v2/wallets/{id} — Get wallet details](https://developers.blockonomics.co/docs/wallets/get_v2-wallets-id.md): Returns details of a specific wallet. - [POST /v2/wallets/{id} — Update a wallet](https://developers.blockonomics.co/docs/wallets/post_v2-wallets-id.md): Update the details of a specific wallet. - [DELETE /v2/wallets/{id} — Delete a wallet](https://developers.blockonomics.co/docs/wallets/delete_v2-wallets-id.md): Remove a wallet from your Blockonomics account. ### Stores - [GET /v2/stores — List all stores](https://developers.blockonomics.co/docs/stores/get_v2-stores.md): Returns a list of all stores associated with your Blockonomics account. - [POST /v2/stores — Create a new store](https://developers.blockonomics.co/docs/stores/post_v2-stores.md): Create a new store in your Blockonomics account. - [GET /v2/stores/{id} — Get store details](https://developers.blockonomics.co/docs/stores/get_v2-stores-id.md): Returns details of a specific store. - [POST /v2/stores/{id} — Update a store](https://developers.blockonomics.co/docs/stores/post_v2-stores-id.md): Update the details of a specific store. - [DELETE /v2/stores/{id} — Delete store](https://developers.blockonomics.co/docs/stores/delete_v2-stores-id.md): Delete a store from your Blockonomics account. - [GET /v2/stores/{id}/wallets — Get store wallets](https://developers.blockonomics.co/docs/stores/get_v2-stores-id-wallets.md): Returns a list of wallets attached to a specific store. - [POST /v2/stores/{id}/wallets — Attach wallet to store](https://developers.blockonomics.co/docs/stores/post_v2-stores-id-wallets.md): Attach an existing wallet in your Blockonomics account to a specific store. - [DELETE /v2/stores/{id}/wallets/{wallet_id} — Detach wallet from store](https://developers.blockonomics.co/docs/stores/delete_v2-stores-id-wallets-wallet-id.md): Detach a wallet from a specific store. ### Merchants - [POST /new_address — Create or Get Payment Address](https://developers.blockonomics.co/docs/merchants/post_new-address.md): Generates a new payment address to receive payment on your store. - [GET /price — Fetch cryptocurrency price](https://developers.blockonomics.co/docs/merchants/get_price.md): Returns the current price of 1 unit of the specified cryptocurrency in a given fiat currency. - [POST /monitor_tx — Monitor USDT Transaction](https://developers.blockonomics.co/docs/merchants/post_monitor-tx.md): Begin tracking a USDT transaction. - [GET /v2/payments — Get payment history](https://developers.blockonomics.co/docs/merchants/getpayments.md): Returns confirmed payments received across all stores, ordered newest-first. ### Payment Buttons and Checkouts - [GET /merchant_orders — Get all orders](https://developers.blockonomics.co/docs/payment-buttons-and-checkouts/get_merchant-orders.md): Returns all payment button orders for your account. - [GET /merchant_order/{uuid} — Get order details](https://developers.blockonomics.co/docs/payment-buttons-and-checkouts/get_merchant-order-uuid.md): Returns details of a specific payment button order. ## Optional - [Full API reference in one file](https://developers.blockonomics.co/llms-full.txt): every endpoint with parameters and responses - [OpenAPI spec](https://developers.blockonomics.co/openapi.json): machine-readable spec - [API Overview](https://developers.blockonomics.co/docs)