Explorer API

Blocks, transactions and addresses for Zcash and Litecoin as JSON — one format for every chain, from the same indexes as this site.

Quick start

Create an account and an API key at https://account.olenza.io. The same key works for Olenza Node RPC and the Explorer API.
Send the key in the X-API-Key header:

curl -H "X-API-Key: YOUR_KEY" https://explorer.olenza.io/api/v1/zec/status

An Authorization: Bearer YOUR_KEY header also works. Keys are never accepted in the URL: URLs end up in logs.

Basics

Base URL: https://explorer.olenza.io/api/v1/{chain}/… — chain is zec (Zcash) or ltc (Litecoin).
Amounts are strings in the coin's smallest unit (for example zatoshi, litoshi). Divide by 10^decimals — decimals is in /status. Strings, because some chains' totals do not fit a 64-bit integer and JavaScript loses precision above 2⁵³.
A field that does not apply to a chain is left out, never null.
Only GET. Answers are application/json.

Plans and limits

Every call costs units — its weight below — against your plan's daily and monthly allowance, and counts once against the per-second rate limit. The Explorer API has its own plan and allowance, separate from Olenza Node: using up one does not touch the other. See pricing.

Every answer carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset, and — when your plan has quotas — X-Quota-Daily-Remaining and X-Quota-Monthly-Remaining in units. Calls the explorer fails to answer (5xx) are not charged; a 404 for something that does not exist is an answer and is charged.

Errors

{"error": {"reason": "NOT_FOUND", "message": "transaction not found"}}

HTTP	reason	Meaning
400	`BAD_REQUEST`	Malformed height, hash, address or parameter.
401	`MISSING_API_KEY`, `INVALID_API_KEY`	No key, or not a valid key.
403	`KEY_REVOKED`, `ACCOUNT_SUSPENDED`, `CHAIN_NOT_IN_PLAN`	The key or account cannot use this.
404	`NOT_FOUND`	No such block, transaction or address.
404	`CHAIN_NOT_FOUND`, `ENDPOINT_NOT_FOUND`	Unknown chain or path.
429	`RATE_LIMITED`, `DAILY_QUOTA_EXCEEDED`, `MONTHLY_QUOTA_EXCEEDED`	Slow down; `Retry-After` says for how long.
502, 503, 504	`UPSTREAM_ERROR`, `SERVICE_UNAVAILABLE`, `UPSTREAM_TIMEOUT`	Our side; not charged. Retry shortly.

Endpoints

Samples below are live answers from Zcash, lists cut to two items. Show samples from: Zcash Litecoin

Endpoint	Units
`GET /{chain}/status`	1
`GET /{chain}/blocks`	5
`GET /{chain}/block/{height\|hash}`	1
`GET /{chain}/block/{height\|hash}/txs`	3
`GET /{chain}/tx/{txid}`	1
`GET /{chain}/address/{address}`	2
`GET /{chain}/address/{address}/txs`	3
`GET /{chain}/address/{address}/utxo`	3
`GET /{chain}/mempool`	2
`GET /{chain}/search/{query}`	1

GET /{chain}/status 1 unit

Chain tip, sync state, the coin's symbol and decimals, mempool size.

curl -H "X-API-Key: YOUR_KEY" "https://explorer.olenza.io/api/v1/zec/status"

Sample response

{
  "best_hash": "0000000000596220405f0e00f32c0f4d3bb0a14a3ee8af8488437499dd31dc61",
  "chain": "zec",
  "decimals": 8,
  "difficulty": 267325439.00413322,
  "height": 3492618,
  "in_sync": true,
  "mempool_count": 8,
  "name": "Zcash",
  "node_version": "/Zebra:6.3.0/",
  "pools": [
    {
      "id": "transparent",
      "value": "1196856126967401"
    },
    {
      "id": "sprout",
      "value": "2247894694336"
    }
  ],
  "symbol": "ZEC"
}

GET /{chain}/blocks 5 units

Latest blocks, newest first.

