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

GET Transaction

GET Transaction

Endpoints
GET /api/[$coin]/tx/[$txid]/
GET /api/[$coin]/tx/[$txid]/[$verbose]/

//Returns transaction (serialized hex encoded) or decoded transaction

[OPTIONS]
$coin (string): btc or ltc or doge or grlc
$txid (string)
$verbose (boolean):
  0 returns "tx":"raw transaction hex" (string)
  1 returns "tx":{decoded transaction} (object)

Code example - get transaction

curl "https://opreturn.net/api/btc/tx/d38ff6587f43cea5a399462bc735920f30073bbe06b5d7df5154196c5dd8d637/"

Response

{
    "coin": "btc",
    "cmd": "tx",
    "input": "d38ff6587f43cea5a399462bc735920f30073bbe06b5d7df5154196c5dd8d637",
    "verbose": false,
    "success": true,
    "tx": "010000000134006790638c84d5d21b1937ef9b592db61eed08ad63fd0ff49cad47880bf1e5010000008b48304502203cca6c62043e6a03d6c97794243b6a73d2e7060b942f1f48b7cdb7f20d5706d7022100b1b40748958f5fdae18faea3405f3205baf03d0b4ed648ed98f9ed96f7b3c92f01410406a593ce98d71b7e6b364778541188fd96ba598ef659aaf66ec1e31ead44b22d943c6c5197a936024946b816cc15a3230cfe895d8f95c6e8fccf3f533a234a59ffffffff02c0cf6a00000000001976a914d4c85bbc0d9a7c951ff58e08c3bf12377c405fdd88acc0f35e01000000001976a914f82a1c525bf29ae328c2dcfc2ab3e2f6791083b988ac00000000"
}
Code example - get transaction (verbose)

curl "https://opreturn.net/api/btc/tx/d38ff6587f43cea5a399462bc735920f30073bbe06b5d7df5154196c5dd8d637/1/"

Response

