Freedom Street

RPC API

The RPC API provides HTTP endpoints for querying historical blockchain data.

Invoice Endpoints

Get Exchange Rates

GET https://api-v1.freedom.st/invoice/rates

Returns current exchange rates for supported cryptocurrencies (USD per coin).

{
  "btc": 111208.2,
  "dash": 23.16,
  "doge": 0.220205,
  "ltc": 113.29,
  "bch": 554.62
}

Generate QR Code

GET https://api-v1.freedom.st/invoice/qr/{text}

Generates a QR code image for the given text.

Returns: PNG image

RPC Endpoints

All Network Info

GET https://api-v1.freedom.st/rpc/info

Returns blockchain information for all supported networks.

{
  "btc": {
    "chain": "main",
    "blocks": 911925,
    "headers": 911925,
    "bestblockhash": "00000000000000000000d4d0c94935a5399593e76d4ebbadef0542266aba6601",
    "difficulty": "129699156960680.9",
    "time": 1756292641,
    "verificationprogress": "0.9999979418179082",
    "chainwork": "0000000000000000000000000000000000000000dd8b9b109af299c336378194",
    "uptime": 27016
    /* etc */
  },
  "dash": { /* ... */ },
  "doge": { /* ... */ },
  "ltc": { /* ... */ },
  "bch": { /* ... */ }
}

Network Info

GET https://api-v1.freedom.st/rpc/{network}/info

Returns blockchain information for a specific network.

Networks: btc, bch, ltc, doge, dash

{
  "chain": "main",
  "blocks": 911925,
  "headers": 911925,
  "bestblockhash": "00000000000000000000d4d0c94935a5399593e76d4ebbadef0542266aba6601",
  "bits": "17022b91",
  "target": "000000000000000000022b910000000000000000000000000000000000000000",
  "difficulty": "129699156960680.9",
  "time": 1756292641,
  "mediantime": 1756290667,
  "verificationprogress": "0.999998207993986",
  "initialblockdownload": false,
  "chainwork": "0000000000000000000000000000000000000000dd8b9b109af299c336378194",
  "size_on_disk": 776647668323,
  "pruned": false,
  "warnings": [],
  "uptime": 26945
}

Network Peers

GET https://api-v1.freedom.st/rpc/{network}/peers

Returns peer connection information for a network.

[
  {
    "id": 3,
    "addr": "66.163.223.227: 8333",
    "network": "ipv4",
    "services": "0000000000000c09",
    "servicesnames": ["NETWORK", "WITNESS", "NETWORK_LIMITED", "P2P_V2"],
    "relaytxes": true,
    "version": 70016,
    "subver": "/Satoshi: 27.1.0/",
    "inbound": false,
    "startingheight": 911885,
    "lastrecv": 1756292992,
    "lastsend": 1756292992,
    "bytessent": 3094133,
    "bytesrecv": 27386271,
    "pingtime": 55.705613,
    "timeoffset": -51,
    "bip152_hb_to": false,
    "bip152_hb_from": false,
    "connection_type": "outbound-full-relay"
  }
  /* ... */
]

Transaction by Hash

GET https://api-v1.freedom.st/rpc/{network}/txid/{hash}

Returns transaction data for a specific transaction hash.

{
  "tx": {
    "hash": "2415dcf1aa44ecaad67caef3bb83cf008f2aaace345b67e8046d480c45f4e5ad",
    "block": "00000000000000000001294db11ddce9925b2e1c463fe85b6562c9914bb1a5e7",
    "size": 222,
    "version": 2,
    "lock": 911881,
    "fee": 0.00000423
  },
  "in": [
    {
      "txid": "73558a6cf0d2b0d06d1871b91b4d14e89802d620c888f25472638c7c9bb613a2",
      "vout": 0,
      "value": 0.00110914,
      "address": "bc1qe6j7m4cgf8n2e3yn7mutgnfue4dwrrms9n53vx",
      "sequence": 4294967293
    }
  ],
  "out": [
    {
      "value": 0.00017957,
      "n": 0,
      "script": {
        "asm": "0 d587a7a1748590e35639121037f120d246e80939",
        "desc": "addr(bc1q6kr60gt5skgwx43ezggr0ufq6frwszfezgwee9)#9j3f3789",
        "hex": "0014d587a7a1748590e35639121037f120d246e80939",
        "type": "witness_v0_keyhash",
        "address": "bc1q6kr60gt5skgwx43ezggr0ufq6frwszfezgwee9"
      }
    }
    /* ... */
  ]
}

Block by Hash

GET https://api-v1.freedom.st/rpc/{network}/block/{hash}

Returns block data for a specific block hash.

