Skip to main content
The Fuego daemon provides HTTP endpoints for querying raw transaction data and broadcasting signed transactions to the network. These endpoints complement the wallet service: you might construct and sign a transaction externally (using the cryptographic primitives directly), then use /sendrawtransaction to propagate it. /gettransactions lets you fetch confirmed transaction blobs by hash for verification or decoding. For mempool inspection, the JSON-RPC method f_on_transactions_pool_json is also available.

POST /gettransactions

Fetches one or more raw transactions by their hash. The daemon returns each found transaction as a hex-encoded blob. Hashes that cannot be found (not confirmed, not in pool) are returned in missed_tx. URL: http://127.0.0.1:18180/gettransactions

Request

txs_hashes
array of strings
required
List of transaction hashes to look up. Each hash should be a 64-character hex string.
curl -s http://127.0.0.1:18180/gettransactions \
  -H 'Content-Type: application/json' \
  -d '{
    "txs_hashes": [
      "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"
    ]
  }'

Response

{
  "txs_as_hex": [
    "0100...hexencodedtransactionblob"
  ],
  "missed_tx": [],
  "status": "OK"
}
txs_as_hex
array of strings
required
Hex-encoded transaction blobs for each found transaction, in the same order as the input hashes that were found.
missed_tx
array of strings
required
Hashes from the request that were not found in the confirmed chain or mempool.
status
string
required
"OK" on success.

POST /sendrawtransaction

Broadcasts a signed, serialized transaction to the Fuego network. You must provide the fully constructed transaction as a hex string. The daemon validates the transaction before propagating it. URL: http://127.0.0.1:18180/sendrawtransaction

Request

tx_as_hex
string
required
Hex-encoded serialized transaction blob. The transaction must be fully signed and valid.
curl -s http://127.0.0.1:18180/sendrawtransaction \
  -H 'Content-Type: application/json' \
  -d '{
    "tx_as_hex": "0100...yoursignedtxhex"
  }'

Response

{
  "status": "OK"
}
status
string
required
"OK" if the transaction passed validation and was accepted into the mempool for propagation. Returns an error if the transaction is malformed, double-spends an input, or fails fee checks.

GET /getfeeaddress

Returns the fee address configured by the node operator. Nodes can optionally require a fee payment to their address when relaying transactions. Check this before constructing transactions if you are routing through a third-party node. URL: http://127.0.0.1:18180/getfeeaddress
curl http://127.0.0.1:18180/getfeeaddress

Response

{
  "fee_address": "fireXfGNodeOperatorAddressHere...",
  "status": "OK"
}
fee_address
string
required
The Fuego address the node operator has set to receive fees. Empty string if no fee address is configured.
status
string
required
"OK" on success.

JSON-RPC: f_on_transactions_pool_json

Returns the current contents of the transaction memory pool. Use this to inspect pending transactions before they are confirmed. Method: call via POST http://127.0.0.1:18180/json_rpc

Request

curl -s http://127.0.0.1:18180/json_rpc \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "f_on_transactions_pool_json",
    "params": {},
    "id": "1"
  }'

Response

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": {
    "transactions": [
      {
        "hash": "a1b2c3d4...",
        "fee": 80000,
        "amount_out": 1000000000,
        "size": 1024
      }
    ],
    "status": "OK"
  }
}
transactions
array of objects
required
List of transactions currently in the mempool.
status
string
required
"OK" on success.