{
    "coin": "btc",
    "cmd": "tx",
    "input": "d38ff6587f43cea5a399462bc735920f30073bbe06b5d7df5154196c5dd8d637",
    "verbose": true,
    "success": true,
    "tx": {
        "txid": "d38ff6587f43cea5a399462bc735920f30073bbe06b5d7df5154196c5dd8d637",
        "hash": "d38ff6587f43cea5a399462bc735920f30073bbe06b5d7df5154196c5dd8d637",
        "version": 1,
        "size": 258,
        "vsize": 258,
        "weight": 1032,
        "locktime": 0,
        "vin": [
            {
                "txid": "e5f10b8847ad9cf40ffd63ad08ed1eb62d599bef37191bd2d5848c6390670034",
                "vout": 1,
                "scriptSig": {
                    "asm": "304502203cca6c62043e6a03d6c97794243b6a73d2e7060b942f1f48b7cdb7f20d5706d7022100b1b40748958f5fdae18faea3405f3205baf03d0b4ed648ed98f9ed96f7b3c92f[ALL] 0406a593ce98d71b7e6b364778541188fd96ba598ef659aaf66ec1e31ead44b22d943c6c5197a936024946b816cc15a3230cfe895d8f95c6e8fccf3f533a234a59",
                    "hex": "48304502203cca6c62043e6a03d6c97794243b6a73d2e7060b942f1f48b7cdb7f20d5706d7022100b1b40748958f5fdae18faea3405f3205baf03d0b4ed648ed98f9ed96f7b3c92f01410406a593ce98d71b7e6b364778541188fd96ba598ef659aaf66ec1e31ead44b22d943c6c5197a936024946b816cc15a3230cfe895d8f95c6e8fccf3f533a234a59"
                },
                "sequence": 4294967295
            }
        ],
        "vout": [
            {
                "value": 0.07,
                "n": 0,
                "scriptPubKey": {
                    "asm": "OP_DUP OP_HASH160 d4c85bbc0d9a7c951ff58e08c3bf12377c405fdd OP_EQUALVERIFY OP_CHECKSIG",
                    "desc": "addr(1LQ6GowxrLyrRy1XLV3Bd1QMfLhwUHQZhC)#qe7077af",
                    "hex": "76a914d4c85bbc0d9a7c951ff58e08c3bf12377c405fdd88ac",
                    "address": "1LQ6GowxrLyrRy1XLV3Bd1QMfLhwUHQZhC",
                    "type": "pubkeyhash"
                }
            },
            {
                "value": 0.23,
                "n": 1,
                "scriptPubKey": {
                    "asm": "OP_DUP OP_HASH160 f82a1c525bf29ae328c2dcfc2ab3e2f6791083b9 OP_EQUALVERIFY OP_CHECKSIG",
                    "desc": "addr(1PdB2UNa2rWNdh7hRfiZnth2YT6QE7dmr9)#hp7mk7as",
                    "hex": "76a914f82a1c525bf29ae328c2dcfc2ab3e2f6791083b988ac",
                    "address": "1PdB2UNa2rWNdh7hRfiZnth2YT6QE7dmr9",
                    "type": "pubkeyhash"
                }
            }
        ],
        "hex": "010000000134006790638c84d5d21b1937ef9b592db61eed08ad63fd0ff49cad47880bf1e5010000008b48304502203cca6c62043e6a03d6c97794243b6a73d2e7060b942f1f48b7cdb7f20d5706d7022100b1b40748958f5fdae18faea3405f3205baf03d0b4ed648ed98f9ed96f7b3c92f01410406a593ce98d71b7e6b364778541188fd96ba598ef659aaf66ec1e31ead44b22d943c6c5197a936024946b816cc15a3230cfe895d8f95c6e8fccf3f533a234a59ffffffff02c0cf6a00000000001976a914d4c85bbc0d9a7c951ff58e08c3bf12377c405fdd88acc0f35e01000000001976a914f82a1c525bf29ae328c2dcfc2ab3e2f6791083b988ac00000000",
        "blockhash": "00000000000002da292e12fce09c27f98b16540bbc6ad31acf25aa2e94de3a2a",
        "confirmations": 695516,
        "time": 1332236426,
        "blocktime": 1332236426
    }
}


POST Transaction, broadcast to network

POST Transaction

Endpoint
POST /api/[$coin]/tx/post/
//Broadcast signed transaction to network

[OPTIONS]
$coin (string): btc or ltc or doge or grlc
method: POST
content: [tx: $signedtxhex]

Code example - post tx

curl --data'{"tx": 
"020000000108c89c258396b64de301b67300e46962c36167c030ae84aa9288c9dd35715ba1000000006a47304402201a7eaa89d5cfaef6d1e1e8e3fae1de4dbf119c2827fdf826599bbfb0e939a82902201c1654479e38197313d239653cb0cf7b2d931259c603912c5f07171a6ce43b7f012103b0ec36023d7ac835b913452617d6abcc295971ad6c9e95dae6cefd563ef17cb3ffffffff0156ebb201000000001976a91488dc24381f1269a68e8b049824265c43dc7e05e288ac00000000"}'
https://opreturn.net/api/grlc/tx/post/
Response

{
    "coin": "grlc",
    "cmd": "tx",
    "input": "post",
    "tx": "020000000108c89c258396b64de301b67300e46962c36167c030ae84aa9288c9dd35715ba1000000006a47304402201a7eaa89d5cfaef6d1e1e8e3fae1de4dbf119c2827fdf826599bbfb0e939a82902201c1654479e38197313d239653cb0cf7b2d931259c603912c5f07171a6ce43b7f012103b0ec36023d7ac835b913452617d6abcc295971ad6c9e95dae6cefd563ef17cb3ffffffff0156ebb201000000001976a91488dc24381f1269a68e8b049824265c43dc7e05e288ac00000000",
    "success": true,
    "txid": "fdad5c146551a03e89fd5aaefce1b2418224bd590db9158e0e18835d58c719c2"
}