# Blockonomics API Documentation

> Blockonomics provides Bitcoin payment processing APIs. This site contains the complete API reference and developer guides.

Base URL: https://www.blockonomics.co/api

## Authentication

All authenticated endpoints require a Bearer token in the Authorization header:
Authorization: Bearer YOUR_API_KEY

## API Reference

- [GET /balance — Get confirmed and unconfirmed balance](https://developers.blockonomics.co/docs/search/getbalance)
- [GET /searchhistory — Get transaction history for wallet addresses](https://developers.blockonomics.co/docs/search/gettransactionhistory)
- [GET /tx_detail — Get transaction details](https://developers.blockonomics.co/docs/search/gettransactiondetails)
- [GET /op_return — Search OP_RETURN data](https://developers.blockonomics.co/docs/search/searchopreturn)
- [GET /v2/wallets — List all wallets](https://developers.blockonomics.co/docs/wallets/get_v2-wallets)
- [POST /v2/wallets — Add a wallet](https://developers.blockonomics.co/docs/wallets/post_v2-wallets)
- [GET /v2/wallets/{id} — Get wallet details](https://developers.blockonomics.co/docs/wallets/get_v2-wallets-id)
- [POST /v2/wallets/{id} — Update a wallet](https://developers.blockonomics.co/docs/wallets/post_v2-wallets-id)
- [DELETE /v2/wallets/{id} — Delete a wallet](https://developers.blockonomics.co/docs/wallets/delete_v2-wallets-id)
- [GET /v2/stores — List all stores](https://developers.blockonomics.co/docs/stores/get_v2-stores)
- [POST /v2/stores — Create a new store](https://developers.blockonomics.co/docs/stores/post_v2-stores)
- [GET /v2/stores/{id} — Get store details](https://developers.blockonomics.co/docs/stores/get_v2-stores-id)
- [POST /v2/stores/{id} — Update a store](https://developers.blockonomics.co/docs/stores/post_v2-stores-id)
- [DELETE /v2/stores/{id} — Delete store](https://developers.blockonomics.co/docs/stores/delete_v2-stores-id)
- [GET /v2/stores/{id}/wallets — Get store wallets](https://developers.blockonomics.co/docs/stores/get_v2-stores-id-wallets)
- [POST /v2/stores/{id}/wallets — Attach wallet to store](https://developers.blockonomics.co/docs/stores/post_v2-stores-id-wallets)
- [DELETE /v2/stores/{id}/wallets/{wallet_id} — Detach wallet from store](https://developers.blockonomics.co/docs/stores/delete_v2-stores-id-wallets-wallet-id)
- [POST /new_address — Create or Get Payment Address](https://developers.blockonomics.co/docs/merchants/post_new-address)
- [GET /price — Fetch cryptocurrency price](https://developers.blockonomics.co/docs/merchants/get_price)
- [GET /merchant_orders — Get all orders](https://developers.blockonomics.co/docs/payment-buttons-and-checkouts/get_merchant-orders)
- [GET /merchant_order/{uuid} — Get order details](https://developers.blockonomics.co/docs/payment-buttons-and-checkouts/get_merchant-order-uuid)
- [POST /monitor_tx — Monitor USDT Transaction](https://developers.blockonomics.co/docs/merchants/post_monitor-tx)
- [GET /v2/payments — Get payment history](https://developers.blockonomics.co/docs/merchants/getpayments)

## Guides

- [Getting Started — Create your Blockonomics account, connect a wallet, get your API key, and start accepting crypto payments.](https://developers.blockonomics.co/docs/guides/getting-started)
- [Receiving Payments — Accept BTC and USDT payments on your website using the Blockonomics API — from checkout to confirmed callback.](https://developers.blockonomics.co/docs/guides/receiving-payments)
- [Callbacks — Receive real-time payment notifications via HTTP callbacks when a payment status changes.](https://developers.blockonomics.co/docs/guides/callbacks)
- [Testing — Simulate BTC and USDT payments without real funds using Blockonomics Test Mode.](https://developers.blockonomics.co/docs/guides/testing)
- [Sending Bitcoin — Self-hosted wallet service for sending Bitcoin.](https://developers.blockonomics.co/docs/guides/sending-bitcoin)
- [Web3 USDT Component — Embed a ready-made Web3 component that lets customers pay USDT from MetaMask or any browser wallet.](https://developers.blockonomics.co/docs/guides/web3-usdt-component)
- [WebSocket Payment Notifications — Get real-time notifications when payments arrive at your Bitcoin addresses. No polling required.](https://developers.blockonomics.co/docs/guides/websocket-payment-notifications)

## Overview

[API Overview](https://developers.blockonomics.co/docs)