opreturn.net

API Documentation

opreturn.net provides a simple REST JSON API to programmatically retrieve blockchain data over HTTPS.
Supported blockchains include bitcoin (btc), litecoin (ltc), dogecoin (doge), and garlicoin (grlc).

Documentation to request data is below, along with code examples and the JSON response.
all, apikey, address, block, bestblockhash, blockchaininfo, blockheader, blocktimes, hash, mempool, network, peers, pubkey, transaction

Blockheader

GET Blockheader

Endpoints
GET /api/[$coin]/blockheader/[$block]/
GET /api/[$coin]/blockheader/[$block]/[$verbose]/

//If verbose is 0, returns a string that is serialized, hex-encoded data for blockheader
//If verbose is 1, returns an Object with information about blockheader

[OPTIONS]
$coin (string): btc or ltc or doge or grlc
$block (int) or (string): block height or block hash
$verbose (boolean):
  0 returns "block":"raw blockheader hex" (string)
  1 returns "block":{decoded blockheader} (object)


Code example - get blockheader

curl "https://opreturn.net/api/btc/blockheader/00000000000002da292e12fce09c27f98b16540bbc6ad31acf25aa2e94de3a2a/"

Response

{
    "coin": "btc",
    "cmd": "blockheader",
    "input": "00000000000002da292e12fce09c27f98b16540bbc6ad31acf25aa2e94de3a2a",
    "verbose": false,
    "success": true,
    "blockheader": "0100000063bdb5f061991bb26992fe1ed191d72ec1b72b3e902e2b8413070000000000002e1aab9d9425e08f70ee921ee0d2665a937d11fcf13dd579e8e43f0e0de64a458a50684f87320b1ac2393079"
}
Code example - get blockheader (verbose)

curl "https://opreturn.net/api/btc/blockheader/00000000000002da292e12fce09c27f98b16540bbc6ad31acf25aa2e94de3a2a/1/"

Response

{
    "coin": "btc",
    "cmd": "blockheader",
    "input": "00000000000002da292e12fce09c27f98b16540bbc6ad31acf25aa2e94de3a2a",
    "verbose": true,
    "success": true,
    "blockheader": {
        "hash": "00000000000002da292e12fce09c27f98b16540bbc6ad31acf25aa2e94de3a2a",
        "confirmations": 695516,
        "height": 172008,
        "version": 1,
        "versionHex": "00000001",
        "merkleroot": "454ae60d0e3fe4e879d53df1fc117d935a66d2e01e92ee708fe025949dab1a2e",
        "time": 1332236426,
        "mediantime": 1332235505,
        "nonce": 2033203650,
        "bits": "1a0b3287",
        "difficulty": 1498294.3628165,
        "chainwork": "00000000000000000000000000000000000000000000000e93e9237f21d5601d",
        "nTx": 3,
        "previousblockhash": "0000000000000713842b2e903e2bb7c12ed791d11efe9269b21b9961f0b5bd63",
        "nextblockhash": "000000000000057cdd86869938763f1582bdcd68bd6b3086c648357306a21953"
    }
}