BlockonomicsAPI Reference

Search

Look up Bitcoin addresses, transaction histories, balances, and OP_RETURN data directly on the blockchain.

4 endpoints

Endpoints

GET/balanceAuth

Get confirmed and unconfirmed balance

Returns confirmed and unconfirmed balance for one or more Bitcoin addresses or xpubs. All values are in satoshis.

GET/searchhistoryAuth

Get transaction history for wallet addresses

Returns the transaction history for one or more Bitcoin addresses or xpubs, treated as a single wallet. Returns up to 200 transactions, sorted newest-first.

GET/tx_detailAuth

Get transaction details

Returns full details for a Bitcoin transaction including inputs, outputs, fee, size, and RBF status.

GET/op_return

Search OP_RETURN data

Search Bitcoin transactions by their OPRETURN payload. Returns matching transactions with their transaction ID, timestamp, and embedded data.

object

The transaction object

A transaction represents a Bitcoin transfer, with status, value in satoshis, and involved addresses.

Attributes

statusinteger

Is returned only if transaction not confirmed. 0 = unconfirmed; 1 = partially confirmed

addrarray of strings

List of addresses involved

timeinteger

Unix timestamp

valueinteger

Value transacted in satoshis

txidstring

Transaction ID

fiat_value_at_transaction_timenumber

Fiat value of the transaction at the time it occurred (only included when fiat_currency parameter is provided in the request)

feeinteger

Network fee in satoshis (only present for pending/unconfirmed transactions).

sizeinteger

Transaction size in bytes (only present for pending/unconfirmed transactions).

conf_timeinteger

Estimated confirmation time in minutes (only present for pending/unconfirmed transactions).

Example object

{
  "status": 1,
  "addr": [
    "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"
  ],
  "time": 1612137600,
  "value": 1000000,
  "txid": "7b9d555f0db5c547cb5644e8d6e6cd10",
  "fiat_value_at_transaction_time": 450.75,
  "fee": 440,
  "size": 110,
  "conf_time": 10
}
object

The transaction_detail object

Detailed information about a specific Bitcoin transaction including inputs, outputs, fees, and RBF status.

Attributes

sizeinteger

Transaction size in bytes

timeinteger

Unix timestamp

vinarray of objects

Transaction inputs

▶Show item fields
valueinteger

Input value in satoshis

addressstring

Input address

voutarray of objects

Transaction outputs

▶Show item fields
valueinteger

Output value in satoshis

addressstring

Output address

txidstring

Transaction ID

statusstring

Transaction status

feeinteger

Transaction fee in satoshis

fee_usdnumber

Transaction fee in USD

conf_timeinteger

Confirmation time in seconds

rbfstring

Replace-By-Fee status

valueinteger

Transaction value in satoshis

args_txinarray of objects

List of transaction input details

▶Show item fields
addressstring

Input address

valuestring

Input value in BTC

highlightboolean

Highlight status

args_txoutarray of objects

List of transaction output details

▶Show item fields
addressstring

Output address

valuestring

Output value in BTC

highlightboolean

Highlight status

Example object

{
  "size": 225,
  "time": 1612137600,
  "vin": [
    {
      "value": 5724464598,
      "address": "1AEgdWjJrEbroURgWmPrXkFdzxGxdF7c4G"
    }
  ],
  "vout": [
    {
      "value": 10000,
      "address": "1FnQjXQc8F6jyjF8L92yLpnMhSWpw8t8jo"
    }
  ],
  "txid": "c4978bfc9b4cd632fb37eb5f69c7c686ae364d9cb1b32ec01c0f8bae72530a4e",
  "status": "confirmed",
  "fee": 100000,
  "fee_usd": 106.359,
  "conf_time": 0,
  "rbf": "",
  "value": 0,
  "args_txin": [
    {
      "address": "1AEgdWjJrEbroURgWmPrXkFdzxGxdF7c4G",
      "value": "57.24464598",
      "highlight": false
    }
  ],
  "args_txout": [
    {
      "address": "1FnQjXQc8F6jyjF8L92yLpnMhSWpw8t8jo",
      "value": "0.0001",
      "highlight": false
    }
  ]
}
object

The op_return object

A Bitcoin transaction containing an OP_RETURN output, used to embed arbitrary data on-chain.

Attributes

txidstring

Transaction ID on the Bitcoin blockchain.

timeinteger

Unix timestamp of the transaction.

op_returnstring

The OP_RETURN payload embedded in the transaction output.

voutinteger

Output index of the OP_RETURN within the transaction.

Example object

{
  "txid": "dd2f770fcc53e307c829158fc87771b9f0dc623a3389318897ae8cd67a390eda",
  "time": 1783040542,
  "op_return": "pwm1:m:Hello World",
  "vout": 2
}
object

The balance object

Balance information for a wallet, including confirmed and unconfirmed amounts in both satoshis and fiat.

Attributes

confirmedinteger

Confirmed balance in satoshis.

addrstring

The Bitcoin address or xpub.

unconfirmedinteger

Unconfirmed balance in satoshis (< 2 confirmations).

Example object

{
  "confirmed": 1000000,
  "addr": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
  "unconfirmed": 50000
}