sendrawtransaction - Bitcoin

Example code for the sendrawtransaction JSON-RPC method. Complete guide on how to use sendrawtransaction JSON-RPC in GetBlock Web3 documentation.

This method submits a raw transaction (serialized, hex-encoded) to the local node and network.

Parameters

Parameter

Type

Required

Description

hexstring

string

Yes

The hex string of the raw transaction.

maxfeerate

number/string

Maximum feerate in BTC/kvB to reject transactions (default: 0.10).

Request

curl --location --request POST 'https://go.getblock.io/<ACCESS-TOKEN>/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "signmessage",
    "params": ["DLGbK6mCjBT67r8wjJqCg8hkFiBYV5JquH", "Hello, Dogecoin!"],
    "id": "getblock.io"
}'

import axios from 'axios';

const data = JSON.stringify({
    "jsonrpc": "2.0",
    "method": "signmessage",
    "params": ["DLGbK6mCjBT67r8wjJqCg8hkFiBYV5JquH", "Hello, Dogecoin!"],
    "id": "getblock.io"
});

const config = {
    method: 'post',
    url: 'https://go.getblock.io/<ACCESS-TOKEN>/',
    headers: {
        'Content-Type': 'application/json'
    },
    data: data
};

axios(config)
    .then(response => console.log(JSON.stringify(response.data)))
    .catch(error => console.log(error));

import requests
import json

url = "https://go.getblock.io/<ACCESS-TOKEN>/"

payload = json.dumps({
    "jsonrpc": "2.0",
    "method": "signmessage",
    "params": ["DLGbK6mCjBT67r8wjJqCg8hkFiBYV5JquH", "Hello, Dogecoin!"],
    "id": "getblock.io"
})

headers = {
    'Content-Type': 'application/json'
}

response = requests.post(url, headers=headers, data=payload)
print(response.text)

use reqwest::header;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = reqwest::Client::new();
    
    let response = client
        .post("https://go.getblock.io/<ACCESS-TOKEN>/")
        .header(header::CONTENT_TYPE, "application/json")
        .body(r#"{
            "jsonrpc": "2.0",
            "method": "signmessage",
    "params": ["DLGbK6mCjBT67r8wjJqCg8hkFiBYV5JquH", "Hello, Dogecoin!"],
            "id": "getblock.io"
        }"#)
        .send()
        .await?;
    
    println!("{}", response.text().await?);
    Ok(())
}

Response

{
    "jsonrpc": "2.0",
    "id": "getblock.io",
    "result": "ee652f0b40209bd02468de0c6336854f5efdd79fb865560aef2c46f4fa0b4a07"
}

Response Parameters

Field

Type

Description

result

string

The transaction hash (txid) in hex.

Use Case

The sendrawtransaction method is essential for:

Broadcasting signed transactions to the network
Wallet transaction submission
Payment gateway implementations
Automated payment systems
DeFi protocol integrations
Exchange withdrawal systems

Error Handling

Status Code

Error Message

Cause

403

Forbidden

Missing or invalid ACCESS-TOKEN.

-22

TX decode failed

The transaction hex is malformed.

-25

Missing inputs

Transaction references non-existent inputs.

-26

Insufficient fee

Transaction fee is below minimum relay fee.

-26

TX rejected

Transaction violates consensus rules.

-27

Transaction already in block chain

Transaction was already confirmed.

Integration With Web3

The sendrawtransaction method helps developers:

Build wallet broadcast functionality
Implement payment processing systems
Create automated trading bots
Support bulk transaction submission
Enable real-time payment applications

Previoussendmany {disallowed} - Bitcoin Nextsendtoaddress {disallowed} - Bitcoin

Last updated 1 month ago

Was this helpful?

hashtagParameters

hashtagRequest

hashtagResponse

hashtagResponse Parameters

hashtagUse Case

hashtagError Handling

hashtagIntegration With Web3