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

Peers

GET Peers

Endpoint
GET /api/[$coin]/peers/

//Returns data about each connected network node as a json array of objects.

[OPTIONS]
$coin (string): btc or ltc or doge or grlc


Code example - get peers

curl "https://opreturn.net/api/btc/peers/"

Response

{
    "coin": "btc",
    "cmd": "peers",
    "success": true,
    "peers": [
        {
            "id": 0,
            "addr": "10.0.0.186:44666",
            "addrbind": "10.0.0.9:8333",
            "network": "not_publicly_routable",
            "services": "0000000000000409",
            "servicesnames": [
                "NETWORK",
                "WITNESS",
                "NETWORK_LIMITED"
            ],
            "lastsend": 1730691434,
            "lastrecv": 1730691434,
            "last_transaction": 0,
            "last_block": 0,
            "bytessent": 12504684332,
            "bytesrecv": 33667954,
            "conntime": 1726346642,
            "timeoffset": 0,
            "pingtime": 0.001813,
            "minping": 0.000365,
            "version": 70016,
            "subver": "\/Satoshi:22.0.0(opreturn.net)\/",
            "inbound": true,
            "bip152_hb_to": false,
            "bip152_hb_from": true,
            "startingheight": 861325,
            "presynced_headers": -1,
            "synced_headers": 861325,
            "synced_blocks": 861325,
            "inflight": [],
            "relaytxes": false,
            "minfeefilter": 0,
            "addr_relay_enabled": true,
            "addr_processed": 0,
            "addr_rate_limited": 0,
            "permissions": [],
            "bytessent_per_msg": {
                "addrv2": 1954893,
                "block": 15377038,
                "blocktxn": 12295946983,
                "cmpctblock": 188971675,
                "feefilter": 115360,
                "getheaders": 1053,
                "headers": 773,
                "ping": 1158176,
                "pong": 1158112,
                "sendaddrv2": 24,
                "sendcmpct": 33,
                "sendheaders": 24,
                "verack": 24,
                "version": 140,
                "wtxidrelay": 24
            },
            "bytesrecv_per_msg": {
                "getaddr": 24,
                "getblocktxn": 31349552,
                "getdata": 596,
                "getheaders": 1053,
                "headers": 106,
                "ping": 1158112,
                "pong": 1158176,
                "sendaddrv2": 24,
                "sendcmpct": 99,
                "sendheaders": 24,
                "verack": 24,
                "version": 140,
                "wtxidrelay": 24
            },
            "connection_type": "inbound"
        },
        {
            "...": "..."
        }
    ]
}