{
  "hash": "00000000000000000000e0c9ce97e46a233458ae3cb885ff1ab3f173c9d470ff",
  "confirmations": 2,
  "height": 911923,
  "version": 538189824,
  "merkleroot": "9ebbcdfab2df0adf947ddf4c708479854e1ea277f2d4fbc93d691178cb6b5244",
  "time": 1756291615,
  "mediantime": 1756290223,
  "nonce": 3985692743,
  "bits": "17022b91",
  "difficulty": "129699156960680.9",
  "chainwork": "0000000000000000000000000000000000000000dd8aaf23ceaa822951f7fb58",
  "nTx": 4200,
  "previousblockhash": "00000000000000000001e7965f43dee5f29b200e060ab0e4cb94a44b6d79c7bd",
  "nextblockhash": "000000000000000000004db1fe5ab3d4d521c3e2c4e8e0c7aa4f228a29144da5",
  "strippedsize": 739740,
  "size": 1774561,
  "weight": 3993781,
  "tx": [
    "f9271fa741df6a6911197e38a8c2919e5c48ad58fb34fd0d5446444dea7ec5d7",
    "497effe12572eafcf56bd38b73e8e0523ac4e222e0b277d045a75a31be471797"
    /* ... */
  ]
}

Mempool

GET https://api-v1.freedom.st/rpc/{network}/mempool

Returns mempool information including transaction hashes and statistics.

{
  "loaded": true,
  "size": 71,
  "bytes": 45351,
  "usage": 118960,
  "maxmempool": 2560000000,
  "mempoolminfee": 0.00001,
  "minrelaytxfee": 0.00001,
  "tx": [
    "562c35e33cb8ceae94649218f6e8e91b7e584fd163d4cc82c08d957159b399e6",
    "5c263a7130833a664693062573ff387423f209230e953d983eda9ce3da2444ea"
    /* ... */
  ]
}

Database Endpoints

Transaction by ID

GET https://api-v1.freedom.st/txid/{txid}

Returns processed transaction data from the database including inputs and outputs.

{
  "in": [
    {
      "prev_txid": "b7b58a0d5d52e56df2a0db5631a025a0783bfa0b8d18073a96dd958c69f6975c",
      "spending_txid": "6da0e96be498e8436ebce4d547d203d5a27daf82dba4518f3d7396d10c8b929a",
      "prev_vout": 1,
      "address": "D6Dz1pzn2AcwSfz1Sat6Re54pghrFxcRa8",
      "amount": 689.82456041,
      "block": null,
      "crypto": "doge",
      "sequence": 4294967295,
      "time": 1756313353709
    }
  ],
  "out": [
    {
      "address": "DDNJSLt7DhYhM5VhvMFucazDriP2uFZ25F",
      "txid": "6da0e96be498e8436ebce4d547d203d5a27daf82dba4518f3d7396d10c8b929a",
      "amount": 45.55631191,
      "block": null,
      "crypto": "doge",
      "scriptPubKey": "76a9145a4058827079e65333674e76ed7780bbe896e3ec88ac",
      "time": 1756313353707,
      "vout": 0
    },
    {
      "address": "D6Dz1pzn2AcwSfz1Sat6Re54pghrFxcRa8",
      "txid": "6da0e96be498e8436ebce4d547d203d5a27daf82dba4518f3d7396d10c8b929a",
      "amount": 643.1682485,
      "block": null,
      "crypto": "doge",
      "scriptPubKey": "76a9140be4c25349ee33a3f3d9674fdd31618918cacd4588ac",
      "time": 1756313353707,
      "vout": 1
    }
  ]
}

Address Information

GET https://api-v1.freedom.st/address/{address}

Returns transaction history and balance information for an address.

{
  "address": "bc1q6kr60gt5skgwx43ezggr0ufq6frwszfezgwee9",
  "received": 0.00017957,
  "received_confirmed": 0.00017957,
  "sent": 0,
  "sent_confirmed": 0,
  "in": [],
  "out": [
    {
      "address": "bc1q6kr60gt5skgwx43ezggr0ufq6frwszfezgwee9",
      "txid": "2415dcf1aa44ecaad67caef3bb83cf008f2aaace345b67e8046d480c45f4e5ad",
      "amount": 0.00017957,
      "block": "00000000000000000001294db11ddce9925b2e1c463fe85b6562c9914bb1a5e7",
      "crypto": "btc",
      "scriptPubKey": "0014d587a7a1748590e35639121037f120d246e80939",
      "time": 1756262683469,
      "vout": 0
    }
  ]
}

Bulk Transaction Lookup

POST https://api-v1.freedom.st/txid

Returns transaction data for multiple transaction IDs.

Body:

{
  "terms": ["txid1", "txid2", "txid3"]
}

Bulk Address Lookup

POST https://api-v1.freedom.st/address

Returns transaction data for multiple addresses.

Body:

{
  "terms": ["address1", "address2", "address3"]
}

Error Responses

Error responses return JSON with an error field:

{
  "error": "Invalid network"
}