Blockfrost Cardano API - Modified Methods

v6.7.2

Base URL

https://ada-blockfrost.nownodes.ioNOWNodes Cardano (Blockfrost) endpoint (API Changelog 6.6.1 to 6.7.2).

API Changelog 6.6.1 to 6.7.2 - Blockfrost (Cardano), NOWNodes endpoint https://ada-blockfrost.nownodes.io. Computed from the upstream blockfrost-backend-ryo release notes (v6.7.0, v6.7.1, v6.7.2).

Methods whose contract or behavior changed between 6.6.1 and 6.7.2, documented in full as they exist in 6.7.2.

Authentication

api-keyAuthapiKey

NOWNodes API key passed in the api-key header.

API Key: api-key in header

API Changes Blockfrost 6.6.1 > 6.7.2 / Modified methods

Accounts

Accounts operations.

Account information

GET

https://ada-blockfrost.nownodes.io/accounts/{address}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Modified in 6.7.2: registered, active and pool_id are resolved correctly when the account's latest deregistration and re-registration happened in the same transaction (certificates are compared in ledger order), so such accounts no longer report registered: false with a null pool_id.

Returns on-chain information about a specific Cardano stake account identified by its Bech32 stake address. Includes delegation status, controlled balance, reward totals, and MIR sums.

Parameters

stake_addressstringrequiredpath

Bech32-encoded stake address starting with the stake1 prefix.

Response

200OK

HTTP 200 response for getAccount.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or backend failed while processing the request.

Account information

curl -X GET 'https://ada-blockfrost.nownodes.io/accounts/{address}'

