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).

Get confirmed and unconfirmed balance

GET /balance

Get transaction details

GET /tx_detail

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

Request

curl -X GET \
  "https://www.blockonomics.co/api/searchhistory?addr=%7Bvalue%7D&fiat_currency=USD" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://www.blockonomics.co/api/searchhistory?addr=%7Bvalue%7D&fiat_currency=USD', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
})

const data = await response.json()
console.log(data)

import requests

headers = {
        "Authorization": "Bearer YOUR_API_KEY"
    }

response = requests.get(
    "https://www.blockonomics.co/api/searchhistory?addr=%7Bvalue%7D&fiat_currency=USD",
    headers=headers
)

print(response.json())

Response

{
  "history": [
    {
      "txid": "12ba61bd280a4042576b58160223447c8ab2a17557b1a0bc2c8bd3586f46069a",
      "addr": [
        "bc1qy5aaxp270epvhga0fud8q2jv4xzhmgmjllmep2"
      ],
      "value": -16209,
      "time": 1640995200,
      "fiat_value_at_transaction_time": 0.72
    }
  ],
  "pending": [
    {
      "txid": "d63a82046023b09bdca496b6a510463fb56a5b062e86855e919a1c8ec8ec4648",
      "value": -440,
      "time": 1640998368,
      "status": 1,
      "fee": 440,
      "size": 110,
      "conf_time": 10,
      "addr": [
        "bc1qqqdn48ayae2cvlyafycrjmzvlmxcaxz3am3000",
        "bc1qy5aaxp270epvhga0fud8q2jv4xzhmgmjllmep2"
      ]
    }
  ]
}