BlockonomicsAPI Reference

Merchants

Generate payment addresses, track incoming payments, monitor USDT transactions, and fetch live Bitcoin prices.

4 endpoints

Endpoints

POST/new_addressAuth

Create or Get Payment Address

Generates a new payment address to receive payment on your store.

GET/price

Fetch cryptocurrency price

Returns the current price of 1 unit of the specified cryptocurrency in a given fiat currency. All supported fiat currencies are listed here(https://www.blockonomics.co/api/currenci

POST/monitor_txAuth

Monitor USDT Transaction

Begin tracking a USDT transaction. Callbacks are sent to your store's endpoint whenever the transaction status changes.

GET/v2/paymentsAuth

Get payment history

Returns confirmed payments received across all stores, ordered newest-first.

object

The payment_address object

A payment address returned when creating a new BTC or USDT payment address for your store.

Attributes

addressstring

Generated payment address.

cryptostring

The cryptocurrency used for the address (BTC or USDT).

resetinteger

Indicates if the address index was reset (0 = new address, 1 = reuse last address).

accountstring

The source xPub or wallet identifier.

Example object

{
  "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
  "crypto": "BTC",
  "reset": 0,
  "account": "btc_xpub_wallet"
}
object

The payment object

A confirmed payment received by one of your stores.

Attributes

idinteger

Internal payment ID.

timestampinteger

Unix timestamp when the payment was received.

cryptostring

Cryptocurrency used for the payment.

amountinteger

Payment amount in the smallest unit (satoshis for BTC).

addressstring

Receiving address.

txidstring

Transaction ID on the blockchain.

store_namestring

Name of the store that received the payment.

store_urlstring

Callback URL of the store.

fiat_valuenumber

Historical fiat value at time of payment (only present when the currency parameter is supplied).

Example object

{
  "id": 42,
  "timestamp": 1700000000,
  "crypto": "BTC",
  "amount": 500000,
  "address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
  "txid": "c4978bfc9b4cd632fb37eb5f69c7c686ae364d9cb1b32ec01c0f8bae72530a4e",
  "store_name": "My Shop",
  "store_url": "https://example.com/callback",
  "fiat_value": 18.5
}
object

The price object

The current price of 1 unit of a cryptocurrency in a specified fiat currency.

Attributes

pricenumberrequired

Current price of the cryptocurrency in the specified fiat currency.

Example object

{
  "price": 61367.5
}
object

The usdt_transaction object

A USDT transaction monitoring request to track status changes and receive callbacks.

Attributes

txhashstringrequired

The transaction hash to monitor on the Ethereum blockchain.

cryptostringrequired

The cryptocurrency being monitored.

Allowed: USDT

match_callbackstringrequired

String to match part of your Store callback URL. Used when you have multiple stores to ensure the correct one is matched.

testnetintegerrequired

Indicates if the transaction is on the testnet. 0 = mainnet (Ethereum), 1 = sepolia testnet. Defaults to 0 if omitted.

Allowed: 01

Example object

{
  "txhash": "0x712f876339d877e7558f25b4c0b684c5e1d1a11472d407a175c231894b280714",
  "crypto": "USDT",
  "match_callback": "www.example.com",
  "testnet": 0
}