limit — 1 to 25 (default 10)
start — height to start from (default: the tip)

curl -H "X-API-Key: YOUR_KEY" "https://explorer.olenza.io/api/v1/zec/blocks?limit=2"

Sample response

[
  {
    "hash": "0000000000596220405f0e00f32c0f4d3bb0a14a3ee8af8488437499dd31dc61",
    "height": 3492618,
    "size": 20035,
    "time": 1790105716,
    "tx_count": 3
  },
  {
    "hash": "0000000000537cd6732e48d57b4a884de82206a7060d180ef79d43b096c1a2ec",
    "height": 3492617,
    "size": 1630,
    "time": 1790105709,
    "tx_count": 1
  }
]

GET /{chain}/block/{height|hash} 1 unit

One block's header and transaction count.

curl -H "X-API-Key: YOUR_KEY" "https://explorer.olenza.io/api/v1/zec/block/3492608"

Sample response

{
  "bits": "1b7f4ba4",
  "confirmations": 11,
  "difficulty": 269920622.55172855,
  "hash": "000000000035c5e7d7ba180140f50b0395074168f05f6a45d971f706d610b67d",
  "height": 3492608,
  "merkle_root": "ae1191b2277b39b52451e37fec7e0b840d37aac598c581bdefc98e3b9fbd27e5",
  "next_hash": "0000000000267f3232621fd5aa014887dfe4fcf525e46caf119c5c6e5f1a0b68",
  "nonce": "cdda017e000000000000000000090000000000000000000000000000bd30d3f1",
  "previous_hash": "0000000000335f033f34428cb19d8339ec90d52e7ae43debd66e0961a0040ed1",
  "size": 105420,
  "time": 1790105289,
  "tx_count": 17,
  "version": 4
}

GET /{chain}/block/{height|hash}/txs 3 units

A block's transactions, in block order.

page — page number, from 1 (default 1)
page_size — 1 to 50 (default 25)

curl -H "X-API-Key: YOUR_KEY" "https://explorer.olenza.io/api/v1/zec/block/3492608/txs?page_size=1"

Sample response

{
  "page": 1,
  "total_pages": 17,
  "tx_count": 17,
  "txs": [
    {
      "block_hash": "000000000035c5e7d7ba180140f50b0395074168f05f6a45d971f706d610b67d",
      "block_height": 3492608,
      "coinbase": true,
      "confirmations": 11,
      "size": 142,
      "time": 1790105289,
      "txid": "281f1353747e4dad2e6217fc22d760704c44dae13d4d5561b54b50c502e1173c",
      "value_out": "137740000",
      "version": 6,
      "vin": [
        {
          "coinbase": "03004b3504f09f8cb8",
          "n": 0,
          "sequence": 4294967295,
          "vout": 0
        }
      ],
      "vout": [
        {
          "addresses": [
            "t1MKn34KBa8Xh4g8qU8psibBXvURafphVn7"
          ],
          "n": 0,
          "script_hex": "76a91425db9091e9786867e536f70089a5102523ab1d6a88ac",
          "type": "pubkeyhash",
          "value": "125240000"
        },
        {
          "addresses": [
            "t3cFfPt1Bcvgez9ZbMBFWeZsskxTkPzGCow"
          ],
          "n": 1,
          "script_hex": "a914c20cd5bdf7964ca61764db66bc2531b1792a084d87",
          "type": "scripthash",
          "value": "12500000"
        }
      ]
    }
  ]
}

GET /{chain}/tx/{txid} 1 unit

One transaction with every input resolved: input values and addresses, total in, fee.

curl -H "X-API-Key: YOUR_KEY" "https://explorer.olenza.io/api/v1/zec/tx/ad77a946d6f3a0cd49dac3880405f43b7a0f785fdd0facc32111b6d0c08a2728"

Sample response

