Blockbook API Changes 0.5.0 > 0.6.0 - Arbitrum (ARB) Blockbook - modified methods

v0.6.0-changelog

Base URL

https://arb-blockbook.nownodes.ioNOWNodes Arbitrum (ARB) Blockbook MAINNET endpoint.

Changelog slice for the NOWNodes Arbitrum (ARB) Blockbook API (https://arb-blockbook.nownodes.io): methods whose contract changed between 0.5.0 and 0.6.0. Documented from the upstream Blockbook 0.6.0 release and the canonical NOWNodes Arbitrum Blockbook OpenAPI (2.0.0-draft). Arbitrum is an EVM chain: EVM-only 0.6.0 additions (nonce on the address API, EIP-1559 gas fields, ERC-4626 protocol enrichment) are applicable, while UTXO/xpub-only changes are not part of the Arbitrum API surface. This changelog covers the REST API surface. Companion files: "added|modified|deprecated methods/openapi.yml" one level up.

Authentication

api-keyAuthapiKey

NOWNodes API key passed in the api-key header.

API Key: api-key in header

MAINNET / Blockbook 0.5.0 > 0.6.0 API CHANGES / Modified methods

BlockBook

Get address/account details.

GET

https://arb-blockbook.nownodes.io/api/v2/address/{address}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Modified between 0.5.0 and 0.6.0: improved unconfirmed balance reporting - unconfirmedBalance and unconfirmedTxs are serialized; optional protocols=erc4626 enrichment parameter for EVM chains; REST traffic is rate limited per client. Documented as it exists in 0.6.0.

Returns balances and transactions of an address. Transactions are sorted by block height with newest blocks first. Response size is controlled by the details parameter.

At details=basic, mempool transactions are not aggregated: unconfirmedBalance, unconfirmedSending, and unconfirmedReceiving are omitted, and unconfirmedTxs reports the raw mempool index size for the address.

Load estimate: Variable; basic is low, token/tokenBalances and txids/txslight are medium, and txs can be high as it grows with pageSize, transactions, token rows, filters, and protocol enrichment.

Parameters

addressstringrequiredpath

Chain address.

pageinteger>= 1query

1-based page index. Values outside safe bounds are sanitized to the closest possible page.

pageSizeinteger[1, 1000]query

Number of history items per page. The default and maximum for REST account endpoints is 1000.

frominteger>= 0query

First block height included in account transaction filtering.

tointeger>= 0query

Last block height included in account transaction filtering.

detailsstringbasictokenstokenBalancestxidstxslighttxstxidsquery

Controls how much account data is returned. basic returns balances and counts only. tokens adds known token rows. tokenBalances returns token rows with balances. txids adds paged transaction ids. txslight adds limited transaction details from the index. txs adds full transaction details.

filterstring | integerquery

Filter account history by input/output side, or by numeric token/internal filter id.

contractstringquery

Contract address used to filter token data.

protocolsArray<string>query

Optional protocol enrichments, comma-separated or repeated. Currently supported value: erc4626. Unknown values are rejected.

secondarystringquery

Secondary currency code used to populate fiat values.

Response

200OK

HTTP 200 Arbitrum Blockbook response for getAddress.

400Bad Request

Domain or validation error. JSON body {"error": "..."}.

401Unauthorized

Unauthorized: missing or invalid api-key header. The NOWNodes gateway returns the plain-text body "Unknown API_key".

405Method Not Allowed

Method Not Allowed: gateway-level response for unknown routes.

500Internal Server Error

Internal Server Error. JSON body {"error":"Internal server error"}.

Get address/account details.

curl -X GET 'https://arb-blockbook.nownodes.io/api/v2/address/{address}'

const response = await fetch('https://arb-blockbook.nownodes.io/api/v2/address/{address}', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://arb-blockbook.nownodes.io/api/v2/address/{address}')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

response = requests.get('https://arb-blockbook.nownodes.io/api/v2/address/{address}')
data = response.json()

const response = await fetch('https://arb-blockbook.nownodes.io/api/v2/address/{address}', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://arb-blockbook.nownodes.io/api/v2/address/{address}";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://arb-blockbook.nownodes.io/api/v2/address/{address}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://arb-blockbook.nownodes.io/api/v2/address/{address}')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://arb-blockbook.nownodes.io/api/v2/address/{address}')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

{
  "address": "0x2df3951b2037bA620C20Ed0B73CCF45Ea473e83B",
  "balance": "21004631949601199",
  "unconfirmedBalance": "0",
  "unconfirmedTxs": 0,
  "txs": 5,
  "nonTokenTxs": 3,
  "nonce": "1",
  "tokens": [
    {
      "type": "ERC20",
      "standard": "ERC20",
      "name": "Tether USD",
      "contract": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
      "transfers": 3,
      "symbol": "USDT",
      "decimals": 6,
      "balance": "4913000000",
      "baseValue": 3.104622978658881,
      "secondaryValue": 4914.214559070491
    }
  ],
  "secondaryValue": 33.247601671503574,
  "tokensBaseValue": 3.104622978658881,
  "tokensSecondaryValue": 4914.214559070491,
  "totalBaseValue": 3.125627610608482,
  "totalSecondaryValue": 4947.462160741995
}

{
  "error": "Address not found"
}

{
  "error": "Address not found"
}

Unknown API_key

Method Not Allowed

{
  "error": "Internal server error"
}

Get account balance history.

GET

https://arb-blockbook.nownodes.io/api/v2/balancehistory/{descriptor}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Modified between 0.5.0 and 0.6.0: balance-history queries are bounded per transport as part of the rate-limiting work; batch fiat lookups are capped at 1000 timestamps. Documented as it exists in 0.6.0.

Returns balance history points for an address, XPUB, or descriptor. from and to are Unix timestamps. groupBy is an aggregation interval in seconds and defaults to 3600. When fiatcurrency is omitted, rates can contain all available currencies. sentToSelf is the amount sent from an address to itself or within addresses of the same XPUB.

Load estimate: High; grows with account transaction history, time span, grouping cardinality, fiat rate lookups, and XPUB/descriptor gap.

Parameters

descriptorstringrequiredpath

Address, XPUB, or supported descriptor. URL-encode descriptors.

frominteger<int64>query

Unix timestamp lower bound.

tointeger<int64>query

Unix timestamp upper bound.

fiatcurrencystringquery

Optional fiat currency code to include in rates.

groupByinteger>= 1query

Aggregation interval in seconds. Defaults to 3600.

gapinteger[0, 10000]query

XPUB/address derivation gap limit.

Response

200OK

HTTP 200 Arbitrum Blockbook response for getBalanceHistory.

400Bad Request

Domain or validation error. JSON body {"error": "..."}.

401Unauthorized

Unauthorized: missing or invalid api-key header. The NOWNodes gateway returns the plain-text body "Unknown API_key".

405Method Not Allowed

Method Not Allowed: gateway-level response for unknown routes.

500Internal Server Error

Internal Server Error. JSON body {"error":"Internal server error"}.

Get account balance history.

curl -X GET 'https://arb-blockbook.nownodes.io/api/v2/balancehistory/{descriptor}'

const response = await fetch('https://arb-blockbook.nownodes.io/api/v2/balancehistory/{descriptor}', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://arb-blockbook.nownodes.io/api/v2/balancehistory/{descriptor}')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

response = requests.get('https://arb-blockbook.nownodes.io/api/v2/balancehistory/{descriptor}')
data = response.json()

const response = await fetch('https://arb-blockbook.nownodes.io/api/v2/balancehistory/{descriptor}', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://arb-blockbook.nownodes.io/api/v2/balancehistory/{descriptor}";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://arb-blockbook.nownodes.io/api/v2/balancehistory/{descriptor}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://arb-blockbook.nownodes.io/api/v2/balancehistory/{descriptor}')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://arb-blockbook.nownodes.io/api/v2/balancehistory/{descriptor}')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

[
  {
    "time": 1578391200,
    "txs": 5,
    "received": "5000000",
    "sent": "0",
    "sentToSelf": "100000",
    "rates": {
      "usd": 7855.9,
      "eur": 6838.13
    }
  },
  {
    "time": 1578488400,
    "txs": 1,
    "received": "0",
    "sent": "5000000",
    "sentToSelf": "0",
    "rates": {
      "usd": 8283.11,
      "eur": 7464.45
    }
  }
]

{
  "error": "Invalid descriptor"
}

{
  "error": "Invalid descriptor"
}

Unknown API_key

Method Not Allowed

{
  "error": "Internal server error"
}

Get current or historical fiat rates.

GET

https://arb-blockbook.nownodes.io/api/v2/tickers

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Modified between 0.5.0 and 0.6.0: fiat-rate currency selectors are bounded; CoinGecko fetching hardened against 429 throttling with a self-healing pass for missing daily rates - availability of rates improves, response shape is unchanged. Documented as it exists in 0.6.0.

Returns currency rates for the requested currency and date. If a rate is unavailable for the exact timestamp, the closest available rate can be returned. Responses include the actual rate timestamp. Without a currency parameter, all available currencies can be returned. A rate of -1 marks an unavailable or invalid currency for that timestamp.

Load estimate: Low to medium; specific currency lookups are cheap, while omitted currency and token lookups increase response size.

Parameters

currencystringquery

Optional currency code. When omitted, all available rates can be returned.

timestampinteger<int64>query

Unix timestamp for historical rates.

blockstringquery

Block height or hash whose timestamp should be used for historical rates.

tokenstringquery

Optional token symbol or contract/address key for token-specific rates.

Response

200OK

HTTP 200 Arbitrum Blockbook response for getFiatTicker.

400Bad Request

Domain or validation error. JSON body {"error": "..."}.

401Unauthorized

Unauthorized: missing or invalid api-key header. The NOWNodes gateway returns the plain-text body "Unknown API_key".

405Method Not Allowed

Method Not Allowed: gateway-level response for unknown routes.

500Internal Server Error

Internal Server Error. JSON body {"error":"Internal server error"}.

Get current or historical fiat rates.

curl -X GET 'https://arb-blockbook.nownodes.io/api/v2/tickers/'

const response = await fetch('https://arb-blockbook.nownodes.io/api/v2/tickers/', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://arb-blockbook.nownodes.io/api/v2/tickers/')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

response = requests.get('https://arb-blockbook.nownodes.io/api/v2/tickers/')
data = response.json()

const response = await fetch('https://arb-blockbook.nownodes.io/api/v2/tickers/', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://arb-blockbook.nownodes.io/api/v2/tickers/";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://arb-blockbook.nownodes.io/api/v2/tickers/', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://arb-blockbook.nownodes.io/api/v2/tickers/')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://arb-blockbook.nownodes.io/api/v2/tickers/')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

{
  "ts": 1574346615,
  "rates": {
    "usd": 7914.5
  }
}

{
  "error": "Invalid currency"
}

{
  "error": "Invalid currency"
}

Unknown API_key

Method Not Allowed

{
  "error": "Internal server error"
}

Get currencies available for a timestamp.

GET

https://arb-blockbook.nownodes.io/api/v2/tickers-list

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Modified between 0.5.0 and 0.6.0: fiat-rate currency selectors are bounded; CoinGecko resilience improvements. Documented as it exists in 0.6.0.

Returns available secondary currencies for a date together with the actual rate timestamp.

Load estimate: Low to medium; token lookups and wide currency lists increase response size.

Parameters

timestampinteger<int64>requiredquery

Unix timestamp for the requested currency list.

tokenstringquery

Optional token symbol or contract/address key.

Response

200OK

HTTP 200 Arbitrum Blockbook response for getFiatTickersList.

400Bad Request

Domain or validation error. JSON body {"error": "..."}.

401Unauthorized

Unauthorized: missing or invalid api-key header. The NOWNodes gateway returns the plain-text body "Unknown API_key".

405Method Not Allowed

Method Not Allowed: gateway-level response for unknown routes.

500Internal Server Error

Internal Server Error. JSON body {"error":"Internal server error"}.

Get currencies available for a timestamp.

curl -X GET 'https://arb-blockbook.nownodes.io/api/v2/tickers-list/'

const response = await fetch('https://arb-blockbook.nownodes.io/api/v2/tickers-list/', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://arb-blockbook.nownodes.io/api/v2/tickers-list/')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

response = requests.get('https://arb-blockbook.nownodes.io/api/v2/tickers-list/')
data = response.json()

const response = await fetch('https://arb-blockbook.nownodes.io/api/v2/tickers-list/', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://arb-blockbook.nownodes.io/api/v2/tickers-list/";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://arb-blockbook.nownodes.io/api/v2/tickers-list/', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://arb-blockbook.nownodes.io/api/v2/tickers-list/')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://arb-blockbook.nownodes.io/api/v2/tickers-list/')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

{
  "ts": 1574346615,
  "available_currencies": [
    "eur",
    "usd"
  ]
}

{
  "error": "Invalid timestamp"
}

{
  "error": "Invalid timestamp"
}

Unknown API_key

Method Not Allowed

{
  "error": "Internal server error"
}

Get fiat rates for multiple timestamps.

GET

https://arb-blockbook.nownodes.io/api/v2/multi-tickers

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Modified between 0.5.0 and 0.6.0: a maximum of 1000 timestamps per batch request is enforced. Documented as it exists in 0.6.0.

Returns fiat rate tickers for a comma-separated list of Unix timestamps.

Load estimate: Medium; work and payload grow linearly with timestamp count, plus token/currency selection.

Parameters

timestampstringrequiredquery

Comma-separated Unix timestamps.

currencystringquery

Optional currency code.

tokenstringquery

Optional token symbol or contract/address key.

Response

200OK

HTTP 200 Arbitrum Blockbook response for getFiatTickersForTimestamps.

400Bad Request

Domain or validation error. JSON body {"error": "..."}.

401Unauthorized

Unauthorized: missing or invalid api-key header. The NOWNodes gateway returns the plain-text body "Unknown API_key".

405Method Not Allowed

Method Not Allowed: gateway-level response for unknown routes.

500Internal Server Error

Internal Server Error. JSON body {"error":"Internal server error"}.

Get fiat rates for multiple timestamps.

curl -X GET 'https://arb-blockbook.nownodes.io/api/v2/multi-tickers/'

const response = await fetch('https://arb-blockbook.nownodes.io/api/v2/multi-tickers/', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://arb-blockbook.nownodes.io/api/v2/multi-tickers/')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

response = requests.get('https://arb-blockbook.nownodes.io/api/v2/multi-tickers/')
data = response.json()

const response = await fetch('https://arb-blockbook.nownodes.io/api/v2/multi-tickers/', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://arb-blockbook.nownodes.io/api/v2/multi-tickers/";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://arb-blockbook.nownodes.io/api/v2/multi-tickers/', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://arb-blockbook.nownodes.io/api/v2/multi-tickers/')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://arb-blockbook.nownodes.io/api/v2/multi-tickers/')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

[
  {
    "ts": 1574346615,
    "rates": {
      "usd": 7914.5
    }
  },
  {
    "ts": 1574433015,
    "rates": {
      "usd": 7344.2
    }
  }
]

{
  "error": "Invalid timestamp"
}

{
  "error": "Invalid timestamp"
}

Unknown API_key

Method Not Allowed

{
  "error": "Internal server error"
}

Broadcast a raw transaction using the path.

GET

https://arb-blockbook.nownodes.io/api/v2/sendtx/{hex}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Modified between 0.5.0 and 0.6.0: request-size hardening limits the broadcast body size; the backend can relay broadcasts through an alternative (e.g. private/MEV) provider; per-client REST rate limiting. Documented as it exists in 0.6.0.

Broadcasts hex-encoded raw transaction data. Prefer POST for large payloads.

Load estimate: High; validates and forwards to the backend, with cost growing with transaction size and backend mempool policy checks.

Parameters

hexstringrequiredpath

Raw transaction.

Response

200OK

HTTP 200 Arbitrum Blockbook response for sendTransactionByGet.

400Bad Request

Domain or validation error. JSON body {"error": "..."}.

401Unauthorized

Unauthorized: missing or invalid api-key header. The NOWNodes gateway returns the plain-text body "Unknown API_key".

405Method Not Allowed

Method Not Allowed: gateway-level response for unknown routes.

500Internal Server Error

Internal Server Error. JSON body {"error":"Internal server error"}.

Broadcast a raw transaction using the path.

curl -X GET 'https://arb-blockbook.nownodes.io/api/v2/sendtx/{hex}'

const response = await fetch('https://arb-blockbook.nownodes.io/api/v2/sendtx/{hex}', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://arb-blockbook.nownodes.io/api/v2/sendtx/{hex}')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

response = requests.get('https://arb-blockbook.nownodes.io/api/v2/sendtx/{hex}')
data = response.json()

const response = await fetch('https://arb-blockbook.nownodes.io/api/v2/sendtx/{hex}', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://arb-blockbook.nownodes.io/api/v2/sendtx/{hex}";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://arb-blockbook.nownodes.io/api/v2/sendtx/{hex}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://arb-blockbook.nownodes.io/api/v2/sendtx/{hex}')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://arb-blockbook.nownodes.io/api/v2/sendtx/{hex}')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

{
  "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25"
}

{
  "error": "Invalid transaction hex"
}

{
  "error": "Invalid transaction hex"
}

Unknown API_key

Method Not Allowed

{
  "error": "Internal server error"
}

Broadcast a raw transaction using the request body.

POST

https://arb-blockbook.nownodes.io/api/v2/sendtx

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Modified between 0.5.0 and 0.6.0: POST body size limited to 8 MiB; alternative broadcast provider support server-side; per-client rate limiting. Documented as it exists in 0.6.0.

Broadcasts hex-encoded raw transaction data from the request body. The trailing slash is mandatory in the Blockbook handler. POST bodies are limited to 8 MiB.

Load estimate: High; validates and forwards to the backend, with cost growing with transaction size and backend mempool policy checks.

Body

text/plain

string

Response

200OK

HTTP 200 Arbitrum Blockbook response for sendTransactionByPost.

400Bad Request

Domain or validation error. JSON body {"error": "..."}.

401Unauthorized

Unauthorized: missing or invalid api-key header. The NOWNodes gateway returns the plain-text body "Unknown API_key".

405Method Not Allowed

Method Not Allowed: gateway-level response for unknown routes.

500Internal Server Error

Internal Server Error. JSON body {"error":"Internal server error"}.

Broadcast a raw transaction using the request body.

curl -X POST 'https://arb-blockbook.nownodes.io/api/v2/sendtx/' \
  -H 'Content-Type: text/plain' \
  -d '"02000000000101662a..."'

const response = await fetch('https://arb-blockbook.nownodes.io/api/v2/sendtx/', {
  method: 'POST',
  headers: {
    'Content-Type': 'text/plain',
  },
  body: JSON.stringify("02000000000101662a..."),
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://arb-blockbook.nownodes.io/api/v2/sendtx/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'text/plain'
request.body = '"02000000000101662a..."'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

payload = "02000000000101662a..."

response = requests.post('https://arb-blockbook.nownodes.io/api/v2/sendtx/', json=payload)
data = response.json()

const response = await fetch('https://arb-blockbook.nownodes.io/api/v2/sendtx/', {
  method: 'POST',
  headers: {
    'Content-Type': 'text/plain',
  },
  body: JSON.stringify("02000000000101662a..."),
});

const data = await response.json();

const endpoint = "https://arb-blockbook.nownodes.io/api/v2/sendtx/";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "POST",
    headers: {
      "Content-Type": "text/plain",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest("02000000000101662a...");
console.log(result);

const response = await fetch('https://arb-blockbook.nownodes.io/api/v2/sendtx/', {
  method: 'POST',
  headers: {
    'Content-Type': 'text/plain',
  },
  body: JSON.stringify("02000000000101662a..."),
});

const data = await response.json();

import requests

payload = "02000000000101662a..."

response = requests.post('https://arb-blockbook.nownodes.io/api/v2/sendtx/', json=payload)
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://arb-blockbook.nownodes.io/api/v2/sendtx/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'text/plain'
request.body = '"02000000000101662a..."'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

Request Body

02000000000101662a...

{
  "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25"
}

{
  "error": "Invalid transaction hex"
}

{
  "error": "Invalid transaction hex"
}

Unknown API_key

Method Not Allowed

{
  "error": "Internal server error"
}

Estimate a fee target.

GET

https://arb-blockbook.nownodes.io/api/v2/estimatefee/{blocks}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Modified between 0.5.0 and 0.6.0: new mempoolspacemedian alternative fee estimation option (server configuration); fee estimates lower than 1 sat/vB can be returned. Response shape unchanged. Documented as it exists in 0.6.0.

Returns backend fee estimation for the requested confirmation target.

Load estimate: Low; a small backend fee estimate lookup.

Parameters

blocksinteger>= 1requiredpath

Confirmation target in blocks.

conservativebooleantruequery

Use conservative smart fee estimation where supported.

Response

200OK

HTTP 200 Arbitrum Blockbook response for estimateFee.

400Bad Request

Domain or validation error. JSON body {"error": "..."}.

401Unauthorized

Unauthorized: missing or invalid api-key header. The NOWNodes gateway returns the plain-text body "Unknown API_key".

405Method Not Allowed

Method Not Allowed: gateway-level response for unknown routes.

500Internal Server Error

Internal Server Error. JSON body {"error":"Internal server error"}.

Estimate a fee target.

curl -X GET 'https://arb-blockbook.nownodes.io/api/v2/estimatefee/{blocks}'

const response = await fetch('https://arb-blockbook.nownodes.io/api/v2/estimatefee/{blocks}', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://arb-blockbook.nownodes.io/api/v2/estimatefee/{blocks}')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

response = requests.get('https://arb-blockbook.nownodes.io/api/v2/estimatefee/{blocks}')
data = response.json()

const response = await fetch('https://arb-blockbook.nownodes.io/api/v2/estimatefee/{blocks}', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://arb-blockbook.nownodes.io/api/v2/estimatefee/{blocks}";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://arb-blockbook.nownodes.io/api/v2/estimatefee/{blocks}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://arb-blockbook.nownodes.io/api/v2/estimatefee/{blocks}')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://arb-blockbook.nownodes.io/api/v2/estimatefee/{blocks}')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

{
  "result": "0.00002460"
}

{
  "error": "Fee estimation not available"
}

{
  "error": "Fee estimation not available"
}

Unknown API_key

Method Not Allowed

{
  "error": "Internal server error"
}

Documentation

How to migrate to NOWNodes

Blockbook API Changes 0.5.0 > 0.6.0 - Arbitrum (ARB) Blockbook - modified methods

Authentication

MAINNET / Blockbook 0.5.0 > 0.6.0 API CHANGES / Modified methods

BlockBook

Get address/account details.

Authorizations

Parameters

Response

Get account balance history.

Authorizations

Parameters

Response

Get current or historical fiat rates.

Authorizations

Parameters

Response

Get currencies available for a timestamp.

Authorizations

Parameters

Response

Get fiat rates for multiple timestamps.

Authorizations

Parameters

Response

Broadcast a raw transaction using the path.

Authorizations

Parameters

Response

Broadcast a raw transaction using the request body.

Authorizations

Body

Response

Estimate a fee target.

Authorizations

Parameters

Response