validateaddress RPC Method

Parameters

address

string

REQUIRED

The bitcoin address to validate

Returns

result

The result is a JSON object with the following fields:

isvalid

If the address is valid or not

address

The validated bitcoin address

scriptPubKey

The hex encoded scriptPubKey generated by the address

isscript

It verifies if the key is a script or not

iswitness

It verifies if the address is a witness address or not

witness_version

The version number of the witness program

witness_program

The hex value of the witness program

error

The error message, if any

Request

curl https://docs-demo.btc.quiknode.pro/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"id": 1, "jsonrpc": "2.0", "method": "validateaddress", "params": ["bc1q5hy2fmqr7ua0a6rj6scekgszctxmlts8smwxcl"]}'

var myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");

var raw = JSON.stringify({
  "id": 1,
  "jsonrpc": "2.0",
  "method": "validateaddress",
  "params": [
    "bc1q5hy2fmqr7ua0a6rj6scekgszctxmlts8smwxcl"
  ]
});

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: raw,
  redirect: 'follow'
};

fetch("https://docs-demo.btc.quiknode.pro/", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

import requests
import json

url = "https://docs-demo.btc.quiknode.pro/"

payload = json.dumps({
  "id": 1,
  "jsonrpc": "2.0",
  "method": "validateaddress",
  "params": [
    "bc1q5hy2fmqr7ua0a6rj6scekgszctxmlts8smwxcl"
  ]
})
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

require "uri"
require "json"
require "net/http"

url = URI("https://docs-demo.btc.quiknode.pro/")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "id": 1,
  "jsonrpc": "2.0",
  "method": "validateaddress",
  "params": [
    "bc1q5hy2fmqr7ua0a6rj6scekgszctxmlts8smwxcl"
  ]
})

response = https.request(request)
puts response.read_body

Response

{
  "result": {
    "isvalid": true,
    "address": "bc1q5hy2fmqr7ua0a6rj6scekgszctxmlts8smwxcl",
    "scriptPubKey": "0014a5c8a4ec03f73afee872d4319b2202c2cdbfae07",
    "isscript": false,
    "iswitness": true,
    "witness_version": 0,
    "witness_program": "a5c8a4ec03f73afee872d4319b2202c2cdbfae07"
  },
  "error": null,
  "id": null
}

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free