{
  "block_hash": "000000000035c5e7d7ba180140f50b0395074168f05f6a45d971f706d610b67d",
  "block_height": 3492608,
  "confirmations": 11,
  "fee": "0",
  "size": 9200,
  "time": 1790105289,
  "txid": "ad77a946d6f3a0cd49dac3880405f43b7a0f785fdd0facc32111b6d0c08a2728",
  "value_in": "0",
  "value_out": "570000",
  "version": 6,
  "vin": [],
  "vout": [
    {
      "addresses": [
        "t1YkWgkg5aH1vSGPjgC9BynU4muFavSXLkM"
      ],
      "n": 0,
      "script_hex": "76a914a33288a705315520cb9fd562f685c034eb330cba88ac",
      "type": "pubkeyhash",
      "value": "570000"
    }
  ]
}

GET /{chain}/address/{address} 2 units

Balance, total received and sent, transaction count.

curl -H "X-API-Key: YOUR_KEY" "https://explorer.olenza.io/api/v1/zec/address/t1YkWgkg5aH1vSGPjgC9BynU4muFavSXLkM"

Sample response

{
  "address": "t1YkWgkg5aH1vSGPjgC9BynU4muFavSXLkM",
  "balance": "0",
  "received": "570000",
  "sent": "570000",
  "tx_count": 2
}

GET /{chain}/address/{address}/txs 3 units

An address's transactions, newest first.

page — page number, from 1 (default 1)
page_size — 1 to 50 (default 25)

curl -H "X-API-Key: YOUR_KEY" "https://explorer.olenza.io/api/v1/zec/address/t1YkWgkg5aH1vSGPjgC9BynU4muFavSXLkM/txs?page_size=1"

Sample response

{
  "page": 1,
  "total_pages": 2,
  "tx_count": 2,
  "txs": [
    {
      "block_hash": "00000000001d5e5bc35398c9edea43dfc7b0c5583e2e50065cb365f16d8a7fc2",
      "block_height": 3492613,
      "confirmations": 6,
      "size": 6339,
      "time": 1790105584,
      "txid": "82b565a830b039c08dafe0cf726ea7b8c6887dc2449ba726bb51487bfbb5d95f",
      "value_out": "491301",
      "version": 6,
      "vin": [
        {
          "n": 0,
          "sequence": 4294967295,
          "txid": "efc63fff61ede0152a2b012bedcd7892f78b23eb0d228fc6a74300be387b2403",
          "vout": 0
        },
        {
          "n": 1,
          "sequence": 4294967295,
          "txid": "ad77a946d6f3a0cd49dac3880405f43b7a0f785fdd0facc32111b6d0c08a2728",
          "vout": 0
        }
      ],
      "vout": [
        {
          "addresses": [
            "t1KfwsnwJeNRVjQGBDZhwKskpQbih2qx5Ua"
          ],
          "n": 0,
          "script_hex": "76a91413bbd8bc8df03a5a9cda88103f583aa8bc043e2488ac",
          "type": "pubkeyhash",
          "value": "491301"
        }
      ]
    }
  ]
}

GET /{chain}/address/{address}/utxo 3 units

Unspent outputs of an address — at most 1000, the largest first when there are more; count says how many there are.

curl -H "X-API-Key: YOUR_KEY" "https://explorer.olenza.io/api/v1/zec/address/t1YkWgkg5aH1vSGPjgC9BynU4muFavSXLkM/utxo"

Sample response

{
  "count": 0,
  "truncated": false,
  "utxos": []
}

GET /{chain}/mempool 2 units

Transactions waiting to be mined.

curl -H "X-API-Key: YOUR_KEY" "https://explorer.olenza.io/api/v1/zec/mempool"

Sample response

{
  "bytes": 89654,
  "count": 8
}

GET /{chain}/search/{query} 1 unit

What a height, hash, txid or address is: block, tx, address or none.

curl -H "X-API-Key: YOUR_KEY" "https://explorer.olenza.io/api/v1/zec/search/3492608"

Sample response

{
  "hash": "000000000035c5e7d7ba180140f50b0395074168f05f6a45d971f706d610b67d",
  "height": 3492608,
  "kind": "block"
}