BlockonomicsAPI Reference

Search

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

4 endpoints

Endpoints

Get confirmed and unconfirmed balance
GET/balance
Get transaction history for wallet addresses
GET/searchhistory
Get transaction details
GET/tx_detail
Search OP_RETURN data
GET/op_return
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
}
GET/balanceAuth required

Get confirmed and unconfirmed balance

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

Requires Bearer token authentication. Include Authorization: Bearer YOUR_API_KEY in the request header.

Query Parameters

addrstringrequired

Whitespace-separated list of Bitcoin addresses and/or xpubs. A + or %20 may also be used as a separator.

Responses

responsearray[]View balance object
addrquery · stringrequired

Whitespace-separated list of Bitcoin addresses and/or xpubs. A `+` or `%20` may also be used as a separator.

Response will appear here

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
}
GET/searchhistoryAuth required

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.

Requires Bearer token authentication. Include Authorization: Bearer YOUR_API_KEY in the request header.

Query Parameters

addrstringrequired

Space-separated list of Bitcoin addresses and/or xpubs

fiat_currencystring enumdefault: "USD"

Fiat currency code. When provided, confirmed transactions include a fiat_value_at_transaction_time field with the historical fiat equivalent.

Responses

pendingarray[]View transaction object

Unconfirmed transactions (< 2 confirmations).

historyarray[]View transaction object

Confirmed transactions (2+ confirmations).

addrquery · stringrequired

Space-separated list of Bitcoin addresses and/or xpubs

fiat_currencyquery · string

Fiat currency code. When provided, confirmed transactions include a `fiat_value_at_transaction_time` field with the historical fiat equivalent.

Response will appear here

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
    }
  ]
}
GET/tx_detailAuth required

Get transaction details

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

Requires Bearer token authentication. Include Authorization: Bearer YOUR_API_KEY in the request header.

Query Parameters

txidstringrequired

Transaction ID

Responses

txidquery · stringrequired

Transaction ID

Response will appear here

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
}
GET/op_return

Search OP_RETURN data

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

Query Parameters

qstringrequired

Search string to match against OP_RETURN data.

limitintegerdefault: 200

Maximum number of results to return.

Responses

responsearray[]View op_return object
qquery · stringrequired

Search string to match against OP_RETURN data.

limitquery · integer

Maximum number of results to return.

Response will appear here