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

Block

GET Block

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

//If verbose is 0, returns a string that is serialized, hex-encoded data for block
//If verbose is 1, returns an Object with information about block
//If verbose is 2, returns an Object with information about block and information about each transaction

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


Code example - get block

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

Response

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

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

Response

{
    "coin": "btc",
    "cmd": "block",
    "input": "00000000000002da292e12fce09c27f98b16540bbc6ad31acf25aa2e94de3a2a",
    "verbose": true,
    "success": true,
    "block": {
        "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",
        "strippedsize": 1458,
        "size": 1458,
        "weight": 5832,
        "tx": [
            "9fd96876245e3d68e9d3587191c435ca445ecdec1831c5ebbd795fad03102392",
            "efd762416ac867e64fd480b43978f5c5fc60742befe1900c2c175477445ec4e9",
            "d38ff6587f43cea5a399462bc735920f30073bbe06b5d7df5154196c5dd8d637"
        ]
    }
}