const response = await fetch('https://ada-blockfrost.nownodes.io/accounts/{address}', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://ada-blockfrost.nownodes.io/accounts/{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://ada-blockfrost.nownodes.io/accounts/{address}')
data = response.json()

const response = await fetch('https://ada-blockfrost.nownodes.io/accounts/{address}', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://ada-blockfrost.nownodes.io/accounts/{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://ada-blockfrost.nownodes.io/accounts/{address}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ada-blockfrost.nownodes.io/accounts/{address}')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://ada-blockfrost.nownodes.io/accounts/{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)

{
  "stake_address": "stake1uyqcufz4slpgq92jayfdhy8n4mnlrqjrjfprxntzmmedd6q7zzut8",
  "active": true,
  "registered": true,
  "active_epoch": 641,
  "controlled_amount": "25955728541",
  "rewards_sum": "15655779099",
  "withdrawals_sum": "12987239562",
  "withdrawable_amount": "2668539537",
  "pool_id": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
  "drep_id": "drep_always_no_confidence"
}

{
  "code": 4000,
  "message": "Invalid request",
  "retriable": false
}

{
  "status_code": 400,
  "message": "Bad Request",
  "error": "bad_request"
}

Unknown API_key

Missing API_key

{
  "status_code": 500,
  "message": "Internal Server Error",
  "error": "internal_server_error"
}

Total balance of controlled addresses

GET

https://ada-blockfrost.nownodes.io/accounts/{address}/addresses/total

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Modified in 6.7.1: totals are aggregated in a single pass, so asset-heavy accounts complete instead of timing out; with the server-side addressTotalsTxOutLimit option enabled, the endpoint answers HTTP 400 for accounts above the configured tx-output count (disabled by default).

Returns aggregated balance statistics for all payment addresses associated with the given stake key.

Parameters

addressstringrequiredpath

Bech32-encoded stake address whose aggregated totals are queried.

Response

200OK

HTTP 200 response for getAccountAddressesTotal.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or backend failed while processing the request.

Total balance of controlled addresses

curl -X GET 'https://ada-blockfrost.nownodes.io/accounts/{address}/addresses/total'

const response = await fetch('https://ada-blockfrost.nownodes.io/accounts/{address}/addresses/total', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://ada-blockfrost.nownodes.io/accounts/{address}/addresses/total')
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://ada-blockfrost.nownodes.io/accounts/{address}/addresses/total')
data = response.json()

const response = await fetch('https://ada-blockfrost.nownodes.io/accounts/{address}/addresses/total', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://ada-blockfrost.nownodes.io/accounts/{address}/addresses/total";
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://ada-blockfrost.nownodes.io/accounts/{address}/addresses/total', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ada-blockfrost.nownodes.io/accounts/{address}/addresses/total')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://ada-blockfrost.nownodes.io/accounts/{address}/addresses/total')
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)

{
  "stake_address": "stake1uyqcufz4slpgq92jayfdhy8n4mnlrqjrjfprxntzmmedd6q7zzut8",
  "active": true,
  "registered": true,
  "active_epoch": 641,
  "controlled_amount": "25955728541",
  "rewards_sum": "15655779099",
  "withdrawals_sum": "12987239562",
  "withdrawable_amount": "2668539537",
  "pool_id": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
  "drep_id": "drep_always_no_confidence"
}

{
  "code": 4000,
  "message": "Invalid request",
  "retriable": false
}

{
  "status_code": 400,
  "message": "Bad Request",
  "error": "bad_request"
}

Unknown API_key

Missing API_key

{
  "status_code": 500,
  "message": "Internal Server Error",
  "error": "internal_server_error"
}

Account delegation history

GET

https://ada-blockfrost.nownodes.io/accounts/{stake_address}/delegations

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Modified in 6.7.0: pagination is applied before joining auxiliary tables, which improves response times on accounts with long delegation histories; the response shape is unchanged.

Retrieves the complete history of delegation events for a specific Cardano stake account. Each entry represents a transaction where the account changed its delegation to a stake pool, including the effective epoch, amounts, and transaction details.

Parameters

stake_addressstringrequiredpath

Bech32-encoded stake address starting with the stake1 prefix.

Response

200OK

HTTP 200 response for getAccountDelegations.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or backend failed while processing the request.

Account delegation history

curl -X GET 'https://ada-blockfrost.nownodes.io/accounts/{stake_address}/delegations'

const response = await fetch('https://ada-blockfrost.nownodes.io/accounts/{stake_address}/delegations', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://ada-blockfrost.nownodes.io/accounts/{stake_address}/delegations')
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://ada-blockfrost.nownodes.io/accounts/{stake_address}/delegations')
data = response.json()

const response = await fetch('https://ada-blockfrost.nownodes.io/accounts/{stake_address}/delegations', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://ada-blockfrost.nownodes.io/accounts/{stake_address}/delegations";
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://ada-blockfrost.nownodes.io/accounts/{stake_address}/delegations', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ada-blockfrost.nownodes.io/accounts/{stake_address}/delegations')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://ada-blockfrost.nownodes.io/accounts/{stake_address}/delegations')
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)

{
  "stake_address": "stake1uyqcufz4slpgq92jayfdhy8n4mnlrqjrjfprxntzmmedd6q7zzut8",
  "active": true,
  "registered": true,
  "active_epoch": 641,
  "controlled_amount": "25955728541",
  "rewards_sum": "15655779099",
  "withdrawals_sum": "12987239562",
  "withdrawable_amount": "2668539537",
  "pool_id": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
  "drep_id": "drep_always_no_confidence"
}

{
  "code": 4000,
  "message": "Invalid request",
  "retriable": false
}

{
  "status_code": 400,
  "message": "Bad Request",
  "error": "bad_request"
}

Unknown API_key

Missing API_key

{
  "status_code": 500,
  "message": "Internal Server Error",
  "error": "internal_server_error"
}

Addresses

Addresses operations.

Get address totals

GET

https://ada-blockfrost.nownodes.io/addresses/{address}/total

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Modified in 6.7.1: totals are aggregated in a single pass, so asset-heavy addresses complete instead of timing out; with the server-side addressTotalsTxOutLimit option enabled, the endpoint answers HTTP 400 for addresses above the configured tx-output count (disabled by default).

Returns cumulative transaction statistics for a specific address including total ADA received, sent, and transaction count.

Parameters

addressstringrequiredpath

Bech32-encoded Cardano address to query.

Response

200OK

HTTP 200 response for getAddressTotals.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or backend failed while processing the request.

Get address totals

curl -X GET 'https://ada-blockfrost.nownodes.io/addresses/{address}/total'

const response = await fetch('https://ada-blockfrost.nownodes.io/addresses/{address}/total', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://ada-blockfrost.nownodes.io/addresses/{address}/total')
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://ada-blockfrost.nownodes.io/addresses/{address}/total')
data = response.json()

const response = await fetch('https://ada-blockfrost.nownodes.io/addresses/{address}/total', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://ada-blockfrost.nownodes.io/addresses/{address}/total";
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://ada-blockfrost.nownodes.io/addresses/{address}/total', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ada-blockfrost.nownodes.io/addresses/{address}/total')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://ada-blockfrost.nownodes.io/addresses/{address}/total')
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": "addr1qx2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3a3cw7eygp6r7g4w0n4q3v4qaryeuw8c9r9j4q4g4q3f4zq0j6x8",
  "amount": [
    {
      "unit": "lovelace",
      "quantity": "94923541"
    },
    {
      "unit": "533bb94a8850ee3ccbe483106489399112b74c905342cb1792a797a0494e4459",
      "quantity": "221350388"
    }
  ],
  "stake_address": "stake1uyqcufz4slpgq92jayfdhy8n4mnlrqjrjfprxntzmmedd6q7zzut8",
  "type": "shelley",
  "script": false
}

{
  "code": 4000,
  "message": "Invalid request",
  "retriable": false
}

{
  "status_code": 400,
  "message": "Bad Request",
  "error": "bad_request"
}

Unknown API_key

Missing API_key

{
  "status_code": 500,
  "message": "Internal Server Error",
  "error": "internal_server_error"
}

Assets

Assets operations.

Asset transaction history

GET

https://ada-blockfrost.nownodes.io/assets/{asset}/transactions

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Modified in 6.7.2: the from and to query parameters are now applied - block-range filtering in the block_number[:tx_index] form, inclusive, matching /addresses/{address}/transactions (previously the parameters were parsed but never affected the result).

Returns a paginated list of all transactions involving the specified native asset. The from and to parameters filter by an inclusive block_number[:tx_index] range.

Parameters

assetstringrequiredpath

Asset unit identifier (policy ID concatenated with the hex-encoded asset name).

pageinteger<int64>query

Page number for pagination. Defaults to 1.

countinteger<int64><= 100100query

Maximum number of results per page. Defaults to 100; cannot exceed 100.

orderstringascdescdescquery

Sort order of the results.

fromstringquery

Block number, optionally suffixed with :tx_index, where the block range starts (inclusive).

tostringquery

Block number, optionally suffixed with :tx_index, where the block range ends (inclusive).

Response

200OK

HTTP 200 response for getAssetTransactions.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or backend failed while processing the request.

Asset transaction history

curl -X GET 'https://ada-blockfrost.nownodes.io/assets/{asset}/transactions'

const response = await fetch('https://ada-blockfrost.nownodes.io/assets/{asset}/transactions', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://ada-blockfrost.nownodes.io/assets/{asset}/transactions')
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://ada-blockfrost.nownodes.io/assets/{asset}/transactions')
data = response.json()

const response = await fetch('https://ada-blockfrost.nownodes.io/assets/{asset}/transactions', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://ada-blockfrost.nownodes.io/assets/{asset}/transactions";
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://ada-blockfrost.nownodes.io/assets/{asset}/transactions', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ada-blockfrost.nownodes.io/assets/{asset}/transactions')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://ada-blockfrost.nownodes.io/assets/{asset}/transactions')
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)

[
  {
    "asset": "533bb94a8850ee3ccbe483106489399112b74c905342cb1792a797a0494e4459",
    "quantity": "221350388"
  }
]

{
  "code": 4000,
  "message": "Invalid request",
  "retriable": false
}

{
  "status_code": 400,
  "message": "Bad Request",
  "error": "bad_request"
}

Unknown API_key

Missing API_key

{
  "status_code": 500,
  "message": "Internal Server Error",
  "error": "internal_server_error"
}

Documentation

How to migrate to NOWNodes

Blockfrost Cardano API - Modified Methods

Authentication

API Changes Blockfrost 6.6.1 > 6.7.2 / Modified methods

Accounts

Account information

Authorizations

Parameters

Response

Total balance of controlled addresses

Authorizations

Parameters

Response

Account delegation history

Authorizations

Parameters

Response

Addresses

Get address totals

Authorizations

Parameters

Response

Assets

Asset transaction history

Authorizations

Parameters

Response