Blockfrost Cardano API

v1.0.0

Base URLs

https://ada-blockfrost.nownodes.ioNOWNodes Cardano blockfrost endpoint.

https://ada.nownodes.ioNOWNodes Cardano rosetta endpoint.

Cardano (ADA)

Cardano (ADA) Documentation with NOWNodes

The Cardano API provides a structured way to interact with the Cardano (ADA) blockchain, enabling developers to access blocks, UTXOs, stake data, accounts, and network information while also supporting transaction construction and submission through various ecosystem-standard interfaces. The Cardano API allows efficient interaction with blockchain resources, and this doc serves as an overview for developers searching for Cardano docs, api docs, submit transaction, and integration for web applications.

Through NOWNodes, developers gain high-availability access to Cardano Mainnet without deploying or managing their own node infrastructure. The platform ensures stable performance, scalable throughput, and straightforward integration into your code, applications, and web services, supporting a wide range of Cardano-based development workflows.

NOWNodes Cardano (ADA) Interfaces

Cardano Rosetta API - Provides standardized blockchain data, balance queries, UTXO access, and transaction construction using the Rosetta specification for multi-chain interoperability.
Cardano Blockfrost API - Offers detailed blockchain insights including blocks, addresses, assets, metadata, and transaction submission aligned with the Blockfrost schema.
Cardano Ogmios WebSocket (WSS) - A low-latency WebSocket interface enabling real-time chain synchronization, event streaming, and high-performance transaction workflows.

Using the Cardano API docs with NOWNodes, developers can efficiently integrate Cardano into any application, leveraging multiple interface standards to match their architecture. The documentation provides complete guidance for working with the network's UTXO model, Rosetta semantics, Blockfrost endpoints, and Ogmios streaming, ensuring full support for code-level implementation and production-ready workflows.

Blockfrost API for the Cardano blockchain. Provides endpoints for querying health status, accounts, addresses, assets, blocks, epochs, genesis configuration, metadata, network eras, stake pools, scripts, transactions, and utility operations. Authentication is performed via an API key passed in the api-key header.

Authentication

api-keyAuthapiKey

NOWNodes API key passed in the api-key header.

API Key: api-key in header

Blockfrost

Health

Health operations.

API Health Status

GET

https://ada-blockfrost.nownodes.io/health

Returns the current health status of the Blockfrost backend. When the service is fully operational and synchronised with the Cardano blockchain the is_healthy flag is true.

Response

200OK

HTTP 200 response for getHealthStatus.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

API Health Status

curl -X GET 'https://ada-blockfrost.nownodes.io/health'

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

const data = await response.json();

import requests

response = requests.get('https://ada-blockfrost.nownodes.io/health')
data = response.json()

{
  "status": "ok"
}

{
  "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"
}

API Clock Synchronisation

GET

https://ada-blockfrost.nownodes.io/health/clock

Returns the current UNIX timestamp (in milliseconds) reported by the Blockfrost server. Useful for detecting clock drift between the client system and the Blockfrost infrastructure.

Response

200OK

HTTP 200 response for getHealthClock.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

API Clock Synchronisation

curl -X GET 'https://ada-blockfrost.nownodes.io/health/clock'

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

const data = await response.json();

import requests

response = requests.get('https://ada-blockfrost.nownodes.io/health/clock')
data = response.json()

{
  "server_time": 1783421965000
}

{
  "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"
}

Accounts

Accounts operations.

Account information

GET

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

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 'stake1' prefix. This is the staking credential associated with a Cardano wallet

addressstringrequiredpath

Cardano payment address in Bech32 format.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

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();

import requests

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

{
  "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 reward history

GET

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

Returns a paginated list of all staking rewards received by the specified stake address, broken down by epoch.

Parameters

addressstringrequiredpath

Bech32-encoded stake address of the account whose reward history is being queried.

Response

200OK

HTTP 200 response for getAccountRewards.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Account reward history

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

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

const data = await response.json();

import requests

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

{
  "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 registration history

GET

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

Retrieves the complete history of registration and deregistration events for a specific Cardano stake account, including transaction details and timestamps

Parameters

stake_addressstringrequiredpath

The Bech32-encoded Cardano stake address (starts with 'stake1') for which to retrieve registration history

Response

200OK

HTTP 200 response for getAccountRegistrations.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Account registration history

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

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

const data = await response.json();

import requests

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

{
  "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 withdrawals

GET

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

Retrieves the complete history of reward withdrawals for a specific Cardano stake account. Withdrawals transfer accumulated staking rewards from the reward account to a regular address for spending

Parameters

stake_addressstringrequiredpath

The Bech32-encoded Cardano stake address (starts with 'stake1') for which to retrieve withdrawal history

addressstringrequiredpath

Cardano payment address in Bech32 format.

Response

200OK

HTTP 200 response for getAccountWithdrawals.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Account withdrawals

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

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

const data = await response.json();

import requests

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

{
  "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 MIRs

GET

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

Retrieves the complete history of Move Instantaneous Rewards (MIR) for a specific Cardano stake account. MIR certificates are used to transfer funds from the Cardano reserves or treasury directly to stake addresses, typically during special distribution events or protocol transitions

Parameters

stake_addressstringrequiredpath

The Bech32-encoded Cardano stake address (starts with 'stake1') for which to retrieve MIR history

addressstringrequiredpath

Cardano payment address in Bech32 format.

Response

200OK

HTTP 200 response for getAccountMIRs.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Account MIRs

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

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

const data = await response.json();

import requests

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

{
  "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"
}

Associated addresses

GET

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

Returns all payment (UTXO) addresses that are controlled by the given stake key.

Parameters

addressstringrequiredpath

Bech32-encoded stake address used to look up associated payment addresses.

Response

200OK

HTTP 200 response for getAccountAddresses.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Associated addresses

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

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

const data = await response.json();

import requests

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

{
  "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"
}

Assets in associated addresses

GET

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

Returns all native assets held across every payment address controlled by the given stake key.

Parameters

addressstringrequiredpath

Bech32-encoded stake address whose controlled assets are queried.

Response

200OK

HTTP 200 response for getAccountAddressAssets.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Assets in associated addresses

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

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

const data = await response.json();

import requests

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

{
  "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

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

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();

import requests

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

{
  "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 stake history

GET

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

Returns a chronological list of the account's staking history showing the delegated amount and target pool for each epoch in which the stake key was active.

Parameters

stake_addressstringrequiredpath

Bech32-encoded stake address whose staking history is being queried.

Response

200OK

HTTP 200 response for getAccountHistory.

400Bad Request

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

401Unauthorized

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

404Not Found

Stake address not found.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Account stake history

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

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

const data = await response.json();

import requests

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

{
  "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

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

The Bech32-encoded Cardano stake address (starts with 'stake1') for which to retrieve delegation history

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

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();

import requests

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

{
  "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 information

GET

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

Returns detailed information about a specific Cardano address including current balance, address type, and linked stake address.

Parameters

addressstringrequiredpath

Bech32-encoded Cardano address to query.

Response

200OK

HTTP 200 response for getAddress.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get address information

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

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

const data = await response.json();

import requests

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

{
  "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"
}

Get address totals

GET

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

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

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();

import requests

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

{
  "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"
}

Get UTXOs by asset

GET

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

Returns all unspent transaction outputs (UTXOs) at the given address that contain the specified native asset.

Parameters

addressstringrequiredpath

Bech32-encoded Cardano address to query for UTXOs.

assetstringrequiredpath

Asset unit identifier formed by concatenating the policy ID and hex-encoded asset name.

Response

200OK

HTTP 200 response for getAddressUtxosByAsset.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get UTXOs by asset

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

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

const data = await response.json();

import requests

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

{
  "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"
}

Get address transactions

GET

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

Returns a paginated list of transactions involving the specified address, ordered by block height.

Parameters

addressstringrequiredpath

Bech32-encoded Cardano address whose transaction history is being queried.

countinteger<= 100100query

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

pageinteger1query

Page number for pagination. Defaults to 1.

orderstringascdescdescquery

Sort order of the results by block height. "asc" for ascending, "desc" for descending.

Response

200OK

HTTP 200 response for getAddressTransactions.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get address transactions

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

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

const data = await response.json();

import requests

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

{
  "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"
}

Get extended address information

GET

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

Returns detailed information about a specific Cardano address including current balances with decimal precision metadata and NFT on-chain metadata flags for each held asset, the linked stake address, address type, and whether the address is script-controlled.

Parameters

addressstringrequiredpath

Bech32-encoded Cardano payment address to query.

Response

200OK

HTTP 200 response for getAddressExtended.

400Bad Request

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

401Unauthorized

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

404Not Found

Address not found on the blockchain.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get extended address information

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

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

const data = await response.json();

import requests

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

{
  "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"
}

Get address UTXOs

GET

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

Returns all unspent transaction outputs (UTXOs) currently held at the specified Cardano address. Each UTXO includes the originating transaction hash, output index, value breakdown, optional datum information, and reference script hash.

Parameters

addressstringrequiredpath

Bech32-encoded Cardano payment address whose UTXOs are being queried.

Response

200OK

HTTP 200 response for getAddressUtxos.

400Bad Request

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

401Unauthorized

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

404Not Found

Address not found.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get address UTXOs

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

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

const data = await response.json();

import requests

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

{
  "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.

List all assets

GET

https://ada-blockfrost.nownodes.io/assets

Returns a paginated list of all native assets minted on the Cardano blockchain.

Parameters

pageinteger1query

Page number for pagination. Defaults to 1.

countinteger<= 100100query

Maximum number of results per page. Defaults to 100; max 100.

orderstringascdescdescquery

Sort order of the results. "asc" for ascending, "desc" for descending.

Response

200OK

HTTP 200 response for listAssets.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

List all assets

curl -X GET 'https://ada-blockfrost.nownodes.io/assets'

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

const data = await response.json();

import requests

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

[
  {
    "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"
}

Asset information

GET

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

Returns detailed on-chain metadata, supply information, and optional off-chain metadata for a specific native asset.

Parameters

assetstringrequiredpath

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

Response

200OK

HTTP 200 response for getAsset.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Asset information

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

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

const data = await response.json();

import requests

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

{
  "asset": "533bb94a8850ee3ccbe483106489399112b74c905342cb1792a797a0494e4459",
  "policy_id": "533bb94a8850ee3ccbe483106489399112b74c905342cb1792a797a049",
  "asset_name": "4e4459",
  "fingerprint": "asset1rjklcrnsdzqp65wjgrg55sy9723kw09mlgvlc3",
  "quantity": "221350388",
  "initial_mint_tx_hash": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
  "mint_or_burn_count": 1
}

{
  "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"
}

Asset mint/burn history

GET

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

Returns a paginated history of all mint and burn events for the specified native asset.

Parameters

assetstringrequiredpath

Asset unit identifier (policy ID + hex-encoded asset name).

pageinteger1query

Page number for pagination. Defaults to 1.

countinteger<= 100100query

Maximum number of results per page. Defaults to 100; max 100.

orderstringascdescdescquery

Sort order of the results.

Response

200OK

HTTP 200 response for getAssetHistory.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Asset mint/burn history

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

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

const data = await response.json();

import requests

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

[
  {
    "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"
}

Asset transaction history

GET

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

Returns a paginated list of all transactions involving the specified native asset.

Parameters

assetstringrequiredpath

Asset unit identifier (policy ID + hex-encoded asset name).

pageinteger1query

Page number for pagination. Defaults to 1.

countinteger<= 100100query

Maximum number of results per page. Defaults to 100; max 100.

orderstringascdescdescquery

Sort order of the results.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

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();

import requests

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

[
  {
    "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"
}

Asset distribution

GET

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

Returns a paginated list of all addresses that hold the specified native asset along with the quantity each holds.

Parameters

assetstringrequiredpath

Asset unit identifier (policy ID + hex-encoded asset name).

pageinteger1query

Page number for pagination. Defaults to 1.

countinteger<= 100100query

Maximum number of results per page. Defaults to 100; max 100.

orderstringascdescdescquery

Sort order of the results.

Response

200OK

HTTP 200 response for getAssetAddresses.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Asset distribution

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

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

const data = await response.json();

import requests

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

[
  {
    "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"
}

Assets by policy

GET

https://ada-blockfrost.nownodes.io/assets/policy/{policy_id}

Returns all native assets minted under the specified minting policy ID.

Parameters

policy_idstringrequiredpath

Blake2b-224 hash of the minting policy script.

pageinteger1query

Page number for pagination. Defaults to 1.

countinteger<= 100100query

Maximum number of results per page. Defaults to 100; max 100.

orderstringascdescdescquery

Sort order of the results.

Response

200OK

HTTP 200 response for getAssetsByPolicy.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Assets by policy

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

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

const data = await response.json();

import requests

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

[
  {
    "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"
}

Blocks

Blocks operations.

Get latest block

GET

https://ada-blockfrost.nownodes.io/blocks/latest

Returns full details of the most recently minted block on the Cardano blockchain.

Response

200OK

HTTP 200 response for getLatestBlock.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get latest block

curl -X GET 'https://ada-blockfrost.nownodes.io/blocks/latest'

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

const data = await response.json();

import requests

response = requests.get('https://ada-blockfrost.nownodes.io/blocks/latest')
data = response.json()

{
  "time": 1783421965,
  "height": 13646894,
  "hash": "9945cd69ca8e6bcf2e5f9a14742be0c051bf9dd916f0bb0b00ab39977b140d53",
  "slot": 191855674,
  "epoch": 641,
  "epoch_slot": 306874,
  "slot_leader": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
  "size": 2084,
  "tx_count": 4,
  "output": "76480267030",
  "fees": "955311",
  "previous_block": "2895f4973b87ef8632957a3b0c849fd46089dd776c21d799b996c210045b4105",
  "next_block": null,
  "confirmations": 0
}

{
  "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"
}

Get transactions in latest block

GET

https://ada-blockfrost.nownodes.io/blocks/latest/txs

Returns a list of transaction hashes included in the most recently minted block.

Response

200OK

HTTP 200 response for getLatestBlockTxs.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get transactions in latest block

curl -X GET 'https://ada-blockfrost.nownodes.io/blocks/latest/txs'

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

const data = await response.json();

import requests

response = requests.get('https://ada-blockfrost.nownodes.io/blocks/latest/txs')
data = response.json()

{
  "time": 1783421965,
  "height": 13646894,
  "hash": "9945cd69ca8e6bcf2e5f9a14742be0c051bf9dd916f0bb0b00ab39977b140d53",
  "slot": 191855674,
  "epoch": 641,
  "epoch_slot": 306874,
  "slot_leader": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
  "size": 2084,
  "tx_count": 4,
  "output": "76480267030",
  "fees": "955311",
  "previous_block": "2895f4973b87ef8632957a3b0c849fd46089dd776c21d799b996c210045b4105",
  "next_block": null,
  "confirmations": 0
}

{
  "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"
}

Get block by ID or hash

GET

https://ada-blockfrost.nownodes.io/blocks/{block_id}

Returns full details of a specific block identified by its Blake2b-256 hash or block number.

Parameters

block_idstringrequiredpath

Block identifier — either the Blake2b-256 block hash or the integer block number (height).

Response

200OK

HTTP 200 response for getBlockById.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get block by ID or hash

curl -X GET 'https://ada-blockfrost.nownodes.io/blocks/{block_id}'

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

const data = await response.json();

import requests

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

{
  "time": 1783421965,
  "height": 13646894,
  "hash": "9945cd69ca8e6bcf2e5f9a14742be0c051bf9dd916f0bb0b00ab39977b140d53",
  "slot": 191855674,
  "epoch": 641,
  "epoch_slot": 306874,
  "slot_leader": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
  "size": 2084,
  "tx_count": 4,
  "output": "76480267030",
  "fees": "955311",
  "previous_block": "2895f4973b87ef8632957a3b0c849fd46089dd776c21d799b996c210045b4105",
  "next_block": null,
  "confirmations": 0
}

{
  "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"
}

Get next blocks

GET

https://ada-blockfrost.nownodes.io/blocks/{block_id}/next

Returns a paginated list of blocks that follow the specified block.

Parameters

block_idstringrequiredpath

Block hash or block number of the starting block.

Response

200OK

HTTP 200 response for getNextBlocks.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get next blocks

curl -X GET 'https://ada-blockfrost.nownodes.io/blocks/{block_id}/next'

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

const data = await response.json();

import requests

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

{
  "time": 1783421965,
  "height": 13646894,
  "hash": "9945cd69ca8e6bcf2e5f9a14742be0c051bf9dd916f0bb0b00ab39977b140d53",
  "slot": 191855674,
  "epoch": 641,
  "epoch_slot": 306874,
  "slot_leader": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
  "size": 2084,
  "tx_count": 4,
  "output": "76480267030",
  "fees": "955311",
  "previous_block": "2895f4973b87ef8632957a3b0c849fd46089dd776c21d799b996c210045b4105",
  "next_block": null,
  "confirmations": 0
}

{
  "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"
}

Get previous blocks

GET

https://ada-blockfrost.nownodes.io/blocks/{block_id}/previous

Returns a paginated list of blocks that precede the specified block.

Parameters

block_idstringrequiredpath

Block hash or block number of the starting block.

Response

200OK

HTTP 200 response for getPreviousBlocks.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get previous blocks

curl -X GET 'https://ada-blockfrost.nownodes.io/blocks/{block_id}/previous'

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

const data = await response.json();

import requests

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

{
  "time": 1783421965,
  "height": 13646894,
  "hash": "9945cd69ca8e6bcf2e5f9a14742be0c051bf9dd916f0bb0b00ab39977b140d53",
  "slot": 191855674,
  "epoch": 641,
  "epoch_slot": 306874,
  "slot_leader": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
  "size": 2084,
  "tx_count": 4,
  "output": "76480267030",
  "fees": "955311",
  "previous_block": "2895f4973b87ef8632957a3b0c849fd46089dd776c21d799b996c210045b4105",
  "next_block": null,
  "confirmations": 0
}

{
  "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"
}

Get block by slot number

GET

https://ada-blockfrost.nownodes.io/blocks/slot/{slot}

Returns the block that was produced in the specified absolute slot number.

Parameters

slotintegerrequiredpath

Absolute slot number to look up.

Response

200OK

HTTP 200 response for getBlockBySlot.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get block by slot number

curl -X GET 'https://ada-blockfrost.nownodes.io/blocks/slot/{slot}'

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

const data = await response.json();

import requests

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

{
  "time": 1783421965,
  "height": 13646894,
  "hash": "9945cd69ca8e6bcf2e5f9a14742be0c051bf9dd916f0bb0b00ab39977b140d53",
  "slot": 191855674,
  "epoch": 641,
  "epoch_slot": 306874,
  "slot_leader": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
  "size": 2084,
  "tx_count": 4,
  "output": "76480267030",
  "fees": "955311",
  "previous_block": "2895f4973b87ef8632957a3b0c849fd46089dd776c21d799b996c210045b4105",
  "next_block": null,
  "confirmations": 0
}

{
  "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"
}

Get block by epoch and slot

GET

https://ada-blockfrost.nownodes.io/blocks/epoch/{epoch}/slot/{slot}

Returns the block produced at the given slot within the specified epoch.

Parameters

epochintegerrequiredpath

Epoch number in which the slot resides.

slotintegerrequiredpath

Slot number within the specified epoch.

Response

200OK

HTTP 200 response for getBlockByEpochSlot.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get block by epoch and slot

curl -X GET 'https://ada-blockfrost.nownodes.io/blocks/epoch/{epoch}/slot/{slot}'

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

const data = await response.json();

import requests

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

{
  "time": 1783421965,
  "height": 13646894,
  "hash": "9945cd69ca8e6bcf2e5f9a14742be0c051bf9dd916f0bb0b00ab39977b140d53",
  "slot": 191855674,
  "epoch": 641,
  "epoch_slot": 306874,
  "slot_leader": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
  "size": 2084,
  "tx_count": 4,
  "output": "76480267030",
  "fees": "955311",
  "previous_block": "2895f4973b87ef8632957a3b0c849fd46089dd776c21d799b996c210045b4105",
  "next_block": null,
  "confirmations": 0
}

{
  "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"
}

Get transactions in a block

GET

https://ada-blockfrost.nownodes.io/blocks/{block}/txs

Returns all transaction hashes included in the specified block.

Parameters

blockstringrequiredpath

Block hash or block number.

Response

200OK

HTTP 200 response for getBlockTxs.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get transactions in a block

curl -X GET 'https://ada-blockfrost.nownodes.io/blocks/{block}/txs'

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

const data = await response.json();

import requests

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

{
  "time": 1783421965,
  "height": 13646894,
  "hash": "9945cd69ca8e6bcf2e5f9a14742be0c051bf9dd916f0bb0b00ab39977b140d53",
  "slot": 191855674,
  "epoch": 641,
  "epoch_slot": 306874,
  "slot_leader": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
  "size": 2084,
  "tx_count": 4,
  "output": "76480267030",
  "fees": "955311",
  "previous_block": "2895f4973b87ef8632957a3b0c849fd46089dd776c21d799b996c210045b4105",
  "next_block": null,
  "confirmations": 0
}

{
  "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"
}

Get addresses involved in a block

GET

https://ada-blockfrost.nownodes.io/blocks/{block}/addresses

Returns all unique addresses that appear as inputs or outputs in any transaction within the specified block.

Parameters

blockstringrequiredpath

Block hash or block number.

Response

200OK

HTTP 200 response for getBlockAddresses.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get addresses involved in a block

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

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

const data = await response.json();

import requests

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

{
  "time": 1783421965,
  "height": 13646894,
  "hash": "9945cd69ca8e6bcf2e5f9a14742be0c051bf9dd916f0bb0b00ab39977b140d53",
  "slot": 191855674,
  "epoch": 641,
  "epoch_slot": 306874,
  "slot_leader": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
  "size": 2084,
  "tx_count": 4,
  "output": "76480267030",
  "fees": "955311",
  "previous_block": "2895f4973b87ef8632957a3b0c849fd46089dd776c21d799b996c210045b4105",
  "next_block": null,
  "confirmations": 0
}

{
  "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"
}

Epochs

Epochs operations.

Get latest epoch

GET

https://ada-blockfrost.nownodes.io/epochs/latest

Returns the number of the current (latest) epoch on the Cardano blockchain.

Response

200OK

HTTP 200 response for getLatestEpoch.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get latest epoch

curl -X GET 'https://ada-blockfrost.nownodes.io/epochs/latest'

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

const data = await response.json();

import requests

response = requests.get('https://ada-blockfrost.nownodes.io/epochs/latest')
data = response.json()

{
  "epoch": 641,
  "start_time": 1783080000,
  "end_time": 1783512000,
  "first_block_time": 1783080001,
  "last_block_time": 1783421965,
  "block_count": 21600,
  "tx_count": 250000,
  "output": "1000000000000",
  "fees": "100000000"
}

{
  "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"
}

Get latest epoch protocol parameters

GET

https://ada-blockfrost.nownodes.io/epochs/latest/parameters

Returns the full set of protocol parameters that are active during the current (latest) epoch.

Response

200OK

HTTP 200 response for getLatestEpochParameters.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get latest epoch protocol parameters

curl -X GET 'https://ada-blockfrost.nownodes.io/epochs/latest/parameters'

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

const data = await response.json();

import requests

response = requests.get('https://ada-blockfrost.nownodes.io/epochs/latest/parameters')
data = response.json()

{
  "epoch": 641,
  "start_time": 1783080000,
  "end_time": 1783512000,
  "first_block_time": 1783080001,
  "last_block_time": 1783421965,
  "block_count": 21600,
  "tx_count": 250000,
  "output": "1000000000000",
  "fees": "100000000"
}

{
  "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"
}

Get next epochs

GET

https://ada-blockfrost.nownodes.io/epochs/{epoch}/next

Returns a list of epoch numbers that follow the specified epoch.

Parameters

epochintegerrequiredpath

Starting epoch number.

Response

200OK

HTTP 200 response for getNextEpochs.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get next epochs

curl -X GET 'https://ada-blockfrost.nownodes.io/epochs/{epoch}/next'

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

const data = await response.json();

import requests

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

{
  "epoch": 641,
  "start_time": 1783080000,
  "end_time": 1783512000,
  "first_block_time": 1783080001,
  "last_block_time": 1783421965,
  "block_count": 21600,
  "tx_count": 250000,
  "output": "1000000000000",
  "fees": "100000000"
}

{
  "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"
}

Get previous epochs

GET

https://ada-blockfrost.nownodes.io/epochs/{epoch}/previous

Returns a list of epoch numbers that precede the specified epoch.

Parameters

epochintegerrequiredpath

Starting epoch number.

Response

200OK

HTTP 200 response for getPreviousEpochs.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get previous epochs

curl -X GET 'https://ada-blockfrost.nownodes.io/epochs/{epoch}/previous'

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

const data = await response.json();

import requests

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

{
  "epoch": 641,
  "start_time": 1783080000,
  "end_time": 1783512000,
  "first_block_time": 1783080001,
  "last_block_time": 1783421965,
  "block_count": 21600,
  "tx_count": 250000,
  "output": "1000000000000",
  "fees": "100000000"
}

{
  "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"
}

Get stake distribution for epoch

GET

https://ada-blockfrost.nownodes.io/epochs/{epoch}/stakes

Returns the stake distribution across all pools for the specified epoch, including active stake and delegator count.

Parameters

epochintegerrequiredpath

Epoch number for which to retrieve the stake snapshot.

pageinteger1query

Page number for pagination. Defaults to 1.

countinteger<= 100100query

Maximum results per page. Defaults to 100; max 100.

orderstringascdescdescquery

Sort order.

Response

200OK

HTTP 200 response for getEpochStakes.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get stake distribution for epoch

curl -X GET 'https://ada-blockfrost.nownodes.io/epochs/{epoch}/stakes'

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

const data = await response.json();

import requests

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

{
  "epoch": 641,
  "start_time": 1783080000,
  "end_time": 1783512000,
  "first_block_time": 1783080001,
  "last_block_time": 1783421965,
  "block_count": 21600,
  "tx_count": 250000,
  "output": "1000000000000",
  "fees": "100000000"
}

{
  "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"
}

Get stake for specific pool in epoch

GET

https://ada-blockfrost.nownodes.io/epochs/{epoch}/stakes/{pool}

Returns the stake distribution for a single pool during the specified epoch.

Parameters

epochintegerrequiredpath

Epoch number.

poolstringrequiredpath

Bech32-encoded or hex-encoded stake pool ID.

Response

200OK

HTTP 200 response for getEpochStakeByPool.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get stake for specific pool in epoch

curl -X GET 'https://ada-blockfrost.nownodes.io/epochs/{epoch}/stakes/{pool}'

const response = await fetch('https://ada-blockfrost.nownodes.io/epochs/{epoch}/stakes/{pool}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ada-blockfrost.nownodes.io/epochs/{epoch}/stakes/{pool}')
data = response.json()

{
  "epoch": 641,
  "start_time": 1783080000,
  "end_time": 1783512000,
  "first_block_time": 1783080001,
  "last_block_time": 1783421965,
  "block_count": 21600,
  "tx_count": 250000,
  "output": "1000000000000",
  "fees": "100000000"
}

{
  "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"
}

Get blocks in epoch

GET

https://ada-blockfrost.nownodes.io/epochs/{epoch}/blocks

Returns a paginated list of blocks minted during the specified epoch.

Parameters

epochintegerrequiredpath

Epoch number.

pageinteger1query

Page number. Defaults to 1.

countinteger<= 100100query

Results per page. Defaults to 100; max 100.

orderstringascdescdescquery

Sort order.

Response

200OK

HTTP 200 response for getEpochBlocks.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get blocks in epoch

curl -X GET 'https://ada-blockfrost.nownodes.io/epochs/{epoch}/blocks'

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

const data = await response.json();

import requests

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

{
  "epoch": 641,
  "start_time": 1783080000,
  "end_time": 1783512000,
  "first_block_time": 1783080001,
  "last_block_time": 1783421965,
  "block_count": 21600,
  "tx_count": 250000,
  "output": "1000000000000",
  "fees": "100000000"
}

{
  "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"
}

Get blocks minted by pool in epoch

GET

https://ada-blockfrost.nownodes.io/epochs/{epoch}/blocks/{pool}

Returns blocks minted by a specific stake pool during the given epoch.

Parameters

epochintegerrequiredpath

Epoch number.

poolstringrequiredpath

Bech32 or hex-encoded stake pool ID.

pageinteger1query

Page number. Defaults to 1.

countinteger<= 100100query

Results per page. Max 100.

orderstringascdescdescquery

Sort order.

Response

200OK

HTTP 200 response for getEpochBlocksByPool.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get blocks minted by pool in epoch

curl -X GET 'https://ada-blockfrost.nownodes.io/epochs/{epoch}/blocks/{pool}'

const response = await fetch('https://ada-blockfrost.nownodes.io/epochs/{epoch}/blocks/{pool}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ada-blockfrost.nownodes.io/epochs/{epoch}/blocks/{pool}')
data = response.json()

{
  "time": 1783421965,
  "height": 13646894,
  "hash": "9945cd69ca8e6bcf2e5f9a14742be0c051bf9dd916f0bb0b00ab39977b140d53",
  "slot": 191855674,
  "epoch": 641,
  "epoch_slot": 306874,
  "slot_leader": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
  "size": 2084,
  "tx_count": 4,
  "output": "76480267030",
  "fees": "955311",
  "previous_block": "2895f4973b87ef8632957a3b0c849fd46089dd776c21d799b996c210045b4105",
  "next_block": null,
  "confirmations": 0
}

{
  "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"
}

Get protocol parameters for epoch

GET

https://ada-blockfrost.nownodes.io/epochs/{epoch}/parameters

Returns the protocol parameters that were active during the specified epoch.

Parameters

epochintegerrequiredpath

Epoch number.

Response

200OK

HTTP 200 response for getEpochParameters.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get protocol parameters for epoch

curl -X GET 'https://ada-blockfrost.nownodes.io/epochs/{epoch}/parameters'

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

const data = await response.json();

import requests

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

{
  "epoch": 641,
  "start_time": 1783080000,
  "end_time": 1783512000,
  "first_block_time": 1783080001,
  "last_block_time": 1783421965,
  "block_count": 21600,
  "tx_count": 250000,
  "output": "1000000000000",
  "fees": "100000000"
}

{
  "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"
}

Get epoch details

GET

https://ada-blockfrost.nownodes.io/epochs/{epoch}

Returns comprehensive information about a specific Cardano epoch including its time boundaries, block and transaction counts, total output and fees, and the active stake snapshot.

Parameters

epochintegerrequiredpath

The epoch number to query.

Response

200OK

HTTP 200 response for getEpoch.

400Bad Request

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

401Unauthorized

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

404Not Found

Epoch not found.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get epoch details

curl -X GET 'https://ada-blockfrost.nownodes.io/epochs/{epoch}'

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

const data = await response.json();

import requests

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

{
  "epoch": 641,
  "start_time": 1783080000,
  "end_time": 1783512000,
  "first_block_time": 1783080001,
  "last_block_time": 1783421965,
  "block_count": 21600,
  "tx_count": 250000,
  "output": "1000000000000",
  "fees": "100000000"
}

{
  "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"
}

Genesis

Genesis operations.

Get genesis configuration

GET

https://ada-blockfrost.nownodes.io/genesis

Returns the genesis configuration parameters that were used to bootstrap the Cardano blockchain.

Response

200OK

HTTP 200 response for getGenesis.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get genesis configuration

curl -X GET 'https://ada-blockfrost.nownodes.io/genesis'

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

const data = await response.json();

import requests

response = requests.get('https://ada-blockfrost.nownodes.io/genesis')
data = response.json()

{
  "active_slots_coefficient": 0.05,
  "update_quorum": 5,
  "max_lovelace_supply": "45000000000000000",
  "network_magic": 764824073,
  "epoch_length": 432000,
  "system_start": 1506203091,
  "slots_per_kes_period": 129600,
  "slot_length": 1
}

{
  "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"
}

Governance

Governance operations.

Get the constitutional committee information

GET

https://ada-blockfrost.nownodes.io/governance/committee

Returns information about the current constitutional committee, including its quorum threshold and the list of committee members with their credentials and status.

Response

200OK

HTTP 200 response for getGovernanceCommittee.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get the constitutional committee information

curl -X GET 'https://ada-blockfrost.nownodes.io/governance/committee'

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

const data = await response.json();

import requests

response = requests.get('https://ada-blockfrost.nownodes.io/governance/committee')
data = response.json()

[]

{
  "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"
}

Blockfrost

Blockfrost operations.

Get the constitutional committee votes

GET

https://ada-blockfrost.nownodes.io/governance/committee/votes

Returns a list of all votes cast by constitutional committee members on governance actions. Each entry represents a single vote by a committee member's hot credential on a specific governance proposal.

Response

200OK

HTTP 200 response for getGovernanceCommitteeVotes.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get the constitutional committee votes

curl -X GET 'https://ada-blockfrost.nownodes.io/governance/committee/votes'

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

const data = await response.json();

import requests

response = requests.get('https://ada-blockfrost.nownodes.io/governance/committee/votes')
data = response.json()

[]

{
  "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"
}

Metadata

Metadata operations.

List all transaction metadata labels

GET

https://ada-blockfrost.nownodes.io/metadata/txs/labels

Returns a paginated list of all distinct metadata labels that have been used in transactions on the Cardano blockchain.

Parameters

pageinteger1query

Page number. Defaults to 1.

countinteger<= 100100query

Results per page. Max 100.

orderstringascdescascquery

Sort order.

Response

200OK

HTTP 200 response for getMetadataLabels.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

List all transaction metadata labels

curl -X GET 'https://ada-blockfrost.nownodes.io/metadata/txs/labels'

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

const data = await response.json();

import requests

response = requests.get('https://ada-blockfrost.nownodes.io/metadata/txs/labels')
data = response.json()

[
  {
    "label": "721",
    "cip10": "Cardano NFT metadata",
    "count": "1"
  }
]

{
  "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"
}

Get metadata content by label

GET

https://ada-blockfrost.nownodes.io/metadata/txs/labels/{label}

Returns transaction metadata entries associated with the specified label.

Parameters

labelstringrequiredpath

Numeric metadata label to query.

pageinteger1query

Page number. Defaults to 1.

countinteger<= 100100query

Results per page. Max 100.

orderstringascdescascquery

Sort order.

Response

200OK

HTTP 200 response for getMetadataByLabel.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get metadata content by label

curl -X GET 'https://ada-blockfrost.nownodes.io/metadata/txs/labels/{label}'

const response = await fetch('https://ada-blockfrost.nownodes.io/metadata/txs/labels/{label}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ada-blockfrost.nownodes.io/metadata/txs/labels/{label}')
data = response.json()

[
  {
    "label": "721",
    "cip10": "Cardano NFT metadata",
    "count": "1"
  }
]

{
  "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"
}

Get transaction metadata CBOR by label

GET

https://ada-blockfrost.nownodes.io/metadata/txs/labels/{label}/cbor

Returns a paginated list of transaction metadata entries for the specified numeric label with the metadata content provided in both raw CBOR hex encoding and a secondary hex metadata field. This endpoint is useful when the client needs the exact on-chain byte representation rather than a potentially lossy JSON conversion. Common well-known labels include 721 (CIP-25 NFT metadata), 674 (CIP-20 transaction messages), and 1967 (nut.link oracle feeds). Labels are registered under the CIP-10 standard.

Parameters

labelstringrequiredpath

Numeric metadata label to query. Labels are unsigned integers that serve as top-level keys in the Cardano transaction metadata map (auxiliary data). They partition metadata into logical namespaces so that different applications can coexist within the same transaction without collision.

countinteger<= 100100query

Maximum number of metadata entries to return per page. Defaults to 100; cannot exceed 100.

pageinteger1query

Page number for pagination. The first page is 1.

orderstringascdescascquery

Sort order of the results by transaction inclusion time. "asc" returns oldest transactions first; "desc" returns newest first.

Response

200OK

HTTP 200 response for getMetadataByLabelCbor.

400Bad Request

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

401Unauthorized

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

404Not Found

No metadata found for the given label.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get transaction metadata CBOR by label

curl -X GET 'https://ada-blockfrost.nownodes.io/metadata/txs/labels/{label}/cbor'

const response = await fetch('https://ada-blockfrost.nownodes.io/metadata/txs/labels/{label}/cbor', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ada-blockfrost.nownodes.io/metadata/txs/labels/{label}/cbor')
data = response.json()

[
  {
    "label": "721",
    "cip10": "Cardano NFT metadata",
    "count": "1"
  }
]

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

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

Unknown API_key

{
  "status_code": 404,
  "error": "Not Found",
  "message": "The requested component has not been found."
}

Missing API_key

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

Network

Network operations.

Get network information

GET

https://ada-blockfrost.nownodes.io/network

Returns detailed information about the Cardano network's ADA supply breakdown (maximum, total, circulating, locked, treasury, and reserves) and the current staking statistics (live and active stake).

Response

200OK

HTTP 200 response for getNetwork.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get network information

curl -X GET 'https://ada-blockfrost.nownodes.io/network'

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

const data = await response.json();

import requests

response = requests.get('https://ada-blockfrost.nownodes.io/network')
data = response.json()

{
  "supply": {
    "max": "45000000000000000",
    "total": "38451959434790517",
    "circulating": "33559039338616223",
    "locked": "192931364922692",
    "treasury": "1638585447047618",
    "reserves": "6548040565209483"
  },
  "stake": {
    "live": "33751591743357276",
    "active": "21513392623540974"
  }
}

{
  "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"
}

Get Cardano network eras

GET

https://ada-blockfrost.nownodes.io/network/eras

Returns a list of all Cardano ledger eras (Byron, Shelley, Allegra, Mary, Alonzo, Babbage, Conway) with their start and end boundaries expressed in epoch and slot numbers.

Response

200OK

HTTP 200 response for getNetworkEras.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get Cardano network eras

curl -X GET 'https://ada-blockfrost.nownodes.io/network/eras'

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

const data = await response.json();

import requests

response = requests.get('https://ada-blockfrost.nownodes.io/network/eras')
data = response.json()

[
  {
    "era": "conway",
    "start": {
      "time": 1713059199,
      "slot": 133660800,
      "epoch": 475
    },
    "end": null
  }
]

{
  "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"
}

Pools

Pools operations.

List active stake pools

GET

https://ada-blockfrost.nownodes.io/pools

Returns a paginated list of Bech32-encoded IDs of all currently registered and active stake pools on the Cardano network.

Parameters

pageinteger1query

Page number. Defaults to 1.

countinteger<= 100100query

Results per page. Max 100.

orderstringascdescascquery

Sort order.

Response

200OK

HTTP 200 response for getPools.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

List active stake pools

curl -X GET 'https://ada-blockfrost.nownodes.io/pools'

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

const data = await response.json();

import requests

response = requests.get('https://ada-blockfrost.nownodes.io/pools')
data = response.json()

[
  {
    "pool_id": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
    "hex": "79c4d4fe108f480fee98f307adae12571df2959651f833b195139a25"
  }
]

{
  "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"
}

List retired stake pools

GET

https://ada-blockfrost.nownodes.io/pools/retired

Returns a paginated list of all stake pools that have completed their retirement.

Parameters

pageinteger1query

Page number. Defaults to 1.

countinteger<= 100100query

Results per page. Max 100.

orderstringascdescascquery

Sort order.

Response

200OK

HTTP 200 response for getRetiredPools.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

List retired stake pools

curl -X GET 'https://ada-blockfrost.nownodes.io/pools/retired'

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

const data = await response.json();

import requests

response = requests.get('https://ada-blockfrost.nownodes.io/pools/retired')
data = response.json()

{
  "pool_id": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
  "hex": "79c4d4fe108f480fee98f307adae12571df2959651f833b195139a25",
  "vrf_key": "vrf_vk1vxkyne4ftwjz4vlla756mlfqrmzwx35mkhk7d993njzmceksfp2q3kp8d4",
  "blocks_minted": 100,
  "live_stake": "1000000000000",
  "live_saturation": 0.01,
  "active_stake": "900000000000",
  "declared_pledge": "500000000000",
  "margin_cost": 0.03,
  "fixed_cost": "340000000"
}

{
  "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"
}

List retiring stake pools

GET

https://ada-blockfrost.nownodes.io/pools/retiring

Returns a list of stake pools that are scheduled to retire in a future epoch.

Response

200OK

HTTP 200 response for getRetiringPools.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

List retiring stake pools

curl -X GET 'https://ada-blockfrost.nownodes.io/pools/retiring'

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

const data = await response.json();

import requests

response = requests.get('https://ada-blockfrost.nownodes.io/pools/retiring')
data = response.json()

{
  "pool_id": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
  "hex": "79c4d4fe108f480fee98f307adae12571df2959651f833b195139a25",
  "vrf_key": "vrf_vk1vxkyne4ftwjz4vlla756mlfqrmzwx35mkhk7d993njzmceksfp2q3kp8d4",
  "blocks_minted": 100,
  "live_stake": "1000000000000",
  "live_saturation": 0.01,
  "active_stake": "900000000000",
  "declared_pledge": "500000000000",
  "margin_cost": 0.03,
  "fixed_cost": "340000000"
}

{
  "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"
}

Get stake pool metadata

GET

https://ada-blockfrost.nownodes.io/pools/{pool_id}/metadata

Returns off-chain metadata registered by the specified stake pool, such as name, ticker, description, and homepage URL.

Parameters

pool_idstringrequiredpath

Bech32 or hex-encoded stake pool ID.

Response

200OK

HTTP 200 response for getPoolMetadata.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get stake pool metadata

curl -X GET 'https://ada-blockfrost.nownodes.io/pools/{pool_id}/metadata'

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

const data = await response.json();

import requests

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

{
  "pool_id": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
  "hex": "79c4d4fe108f480fee98f307adae12571df2959651f833b195139a25",
  "vrf_key": "vrf_vk1vxkyne4ftwjz4vlla756mlfqrmzwx35mkhk7d993njzmceksfp2q3kp8d4",
  "blocks_minted": 100,
  "live_stake": "1000000000000",
  "live_saturation": 0.01,
  "active_stake": "900000000000",
  "declared_pledge": "500000000000",
  "margin_cost": 0.03,
  "fixed_cost": "340000000"
}

{
  "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"
}

Get stake pool relays

GET

https://ada-blockfrost.nownodes.io/pools/{pool_id}/relays

Returns the list of network relay endpoints registered by the specified stake pool.

Parameters

pool_idstringrequiredpath

Bech32 or hex-encoded stake pool ID.

Response

200OK

HTTP 200 response for getPoolRelays.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get stake pool relays

curl -X GET 'https://ada-blockfrost.nownodes.io/pools/{pool_id}/relays'

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

const data = await response.json();

import requests

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

{
  "pool_id": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
  "hex": "79c4d4fe108f480fee98f307adae12571df2959651f833b195139a25",
  "vrf_key": "vrf_vk1vxkyne4ftwjz4vlla756mlfqrmzwx35mkhk7d993njzmceksfp2q3kp8d4",
  "blocks_minted": 100,
  "live_stake": "1000000000000",
  "live_saturation": 0.01,
  "active_stake": "900000000000",
  "declared_pledge": "500000000000",
  "margin_cost": 0.03,
  "fixed_cost": "340000000"
}

{
  "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"
}

Get stake pool delegators

GET

https://ada-blockfrost.nownodes.io/pools/{pool_id}/delegators

Returns a paginated list of addresses currently delegating to the specified stake pool.

Parameters

pool_idstringrequiredpath

Bech32 or hex-encoded stake pool ID.

pageinteger1query

Page number. Defaults to 1.

countinteger<= 100100query

Results per page. Max 100.

orderstringascdescascquery

Sort order.

Response

200OK

HTTP 200 response for getPoolDelegators.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get stake pool delegators

curl -X GET 'https://ada-blockfrost.nownodes.io/pools/{pool_id}/delegators'

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

const data = await response.json();

import requests

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

{
  "pool_id": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
  "hex": "79c4d4fe108f480fee98f307adae12571df2959651f833b195139a25",
  "vrf_key": "vrf_vk1vxkyne4ftwjz4vlla756mlfqrmzwx35mkhk7d993njzmceksfp2q3kp8d4",
  "blocks_minted": 100,
  "live_stake": "1000000000000",
  "live_saturation": 0.01,
  "active_stake": "900000000000",
  "declared_pledge": "500000000000",
  "margin_cost": 0.03,
  "fixed_cost": "340000000"
}

{
  "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"
}

Get stake pool blocks

GET

https://ada-blockfrost.nownodes.io/pools/{pool_id}/blocks

Returns a paginated list of block hashes minted by the specified stake pool.

Parameters

pool_idstringrequiredpath

Bech32 or hex-encoded stake pool ID.

pageinteger1query

Page number. Defaults to 1.

countinteger<= 100100query

Results per page. Max 100.

orderstringascdescascquery

Sort order.

Response

200OK

HTTP 200 response for getPoolBlocks.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get stake pool blocks

curl -X GET 'https://ada-blockfrost.nownodes.io/pools/{pool_id}/blocks'

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

const data = await response.json();

import requests

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

{
  "pool_id": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
  "hex": "79c4d4fe108f480fee98f307adae12571df2959651f833b195139a25",
  "vrf_key": "vrf_vk1vxkyne4ftwjz4vlla756mlfqrmzwx35mkhk7d993njzmceksfp2q3kp8d4",
  "blocks_minted": 100,
  "live_stake": "1000000000000",
  "live_saturation": 0.01,
  "active_stake": "900000000000",
  "declared_pledge": "500000000000",
  "margin_cost": 0.03,
  "fixed_cost": "340000000"
}

{
  "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"
}

Get stake pool update history

GET

https://ada-blockfrost.nownodes.io/pools/{pool_id}/updates

Returns the full history of registration and update certificates submitted for the specified stake pool.

Parameters

pool_idstringrequiredpath

Bech32 or hex-encoded stake pool ID.

Response

200OK

HTTP 200 response for getPoolUpdates.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get stake pool update history

curl -X GET 'https://ada-blockfrost.nownodes.io/pools/{pool_id}/updates'

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

const data = await response.json();

import requests

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

{
  "pool_id": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
  "hex": "79c4d4fe108f480fee98f307adae12571df2959651f833b195139a25",
  "vrf_key": "vrf_vk1vxkyne4ftwjz4vlla756mlfqrmzwx35mkhk7d993njzmceksfp2q3kp8d4",
  "blocks_minted": 100,
  "live_stake": "1000000000000",
  "live_saturation": 0.01,
  "active_stake": "900000000000",
  "declared_pledge": "500000000000",
  "margin_cost": 0.03,
  "fixed_cost": "340000000"
}

{
  "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"
}

List stake pools with extended information

GET

https://ada-blockfrost.nownodes.io/pools/extended

Returns a paginated list of all registered stake pools enriched with live and active stake amounts, saturation level, block minting count, pledge, cost parameters, and off-chain metadata.

Parameters

pageinteger1query

Page number for pagination. Defaults to 1.

countinteger<= 100100query

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

orderstringascdescascquery

Sort order of the results.

Response

200OK

HTTP 200 response for getPoolsExtended.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

List stake pools with extended information

curl -X GET 'https://ada-blockfrost.nownodes.io/pools/extended'

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

const data = await response.json();

import requests

response = requests.get('https://ada-blockfrost.nownodes.io/pools/extended')
data = response.json()

{
  "pool_id": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
  "hex": "79c4d4fe108f480fee98f307adae12571df2959651f833b195139a25",
  "vrf_key": "vrf_vk1vxkyne4ftwjz4vlla756mlfqrmzwx35mkhk7d993njzmceksfp2q3kp8d4",
  "blocks_minted": 100,
  "live_stake": "1000000000000",
  "live_saturation": 0.01,
  "active_stake": "900000000000",
  "declared_pledge": "500000000000",
  "margin_cost": 0.03,
  "fixed_cost": "340000000"
}

{
  "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"
}

Get stake pool details

GET

https://ada-blockfrost.nownodes.io/pools/{pool_id}

Returns comprehensive on-chain details for a specific stake pool including live and active stake, saturation, delegator count, pledge information, cost parameters, VRF key, reward account, owner addresses, and full registration and retirement transaction history.

Parameters

pool_idstringrequiredpath

Bech32-encoded or hex-encoded stake pool identifier.

Response

200OK

HTTP 200 response for getPool.

400Bad Request

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

401Unauthorized

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

404Not Found

Pool not found.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get stake pool details

curl -X GET 'https://ada-blockfrost.nownodes.io/pools/{pool_id}'

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

const data = await response.json();

import requests

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

{
  "pool_id": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
  "hex": "79c4d4fe108f480fee98f307adae12571df2959651f833b195139a25",
  "vrf_key": "vrf_vk1vxkyne4ftwjz4vlla756mlfqrmzwx35mkhk7d993njzmceksfp2q3kp8d4",
  "blocks_minted": 100,
  "live_stake": "1000000000000",
  "live_saturation": 0.01,
  "active_stake": "900000000000",
  "declared_pledge": "500000000000",
  "margin_cost": 0.03,
  "fixed_cost": "340000000"
}

{
  "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"
}

Get stake pool epoch history

GET

https://ada-blockfrost.nownodes.io/pools/{pool_id}/history

Returns a chronological list of per-epoch performance data for the specified stake pool, including blocks minted, active stake, relative size, delegator count, earned rewards, and collected fees.

Parameters

pool_idstringrequiredpath

Bech32 or hex-encoded stake pool identifier.

Response

200OK

HTTP 200 response for getPoolHistory.

400Bad Request

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

401Unauthorized

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

404Not Found

Pool not found.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get stake pool epoch history

curl -X GET 'https://ada-blockfrost.nownodes.io/pools/{pool_id}/history'

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

const data = await response.json();

import requests

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

{
  "pool_id": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
  "hex": "79c4d4fe108f480fee98f307adae12571df2959651f833b195139a25",
  "vrf_key": "vrf_vk1vxkyne4ftwjz4vlla756mlfqrmzwx35mkhk7d993njzmceksfp2q3kp8d4",
  "blocks_minted": 100,
  "live_stake": "1000000000000",
  "live_saturation": 0.01,
  "active_stake": "900000000000",
  "declared_pledge": "500000000000",
  "margin_cost": 0.03,
  "fixed_cost": "340000000"
}

{
  "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"
}

Scripts

Scripts operations.

List all scripts

GET

https://ada-blockfrost.nownodes.io/scripts

Returns a paginated list of all script hashes deployed on the Cardano blockchain.

Parameters

pageinteger1query

Page number. Defaults to 1.

countinteger<= 100100query

Results per page. Max 100.

orderstringascdescascquery

Sort order.

Response

200OK

HTTP 200 response for listScripts.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

List all scripts

curl -X GET 'https://ada-blockfrost.nownodes.io/scripts'

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

const data = await response.json();

import requests

response = requests.get('https://ada-blockfrost.nownodes.io/scripts')
data = response.json()

[
  {
    "script_hash": "f9b162ea9529e639a083595294006a833473883a75d6df1e4c22dd4f504f4c4c5f4d414e41474552",
    "type": "plutusV2",
    "serialised_size": 1234
  }
]

{
  "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"
}

Get script information

GET

https://ada-blockfrost.nownodes.io/scripts/{script}

Returns detailed information about a specific script including its type and serialised size.

Parameters

scriptstringrequiredpath

Script hash identifier.

Response

200OK

HTTP 200 response for getScript.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get script information

curl -X GET 'https://ada-blockfrost.nownodes.io/scripts/{script}'

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

const data = await response.json();

import requests

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

{
  "script_hash": "f9b162ea9529e639a083595294006a833473883a75d6df1e4c22dd4f504f4c4c5f4d414e41474552",
  "type": "plutusV2",
  "serialised_size": 1234
}

{
  "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"
}

Get script JSON representation

GET

https://ada-blockfrost.nownodes.io/scripts/{script}/json

Returns the JSON representation of a native (timelock) script. For Plutus scripts the response may contain a wrapper indicating the Plutus version.

Parameters

scriptstringrequiredpath

Script hash identifier.

Response

200OK

HTTP 200 response for getScriptJson.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get script JSON representation

curl -X GET 'https://ada-blockfrost.nownodes.io/scripts/{script}/json'

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

const data = await response.json();

import requests

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

{
  "script_hash": "f9b162ea9529e639a083595294006a833473883a75d6df1e4c22dd4f504f4c4c5f4d414e41474552",
  "type": "plutusV2",
  "serialised_size": 1234
}

{
  "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"
}

Get script CBOR representation

GET

https://ada-blockfrost.nownodes.io/scripts/{script}/cbor

Returns the hex-encoded CBOR serialisation of the script.

Parameters

scriptstringrequiredpath

Script hash identifier.

Response

200OK

HTTP 200 response for getScriptCbor.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get script CBOR representation

curl -X GET 'https://ada-blockfrost.nownodes.io/scripts/{script}/cbor'

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

const data = await response.json();

import requests

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

{
  "script_hash": "f9b162ea9529e639a083595294006a833473883a75d6df1e4c22dd4f504f4c4c5f4d414e41474552",
  "type": "plutusV2",
  "serialised_size": 1234
}

{
  "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"
}

Get redeemers for script

GET

https://ada-blockfrost.nownodes.io/scripts/{script}/redeemers

Returns a paginated list of all redeemers that have been used with the specified script across all transactions.

Parameters

scriptstringrequiredpath

Script hash identifier.

pageinteger1query

Page number.

countinteger<= 100100query

Results per page. Max 100.

orderstringascdescascquery

Sort order.

Response

200OK

HTTP 200 response for getScriptRedeemers.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get redeemers for script

curl -X GET 'https://ada-blockfrost.nownodes.io/scripts/{script}/redeemers'

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

const data = await response.json();

import requests

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

{
  "script_hash": "f9b162ea9529e639a083595294006a833473883a75d6df1e4c22dd4f504f4c4c5f4d414e41474552",
  "type": "plutusV2",
  "serialised_size": 1234
}

{
  "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"
}

Get CBOR datum for script

GET

https://ada-blockfrost.nownodes.io/scripts/datum/{script}/cbor

Returns the hex-encoded CBOR representation of the datum associated with the given datum hash.

Parameters

scriptstringrequiredpath

Datum hash identifier.

Response

200OK

HTTP 200 response for getScriptDatumCbor.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get CBOR datum for script

curl -X GET 'https://ada-blockfrost.nownodes.io/scripts/datum/{script}/cbor'

const response = await fetch('https://ada-blockfrost.nownodes.io/scripts/datum/{script}/cbor', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ada-blockfrost.nownodes.io/scripts/datum/{script}/cbor')
data = response.json()

{
  "script_hash": "f9b162ea9529e639a083595294006a833473883a75d6df1e4c22dd4f504f4c4c5f4d414e41474552",
  "type": "plutusV2",
  "serialised_size": 1234
}

{
  "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"
}

Get datum value by hash

GET

https://ada-blockfrost.nownodes.io/scripts/datum/{datum_hash}

Returns the full JSON representation of a Plutus datum identified by its Blake2b-256 hash. Datums are structured data values attached to transaction outputs and consumed by Plutus validator scripts. The datum hash is recorded on-chain inside the UTXO, while the actual datum content is supplied via the transaction witness set or embedded as an inline datum (CIP-32). The returned JSON follows the canonical Plutus JSON schema where data is expressed through constructors, fields, integers, byte strings, lists, and maps.

Parameters

datum_hashstringrequiredpath

Blake2b-256 hash of the datum to retrieve, encoded as a 64-character lowercase hexadecimal string. This hash is computed over the CBOR-serialised datum and is stored on-chain in the UTXO that references it.

Response

200OK

HTTP 200 response for getScriptDatum.

400Bad Request

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

401Unauthorized

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

404Not Found

No datum found for the given hash.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get datum value by hash

curl -X GET 'https://ada-blockfrost.nownodes.io/scripts/datum/{datum_hash}'

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

const data = await response.json();

import requests

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

{
  "script_hash": "f9b162ea9529e639a083595294006a833473883a75d6df1e4c22dd4f504f4c4c5f4d414e41474552",
  "type": "plutusV2",
  "serialised_size": 1234
}

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

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

Unknown API_key

{
  "status_code": 404,
  "error": "Not Found",
  "message": "The requested component has not been found."
}

Missing API_key

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

Transactions

Transactions operations.

Get transaction info

GET

https://ada-blockfrost.nownodes.io/txs/{hash}

Returns full details of a transaction identified by its hash.

Parameters

hashstringrequiredpath

The unique transaction hash identifier (64 hexadecimal characters)

Response

200OK

HTTP 200 response for getTransaction.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get transaction info

curl -X GET 'https://ada-blockfrost.nownodes.io/txs/{hash}'

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

const data = await response.json();

import requests

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

{
  "hash": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
  "block": "9945cd69ca8e6bcf2e5f9a14742be0c051bf9dd916f0bb0b00ab39977b140d53",
  "block_height": 13646894,
  "block_time": 1783421965,
  "slot": 191855674,
  "index": 0,
  "output_amount": [
    {
      "unit": "lovelace",
      "quantity": "94923541"
    },
    {
      "unit": "533bb94a8850ee3ccbe483106489399112b74c905342cb1792a797a0494e4459",
      "quantity": "221350388"
    }
  ],
  "fees": "413224",
  "deposit": "0",
  "size": 1010,
  "invalid_before": "191855602",
  "invalid_hereafter": "191856801",
  "utxo_count": 6,
  "withdrawal_count": 0,
  "redeemer_count": 2,
  "valid_contract": true,
  "treasury_donation": "0"
}

{
  "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"
}

Get transaction stakes

GET

https://ada-blockfrost.nownodes.io/txs/{tx}/stakes

Returns all stake key registration and deregistration certificates included in the transaction.

Parameters

txstringrequiredpath

Transaction hash (hex).

Response

200OK

HTTP 200 response for getTransactionStakes.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get transaction stakes

curl -X GET 'https://ada-blockfrost.nownodes.io/txs/{tx}/stakes'

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

const data = await response.json();

import requests

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

{
  "hash": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
  "block": "9945cd69ca8e6bcf2e5f9a14742be0c051bf9dd916f0bb0b00ab39977b140d53",
  "block_height": 13646894,
  "block_time": 1783421965,
  "slot": 191855674,
  "index": 0,
  "output_amount": [
    {
      "unit": "lovelace",
      "quantity": "94923541"
    },
    {
      "unit": "533bb94a8850ee3ccbe483106489399112b74c905342cb1792a797a0494e4459",
      "quantity": "221350388"
    }
  ],
  "fees": "413224",
  "deposit": "0",
  "size": 1010,
  "invalid_before": "191855602",
  "invalid_hereafter": "191856801",
  "utxo_count": 6,
  "withdrawal_count": 0,
  "redeemer_count": 2,
  "valid_contract": true,
  "treasury_donation": "0"
}

{
  "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"
}

Get transaction delegations

GET

https://ada-blockfrost.nownodes.io/txs/{tx}/delegations

Returns delegation certificates included in the transaction.

Parameters

txstringrequiredpath

Transaction hash (hex).

Response

200OK

HTTP 200 response for getTransactionDelegations.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get transaction delegations

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

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

const data = await response.json();

import requests

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

{
  "hash": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
  "block": "9945cd69ca8e6bcf2e5f9a14742be0c051bf9dd916f0bb0b00ab39977b140d53",
  "block_height": 13646894,
  "block_time": 1783421965,
  "slot": 191855674,
  "index": 0,
  "output_amount": [
    {
      "unit": "lovelace",
      "quantity": "94923541"
    },
    {
      "unit": "533bb94a8850ee3ccbe483106489399112b74c905342cb1792a797a0494e4459",
      "quantity": "221350388"
    }
  ],
  "fees": "413224",
  "deposit": "0",
  "size": 1010,
  "invalid_before": "191855602",
  "invalid_hereafter": "191856801",
  "utxo_count": 6,
  "withdrawal_count": 0,
  "redeemer_count": 2,
  "valid_contract": true,
  "treasury_donation": "0"
}

{
  "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"
}

Get transaction withdrawals

GET

https://ada-blockfrost.nownodes.io/txs/{tx}/withdrawals

Returns all reward account withdrawals included in the transaction.

Parameters

txstringrequiredpath

Transaction hash (hex).

Response

200OK

HTTP 200 response for getTransactionWithdrawals.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get transaction withdrawals

curl -X GET 'https://ada-blockfrost.nownodes.io/txs/{tx}/withdrawals'

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

const data = await response.json();

import requests

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

{
  "hash": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
  "block": "9945cd69ca8e6bcf2e5f9a14742be0c051bf9dd916f0bb0b00ab39977b140d53",
  "block_height": 13646894,
  "block_time": 1783421965,
  "slot": 191855674,
  "index": 0,
  "output_amount": [
    {
      "unit": "lovelace",
      "quantity": "94923541"
    },
    {
      "unit": "533bb94a8850ee3ccbe483106489399112b74c905342cb1792a797a0494e4459",
      "quantity": "221350388"
    }
  ],
  "fees": "413224",
  "deposit": "0",
  "size": 1010,
  "invalid_before": "191855602",
  "invalid_hereafter": "191856801",
  "utxo_count": 6,
  "withdrawal_count": 0,
  "redeemer_count": 2,
  "valid_contract": true,
  "treasury_donation": "0"
}

{
  "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"
}

Get MIRs in transaction

GET

https://ada-blockfrost.nownodes.io/txs/{tx}/mirs

Returns all Move Instantaneous Reward (MIR) certificates included in the transaction.

Parameters

txstringrequiredpath

Transaction hash (hex).

Response

200OK

HTTP 200 response for getTransactionMirs.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get MIRs in transaction

curl -X GET 'https://ada-blockfrost.nownodes.io/txs/{tx}/mirs'

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

const data = await response.json();

import requests

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

{
  "hash": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
  "block": "9945cd69ca8e6bcf2e5f9a14742be0c051bf9dd916f0bb0b00ab39977b140d53",
  "block_height": 13646894,
  "block_time": 1783421965,
  "slot": 191855674,
  "index": 0,
  "output_amount": [
    {
      "unit": "lovelace",
      "quantity": "94923541"
    },
    {
      "unit": "533bb94a8850ee3ccbe483106489399112b74c905342cb1792a797a0494e4459",
      "quantity": "221350388"
    }
  ],
  "fees": "413224",
  "deposit": "0",
  "size": 1010,
  "invalid_before": "191855602",
  "invalid_hereafter": "191856801",
  "utxo_count": 6,
  "withdrawal_count": 0,
  "redeemer_count": 2,
  "valid_contract": true,
  "treasury_donation": "0"
}

{
  "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"
}

Get pool updates in transaction

GET

https://ada-blockfrost.nownodes.io/txs/{tx}/pool_updates

Returns pool registration or parameter-update certificates included in the transaction.

Parameters

txstringrequiredpath

Transaction hash (hex).

Response

200OK

HTTP 200 response for getTransactionPoolUpdates.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get pool updates in transaction

curl -X GET 'https://ada-blockfrost.nownodes.io/txs/{tx}/pool_updates'

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

const data = await response.json();

import requests

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

{
  "hash": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
  "block": "9945cd69ca8e6bcf2e5f9a14742be0c051bf9dd916f0bb0b00ab39977b140d53",
  "block_height": 13646894,
  "block_time": 1783421965,
  "slot": 191855674,
  "index": 0,
  "output_amount": [
    {
      "unit": "lovelace",
      "quantity": "94923541"
    },
    {
      "unit": "533bb94a8850ee3ccbe483106489399112b74c905342cb1792a797a0494e4459",
      "quantity": "221350388"
    }
  ],
  "fees": "413224",
  "deposit": "0",
  "size": 1010,
  "invalid_before": "191855602",
  "invalid_hereafter": "191856801",
  "utxo_count": 6,
  "withdrawal_count": 0,
  "redeemer_count": 2,
  "valid_contract": true,
  "treasury_donation": "0"
}

{
  "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"
}

Get pool retirements in transaction

GET

https://ada-blockfrost.nownodes.io/txs/{tx}/pool_retires

Returns pool retirement certificates included in the transaction.

Parameters

txstringrequiredpath

Transaction hash (hex).

Response

200OK

HTTP 200 response for getTransactionPoolRetires.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get pool retirements in transaction

curl -X GET 'https://ada-blockfrost.nownodes.io/txs/{tx}/pool_retires'

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

const data = await response.json();

import requests

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

{
  "hash": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
  "block": "9945cd69ca8e6bcf2e5f9a14742be0c051bf9dd916f0bb0b00ab39977b140d53",
  "block_height": 13646894,
  "block_time": 1783421965,
  "slot": 191855674,
  "index": 0,
  "output_amount": [
    {
      "unit": "lovelace",
      "quantity": "94923541"
    },
    {
      "unit": "533bb94a8850ee3ccbe483106489399112b74c905342cb1792a797a0494e4459",
      "quantity": "221350388"
    }
  ],
  "fees": "413224",
  "deposit": "0",
  "size": 1010,
  "invalid_before": "191855602",
  "invalid_hereafter": "191856801",
  "utxo_count": 6,
  "withdrawal_count": 0,
  "redeemer_count": 2,
  "valid_contract": true,
  "treasury_donation": "0"
}

{
  "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"
}

Get transaction metadata

GET

https://ada-blockfrost.nownodes.io/txs/{tx}/metadata

Returns JSON metadata attached to the transaction, grouped by label.

Parameters

txstringrequiredpath

Transaction hash (hex).

Response

200OK

HTTP 200 response for getTransactionMetadata.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get transaction metadata

curl -X GET 'https://ada-blockfrost.nownodes.io/txs/{tx}/metadata'

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

const data = await response.json();

import requests

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

{
  "hash": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
  "block": "9945cd69ca8e6bcf2e5f9a14742be0c051bf9dd916f0bb0b00ab39977b140d53",
  "block_height": 13646894,
  "block_time": 1783421965,
  "slot": 191855674,
  "index": 0,
  "output_amount": [
    {
      "unit": "lovelace",
      "quantity": "94923541"
    },
    {
      "unit": "533bb94a8850ee3ccbe483106489399112b74c905342cb1792a797a0494e4459",
      "quantity": "221350388"
    }
  ],
  "fees": "413224",
  "deposit": "0",
  "size": 1010,
  "invalid_before": "191855602",
  "invalid_hereafter": "191856801",
  "utxo_count": 6,
  "withdrawal_count": 0,
  "redeemer_count": 2,
  "valid_contract": true,
  "treasury_donation": "0"
}

{
  "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"
}

Get transaction metadata in CBOR

GET

https://ada-blockfrost.nownodes.io/txs/{tx}/metadata/cbor

Returns the hex-encoded CBOR serialisation of the metadata attached to the transaction.

Parameters

txstringrequiredpath

Transaction hash (hex).

Response

200OK

HTTP 200 response for getTransactionMetadataCbor.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get transaction metadata in CBOR

curl -X GET 'https://ada-blockfrost.nownodes.io/txs/{tx}/metadata/cbor'

const response = await fetch('https://ada-blockfrost.nownodes.io/txs/{tx}/metadata/cbor', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ada-blockfrost.nownodes.io/txs/{tx}/metadata/cbor')
data = response.json()

{
  "hash": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
  "block": "9945cd69ca8e6bcf2e5f9a14742be0c051bf9dd916f0bb0b00ab39977b140d53",
  "block_height": 13646894,
  "block_time": 1783421965,
  "slot": 191855674,
  "index": 0,
  "output_amount": [
    {
      "unit": "lovelace",
      "quantity": "94923541"
    },
    {
      "unit": "533bb94a8850ee3ccbe483106489399112b74c905342cb1792a797a0494e4459",
      "quantity": "221350388"
    }
  ],
  "fees": "413224",
  "deposit": "0",
  "size": 1010,
  "invalid_before": "191855602",
  "invalid_hereafter": "191856801",
  "utxo_count": 6,
  "withdrawal_count": 0,
  "redeemer_count": 2,
  "valid_contract": true,
  "treasury_donation": "0"
}

{
  "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"
}

Get redeemers for transaction

GET

https://ada-blockfrost.nownodes.io/txs/{tx}/redeemers

Returns all Plutus script redeemers included in the specified transaction.

Parameters

txstringrequiredpath

Transaction hash (hex).

Response

200OK

HTTP 200 response for getTransactionRedeemers.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get redeemers for transaction

curl -X GET 'https://ada-blockfrost.nownodes.io/txs/{tx}/redeemers'

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

const data = await response.json();

import requests

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

{
  "hash": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
  "block": "9945cd69ca8e6bcf2e5f9a14742be0c051bf9dd916f0bb0b00ab39977b140d53",
  "block_height": 13646894,
  "block_time": 1783421965,
  "slot": 191855674,
  "index": 0,
  "output_amount": [
    {
      "unit": "lovelace",
      "quantity": "94923541"
    },
    {
      "unit": "533bb94a8850ee3ccbe483106489399112b74c905342cb1792a797a0494e4459",
      "quantity": "221350388"
    }
  ],
  "fees": "413224",
  "deposit": "0",
  "size": 1010,
  "invalid_before": "191855602",
  "invalid_hereafter": "191856801",
  "utxo_count": 6,
  "withdrawal_count": 0,
  "redeemer_count": 2,
  "valid_contract": true,
  "treasury_donation": "0"
}

{
  "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"
}

Get transaction UTXOs

GET

https://ada-blockfrost.nownodes.io/txs/{tx}/utxos

Returns the full input and output UTXO breakdown of a specific transaction. Each input shows the source address, value, and originating transaction reference; each output shows the destination address, value, datum information, and whether the output has been consumed by a subsequent transaction.

Parameters

txstringrequiredpath

Blake2b-256 hex-encoded hash of the transaction to query.

Response

200OK

HTTP 200 response for getTransactionUtxos.

400Bad Request

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

401Unauthorized

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

404Not Found

Transaction not found.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get transaction UTXOs

curl -X GET 'https://ada-blockfrost.nownodes.io/txs/{tx}/utxos'

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

const data = await response.json();

import requests

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

{
  "hash": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
  "block": "9945cd69ca8e6bcf2e5f9a14742be0c051bf9dd916f0bb0b00ab39977b140d53",
  "block_height": 13646894,
  "block_time": 1783421965,
  "slot": 191855674,
  "index": 0,
  "output_amount": [
    {
      "unit": "lovelace",
      "quantity": "94923541"
    },
    {
      "unit": "533bb94a8850ee3ccbe483106489399112b74c905342cb1792a797a0494e4459",
      "quantity": "221350388"
    }
  ],
  "fees": "413224",
  "deposit": "0",
  "size": 1010,
  "invalid_before": "191855602",
  "invalid_hereafter": "191856801",
  "utxo_count": 6,
  "withdrawal_count": 0,
  "redeemer_count": 2,
  "valid_contract": true,
  "treasury_donation": "0"
}

{
  "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"
}

Utils

Utils operations.

Generate address from xpub

GET

https://ada-blockfrost.nownodes.io/utils/addresses/xpub/{address}/{role}/{index}

Derives a Cardano Shelley payment address from an extended public key (xpub) using the specified role (external or internal/change) and address derivation index.

Parameters

addressstringrequiredpath

Extended public key (xpub) encoded in hex or base58. This is the account-level public key from which child addresses are derived.

roleinteger01requiredpath

BIP-44 role index. 0 = external (receiving) address, 1 = internal (change) address.

indexinteger>= 0requiredpath

Zero-based derivation index of the address to generate.

Response

200OK

HTTP 200 response for generateAddressFromXpub.

400Bad Request

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

401Unauthorized

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

404Not Found

Extended public key not found or invalid.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Generate address from xpub

curl -X GET 'https://ada-blockfrost.nownodes.io/utils/addresses/xpub/{address}/{role}/{index}'

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

const data = await response.json();

import requests

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

[]

{
  "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"
}

Rosetta

Network

Network operations.

Get List of Available Networks

POST

https://ada-blockfrost.nownodes.io/network/list

This endpoint returns a list of NetworkIdentifiers that the Rosetta server supports.

Body

application/json

Request value.

metadataobject

Additional metadata object.

Response

200OK

HTTP 200 response for networkList.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get List of Available Networks

curl -X POST 'https://ada-blockfrost.nownodes.io/network/list' \
  -H 'Content-Type: application/json' \
  -d '{
    "metadata": {}
  }'

const response = await fetch('https://ada-blockfrost.nownodes.io/network/list', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "metadata": {}
    }),
});

const data = await response.json();

import requests

payload = {
  "metadata": {}
}

response = requests.post('https://ada-blockfrost.nownodes.io/network/list', json=payload)
data = response.json()

Request Body

{
  "metadata": {}
}

{
  "network_identifiers": [
    {
      "blockchain": "cardano",
      "network": "mainnet"
    }
  ]
}

{
  "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"
}

Get Network Status

POST

https://ada-blockfrost.nownodes.io/network/status

This endpoint returns the current status of the network requested. Any NetworkIdentifier returned by /network/list should be accessible here.

Body

application/json

Request value.

network_identifierNetworkIdentifierrequired

Rosetta network identifier object.

Show child attributes

blockchainstringrequired

Blockchain value.

networkstringrequired

If a blockchain has a specific chain-id or network identifier, it should go in this field. It is up to the client to determine which network-specific identifier is mainnet, preprod, or preview.

sub_network_identifierSubNetworkIdentifier

Sub Network Identifier value.

Show child attributes

networkstringrequired

Network value.

metadataobject

Additional metadata object.

metadataobject

Additional metadata object.

Response

200OK

HTTP 200 response for networkStatus.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get Network Status

curl -X POST 'https://ada-blockfrost.nownodes.io/network/status' \
  -H 'Content-Type: application/json' \
  -d '{
    "network_identifier": {
      "blockchain": "cardano",
      "network": "mainnet",
      "sub_network_identifier": {
        "network": "shard 1",
        "metadata": {
          "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
        }
      }
    },
    "metadata": {}
  }'

const response = await fetch('https://ada-blockfrost.nownodes.io/network/status', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "network_identifier": {
        "blockchain": "cardano",
        "network": "mainnet",
        "sub_network_identifier": {
          "network": "shard 1",
          "metadata": {
            "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
          }
        }
      },
      "metadata": {}
    }),
});

const data = await response.json();

import requests

payload = {
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "metadata": {}
}

response = requests.post('https://ada-blockfrost.nownodes.io/network/status', json=payload)
data = response.json()

Request Body

{
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "metadata": {}
}

{
  "current_block_identifier": {
    "index": 13646894,
    "hash": "9945cd69ca8e6bcf2e5f9a14742be0c051bf9dd916f0bb0b00ab39977b140d53"
  },
  "current_block_timestamp": 1783421965000,
  "genesis_block_identifier": {
    "index": 0,
    "hash": "89d9b5a5b8ddc8d7e5a6795e9774d97faf1efea59b2caf7eaf9f8c5b32059df4"
  },
  "sync_status": {
    "current_index": 191855674,
    "target_index": 191855679,
    "stage": "LIVE",
    "synced": true
  },
  "peers": [
    {
      "peer_id": "relay.gmbl.mainnet.cardano.gimbalabs.io:30042",
      "metadata": {
        "type": "domain"
      }
    },
    {
      "peer_id": "157.245.228.134:3001",
      "metadata": {
        "type": "IPv4"
      }
    }
  ]
}

{
  "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"
}

Get Network Options

POST

https://ada-blockfrost.nownodes.io/network/options

This endpoint returns the version information and allowed network-specific types for a NetworkIdentifier. Any NetworkIdentifier returned by /network/list should be accessible here. Because options are retrievable in the context of a NetworkIdentifier, it is possible to define unique options for each network.

Body

application/json

Request value.

network_identifierobjectrequired

Rosetta network identifier.

Show child attributes

blockchainstringrequired

Blockchain name, always "cardano".

networkstringrequired

Network name matching the node configuration (mainnet, preprod, preview).

Response

200OK

HTTP 200 response for networkOptions.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get Network Options

curl -X POST 'https://ada-blockfrost.nownodes.io/network/options' \
  -H 'Content-Type: application/json' \
  -d '{
    "network_identifier": {
      "blockchain": "cardano",
      "network": "mainnet"
    }
  }'

const response = await fetch('https://ada-blockfrost.nownodes.io/network/options', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "network_identifier": {
        "blockchain": "cardano",
        "network": "mainnet"
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet"
  }
}

response = requests.post('https://ada-blockfrost.nownodes.io/network/options', json=payload)
data = response.json()

Request Body

{
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet"
  }
}

{
  "version": {
    "rosetta_version": "1.4.13",
    "node_version": "10.5.4",
    "middleware_version": "2.1.2"
  },
  "allow": {
    "operation_statuses": [
      {
        "status": "success",
        "successful": true
      },
      {
        "status": "invalid",
        "successful": false
      }
    ],
    "operation_types": [
      "input",
      "output",
      "stakeKeyRegistration"
    ],
    "errors": [
      {
        "code": 4000,
        "message": "Invalid Network configuration",
        "retriable": 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"
}

Block

Block operations.

Get a Block

POST

https://ada-blockfrost.nownodes.io/block

Get a block by its Block Identifier. If transactions are returned in the same call to the node as fetching the block, the response should include these transactions in the Block object. If not, an array of Transaction Identifiers should be returned so /block/transaction fetches can be done to get all transaction information. When requesting a block by the hash component of the BlockIdentifier, this request MUST be idempotent: repeated invocations for the same hash-identified block must return the exact same block contents. No such restriction is imposed when requesting a block by height, given that a chain reorg event might cause the specific block at height n to be set to a different one.

Body

application/json

Request value.

network_identifierNetworkIdentifierrequired

Rosetta network identifier object.

Show child attributes

blockchainstringrequired

Blockchain value.

networkstringrequired

If a blockchain has a specific chain-id or network identifier, it should go in this field. It is up to the client to determine which network-specific identifier is mainnet, preprod, or preview.

sub_network_identifierSubNetworkIdentifier

Sub Network Identifier value.

Show child attributes

networkstringrequired

Network value.

metadataobject

Additional metadata object.

block_identifierPartialBlockIdentifierrequired

Rosetta block identifier object.

Show child attributes

indexinteger<int64>

Cardano block height or Rosetta index.

hashstring

Cardano transaction hash.

Response

200OK

HTTP 200 response for block.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get a Block

curl -X POST 'https://ada-blockfrost.nownodes.io/block' \
  -H 'Content-Type: application/json' \
  -d '{
    "network_identifier": {
      "blockchain": "cardano",
      "network": "mainnet",
      "sub_network_identifier": {
        "network": "shard 1",
        "metadata": {
          "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
        }
      }
    },
    "block_identifier": {
      "index": 1123941,
      "hash": "0x1f2cc6c5027d2f201a5453ad1119574d2aed23a392654742ac3c78783c071f85"
    }
  }'

const response = await fetch('https://ada-blockfrost.nownodes.io/block', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "network_identifier": {
        "blockchain": "cardano",
        "network": "mainnet",
        "sub_network_identifier": {
          "network": "shard 1",
          "metadata": {
            "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
          }
        }
      },
      "block_identifier": {
        "index": 1123941,
        "hash": "0x1f2cc6c5027d2f201a5453ad1119574d2aed23a392654742ac3c78783c071f85"
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "block_identifier": {
    "index": 1123941,
    "hash": "0x1f2cc6c5027d2f201a5453ad1119574d2aed23a392654742ac3c78783c071f85"
  }
}

response = requests.post('https://ada-blockfrost.nownodes.io/block', json=payload)
data = response.json()

Request Body

{
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "block_identifier": {
    "index": 1123941,
    "hash": "0x1f2cc6c5027d2f201a5453ad1119574d2aed23a392654742ac3c78783c071f85"
  }
}

{
  "block": {
    "block_identifier": {
      "index": 13646894,
      "hash": "9945cd69ca8e6bcf2e5f9a14742be0c051bf9dd916f0bb0b00ab39977b140d53"
    },
    "parent_block_identifier": {
      "index": 13646893,
      "hash": "2895f4973b87ef8632957a3b0c849fd46089dd776c21d799b996c210045b4105"
    },
    "timestamp": 1783421965000,
    "transactions": [
      {
        "transaction_identifier": {
          "hash": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650"
        },
        "operations": [
          {
            "operation_identifier": {
              "index": 0
            },
            "type": "input",
            "status": "success"
          }
        ]
      }
    ]
  }
}

{
  "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"
}

Get a Block Transaction

POST

https://ada-blockfrost.nownodes.io/block/transaction

Get a transaction in a block by its Transaction Identifier. This endpoint should only be used when querying a node for a block does not return all transactions contained within it. All transactions returned by this endpoint must be appended to any transactions returned by the /block method by consumers of this data. Fetching a transaction by hash is considered an Explorer Method (which is classified under the Future Work section). This method can be used to let consumers to paginate results when the block trasactions count is too big to be returned in a single BlockResponse. Calling this endpoint requires reference to a BlockIdentifier because transaction parsing can change depending on which block contains the transaction. For example, in Bitcoin it is necessary to know which block contains a transaction to determine the destination of fee payments. Without specifying a block identifier, the node would have to infer which block to use (which could change during a re-org). Implementations that require fetching previous transactions to populate the response (ex: Previous UTXOs in Bitcoin) may find it useful to run a cache within the Rosetta server in the /data directory (on a path that does not conflict with the node).

Body

application/json

Request value.

network_identifierNetworkIdentifierrequired

Rosetta network identifier object.

Show child attributes

blockchainstringrequired

Blockchain value.

networkstringrequired

If a blockchain has a specific chain-id or network identifier, it should go in this field. It is up to the client to determine which network-specific identifier is mainnet, preprod, or preview.

sub_network_identifierSubNetworkIdentifier

Sub Network Identifier value.

Show child attributes

networkstringrequired

Network value.

metadataobject

Additional metadata object.

block_identifierBlockIdentifierrequired

Rosetta block identifier object.

Show child attributes

indexinteger<int64>required

This is also known as the block height.

hashstringrequired

Cardano transaction hash.

transaction_identifierTransactionIdentifierrequired

Rosetta transaction identifier object.

Show child attributes

hashstringrequired

Any transactions that are attributable only to a block (ex: a block event) should use the hash of the block as the identifier.

Response

200OK

HTTP 200 response for blockTransaction.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get a Block Transaction

curl -X POST 'https://ada-blockfrost.nownodes.io/block/transaction' \
  -H 'Content-Type: application/json' \
  -d '{
    "network_identifier": {
      "blockchain": "cardano",
      "network": "mainnet",
      "sub_network_identifier": {
        "network": "shard 1",
        "metadata": {
          "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
        }
      }
    },
    "block_identifier": {
      "index": 1123941,
      "hash": "0x1f2cc6c5027d2f201a5453ad1119574d2aed23a392654742ac3c78783c071f85"
    },
    "transaction_identifier": {
      "hash": "0x2f23fd8cca835af21f3ac375bac601f97ead75f2e79143bdf71fe2c4be043e8f"
    }
  }'

const response = await fetch('https://ada-blockfrost.nownodes.io/block/transaction', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "network_identifier": {
        "blockchain": "cardano",
        "network": "mainnet",
        "sub_network_identifier": {
          "network": "shard 1",
          "metadata": {
            "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
          }
        }
      },
      "block_identifier": {
        "index": 1123941,
        "hash": "0x1f2cc6c5027d2f201a5453ad1119574d2aed23a392654742ac3c78783c071f85"
      },
      "transaction_identifier": {
        "hash": "0x2f23fd8cca835af21f3ac375bac601f97ead75f2e79143bdf71fe2c4be043e8f"
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "block_identifier": {
    "index": 1123941,
    "hash": "0x1f2cc6c5027d2f201a5453ad1119574d2aed23a392654742ac3c78783c071f85"
  },
  "transaction_identifier": {
    "hash": "0x2f23fd8cca835af21f3ac375bac601f97ead75f2e79143bdf71fe2c4be043e8f"
  }
}

response = requests.post('https://ada-blockfrost.nownodes.io/block/transaction', json=payload)
data = response.json()

Request Body

{
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "block_identifier": {
    "index": 1123941,
    "hash": "0x1f2cc6c5027d2f201a5453ad1119574d2aed23a392654742ac3c78783c071f85"
  },
  "transaction_identifier": {
    "hash": "0x2f23fd8cca835af21f3ac375bac601f97ead75f2e79143bdf71fe2c4be043e8f"
  }
}

{
  "transaction": {
    "transaction_identifier": {
      "hash": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650"
    },
    "operations": [
      {
        "operation_identifier": {
          "index": 0
        },
        "type": "input",
        "status": "success"
      }
    ]
  }
}

{
  "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"
}

Mempool

Mempool operations.

Get All Mempool Transactions

POST

https://ada-blockfrost.nownodes.io/mempool

Get all Transaction Identifiers in the mempool

Body

application/json

Request value.

network_identifierNetworkIdentifierrequired

Rosetta network identifier object.

Show child attributes

blockchainstringrequired

Blockchain value.

networkstringrequired

If a blockchain has a specific chain-id or network identifier, it should go in this field. It is up to the client to determine which network-specific identifier is mainnet, preprod, or preview.

sub_network_identifierSubNetworkIdentifier

Sub Network Identifier value.

Show child attributes

networkstringrequired

Network value.

metadataobject

Additional metadata object.

metadataobject

Additional metadata object.

Response

200OK

HTTP 200 response for mempool.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get All Mempool Transactions

curl -X POST 'https://ada-blockfrost.nownodes.io/mempool' \
  -H 'Content-Type: application/json' \
  -d '{
    "network_identifier": {
      "blockchain": "cardano",
      "network": "mainnet",
      "sub_network_identifier": {
        "network": "shard 1",
        "metadata": {
          "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
        }
      }
    },
    "metadata": {}
  }'

const response = await fetch('https://ada-blockfrost.nownodes.io/mempool', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "network_identifier": {
        "blockchain": "cardano",
        "network": "mainnet",
        "sub_network_identifier": {
          "network": "shard 1",
          "metadata": {
            "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
          }
        }
      },
      "metadata": {}
    }),
});

const data = await response.json();

import requests

payload = {
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "metadata": {}
}

response = requests.post('https://ada-blockfrost.nownodes.io/mempool', json=payload)
data = response.json()

Request Body

{
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "metadata": {}
}

{
  "transaction_identifiers": [
    {
      "hash": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650"
    },
    {
      "hash": "107c74af7e211745b9486c0a400e797f4463a451789d3e9e3b6936771315f148"
    }
  ]
}

{
  "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"
}

Get a Mempool Transaction

POST

https://ada-blockfrost.nownodes.io/mempool/transaction

Get a transaction in the mempool by its Transaction Identifier. This is a separate request than fetching a block transaction (/block/transaction) because some blockchain nodes need to know that a transaction query is for something in the mempool instead of a transaction in a block. Transactions may not be fully parsable until they are in a block (ex: may not be possible to determine the fee to pay before a transaction is executed). On this endpoint, it is ok that returned transactions are only estimates of what may actually be included in a block.

Body

application/json

Request value.

network_identifierNetworkIdentifierrequired

Rosetta network identifier object.

Show child attributes

blockchainstringrequired

Blockchain value.

networkstringrequired

If a blockchain has a specific chain-id or network identifier, it should go in this field. It is up to the client to determine which network-specific identifier is mainnet, preprod, or preview.

sub_network_identifierSubNetworkIdentifier

Sub Network Identifier value.

Show child attributes

networkstringrequired

Network value.

metadataobject

Additional metadata object.

transaction_identifierTransactionIdentifierrequired

Rosetta transaction identifier object.

Show child attributes

hashstringrequired

Any transactions that are attributable only to a block (ex: a block event) should use the hash of the block as the identifier.

Response

200OK

HTTP 200 response for mempoolTransaction.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get a Mempool Transaction

curl -X POST 'https://ada-blockfrost.nownodes.io/mempool/transaction' \
  -H 'Content-Type: application/json' \
  -d '{
    "network_identifier": {
      "blockchain": "cardano",
      "network": "mainnet",
      "sub_network_identifier": {
        "network": "shard 1",
        "metadata": {
          "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
        }
      }
    },
    "transaction_identifier": {
      "hash": "0x2f23fd8cca835af21f3ac375bac601f97ead75f2e79143bdf71fe2c4be043e8f"
    }
  }'

const response = await fetch('https://ada-blockfrost.nownodes.io/mempool/transaction', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "network_identifier": {
        "blockchain": "cardano",
        "network": "mainnet",
        "sub_network_identifier": {
          "network": "shard 1",
          "metadata": {
            "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
          }
        }
      },
      "transaction_identifier": {
        "hash": "0x2f23fd8cca835af21f3ac375bac601f97ead75f2e79143bdf71fe2c4be043e8f"
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "transaction_identifier": {
    "hash": "0x2f23fd8cca835af21f3ac375bac601f97ead75f2e79143bdf71fe2c4be043e8f"
  }
}

response = requests.post('https://ada-blockfrost.nownodes.io/mempool/transaction', json=payload)
data = response.json()

Request Body

{
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "transaction_identifier": {
    "hash": "0x2f23fd8cca835af21f3ac375bac601f97ead75f2e79143bdf71fe2c4be043e8f"
  }
}

{
  "transaction": {
    "transaction_identifier": {
      "hash": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650"
    },
    "operations": [
      {
        "operation_identifier": {
          "index": 0
        },
        "type": "input",
        "status": "success"
      }
    ]
  }
}

{
  "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

Account operations.

Get an Account's Balance

POST

https://ada-blockfrost.nownodes.io/account/balance

Get an array of all AccountBalances for an AccountIdentifier and the BlockIdentifier at which the balance lookup was performed. The BlockIdentifier must always be returned because some consumers of account balance data need to know specifically at which block the balance was calculated to compare balances they compute from operations with the balance returned by the node. It is important to note that making a balance request for an account without populating the SubAccountIdentifier should not result in the balance of all possible SubAccountIdentifiers being returned. Rather, it should result in the balance pertaining to no SubAccountIdentifiers being returned (sometimes called the liquid balance). To get all balances associated with an account, it may be necessary to perform multiple balance requests with unique AccountIdentifiers. It is also possible to perform a historical balance lookup (if the server supports it) by passing in an optional BlockIdentifier.

Body

application/json

Request value.

network_identifierNetworkIdentifierrequired

Rosetta network identifier object.

Show child attributes

blockchainstringrequired

Blockchain value.

networkstringrequired

If a blockchain has a specific chain-id or network identifier, it should go in this field. It is up to the client to determine which network-specific identifier is mainnet, preprod, or preview.

sub_network_identifierSubNetworkIdentifier

Sub Network Identifier value.

Show child attributes

networkstringrequired

Network value.

metadataobject

Additional metadata object.

account_identifierAccountIdentifierrequired

Rosetta account identifier object.

Show child attributes

addressstringrequired

The address may be a cryptographic public key (or some encoding of it) or a provided username.

sub_accountSubAccountIdentifier

Sub Account value.

Show child attributes

addressstringrequired

The SubAccount address may be a cryptographic value or some other identifier (ex: bonded) that uniquely specifies a SubAccount.

metadataobject

If the SubAccount address is not sufficient to uniquely specify a SubAccount, any other identifying information can be stored here. It is important to note that two SubAccounts with identical addresses but differing metadata will not be considered equal by clients.

metadataobject

Blockchains that utilize a username model (where the address is not a derivative of a cryptographic public key) should specify the public key(s) owned by the address in metadata.

Show child attributes

chain_codestring

Hex string encoded extension of bip32 private and public keys with an extra 256 bits of entropy that consists of 32 bytes

block_identifierPartialBlockIdentifier

Rosetta block identifier object.

Show child attributes

indexinteger<int64>

Cardano block height or Rosetta index.

hashstring

Cardano transaction hash.

currenciesArray<Currency>

In some cases, the caller may not want to retrieve all available balances for an AccountIdentifier. If the currencies field is populated, only balances for the specified currencies will be returned. If not populated, all available balances will be returned.

Show child attributes

symbolstringrequired

Canonical symbol associated with a currency.

decimalsinteger<int32>>= 0required

Number of decimal places in the standard unit representation of the amount. For example, BTC has 8 decimals. Note that it is not possible to represent the value of some currency in atomic units that is not base 10.

metadataany

Additional metadata object.

Response

200OK

HTTP 200 response for accountBalance.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get an Account's Balance

curl -X POST 'https://ada-blockfrost.nownodes.io/account/balance' \
  -H 'Content-Type: application/json' \
  -d '{
    "network_identifier": {
      "blockchain": "cardano",
      "network": "mainnet",
      "sub_network_identifier": {
        "network": "shard 1",
        "metadata": {
          "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
        }
      }
    },
    "account_identifier": {
      "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
      "sub_account": {
        "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
        "metadata": {}
      },
      "metadata": {
        "chain_code": "chain_code_example"
      }
    },
    "block_identifier": {
      "index": 1123941,
      "hash": "0x1f2cc6c5027d2f201a5453ad1119574d2aed23a392654742ac3c78783c071f85"
    },
    "currencies": [
      {
        "symbol": "BTC",
        "decimals": 8,
        "metadata": {}
      }
    ]
  }'

const response = await fetch('https://ada-blockfrost.nownodes.io/account/balance', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "network_identifier": {
        "blockchain": "cardano",
        "network": "mainnet",
        "sub_network_identifier": {
          "network": "shard 1",
          "metadata": {
            "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
          }
        }
      },
      "account_identifier": {
        "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
        "sub_account": {
          "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
          "metadata": {}
        },
        "metadata": {
          "chain_code": "chain_code_example"
        }
      },
      "block_identifier": {
        "index": 1123941,
        "hash": "0x1f2cc6c5027d2f201a5453ad1119574d2aed23a392654742ac3c78783c071f85"
      },
      "currencies": [
        {
          "symbol": "BTC",
          "decimals": 8,
          "metadata": {}
        }
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "account_identifier": {
    "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
    "sub_account": {
      "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "metadata": {}
    },
    "metadata": {
      "chain_code": "chain_code_example"
    }
  },
  "block_identifier": {
    "index": 1123941,
    "hash": "0x1f2cc6c5027d2f201a5453ad1119574d2aed23a392654742ac3c78783c071f85"
  },
  "currencies": [
    {
      "symbol": "BTC",
      "decimals": 8,
      "metadata": {}
    }
  ]
}

response = requests.post('https://ada-blockfrost.nownodes.io/account/balance', json=payload)
data = response.json()

Request Body

{
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "account_identifier": {
    "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
    "sub_account": {
      "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "metadata": {}
    },
    "metadata": {
      "chain_code": "chain_code_example"
    }
  },
  "block_identifier": {
    "index": 1123941,
    "hash": "0x1f2cc6c5027d2f201a5453ad1119574d2aed23a392654742ac3c78783c071f85"
  },
  "currencies": [
    {
      "symbol": "BTC",
      "decimals": 8,
      "metadata": {}
    }
  ]
}

{
  "block_identifier": {
    "index": 13646894,
    "hash": "9945cd69ca8e6bcf2e5f9a14742be0c051bf9dd916f0bb0b00ab39977b140d53"
  },
  "balances": [
    {
      "value": "94923541",
      "currency": {
        "symbol": "ADA",
        "decimals": 6
      }
    }
  ]
}

{
  "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"
}

Get an Account's Unspent Coins

POST

https://ada-blockfrost.nownodes.io/account/coins

Get an array of all unspent coins for an AccountIdentifier and the BlockIdentifier at which the lookup was performed. If your implementation does not support coins (i.e. it is for an account-based blockchain), you do not need to implement this endpoint. If you implementation does support coins (i.e. it is fro a UTXO-based blockchain), you MUST also complete the /account/balance endpoint. It is important to note that making a coins request for an account without populating the SubAccountIdentifier should not result in the coins of all possible SubAccountIdentifiers being returned. Rather, it should result in the coins pertaining to no SubAccountIdentifiers being returned. To get all coins associated with an account, it may be necessary to perform multiple coin requests with unique AccountIdentifiers. Optionally, an implementation may choose to support updating an AccountIdentifier's unspent coins based on the contents of the mempool. Note, using this functionality breaks any guarantee of idempotency.

Body

application/json

Request value.

network_identifierNetworkIdentifierrequired

Rosetta network identifier object.

Show child attributes

blockchainstringrequired

Blockchain value.

networkstringrequired

If a blockchain has a specific chain-id or network identifier, it should go in this field. It is up to the client to determine which network-specific identifier is mainnet, preprod, or preview.

sub_network_identifierSubNetworkIdentifier

Sub Network Identifier value.

Show child attributes

networkstringrequired

Network value.

metadataobject

Additional metadata object.

account_identifierAccountIdentifierrequired

Rosetta account identifier object.

Show child attributes

addressstringrequired

The address may be a cryptographic public key (or some encoding of it) or a provided username.

sub_accountSubAccountIdentifier

Sub Account value.

Show child attributes

addressstringrequired

The SubAccount address may be a cryptographic value or some other identifier (ex: bonded) that uniquely specifies a SubAccount.

metadataobject

Blockchains that utilize a username model (where the address is not a derivative of a cryptographic public key) should specify the public key(s) owned by the address in metadata.

Show child attributes

chain_codestring

Hex string encoded extension of bip32 private and public keys with an extra 256 bits of entropy that consists of 32 bytes

include_mempoolboolean

Include state from the mempool when looking up an account's unspent coins. Note, using this functionality breaks any guarantee of idempotency.

currenciesArray<Currency>

In some cases, the caller may not want to retrieve coins for all currencies for an AccountIdentifier. If the currencies field is populated, only coins for the specified currencies will be returned. If not populated, all unspent coins will be returned.

Show child attributes

symbolstringrequired

Canonical symbol associated with a currency.

decimalsinteger<int32>>= 0required

metadataany

Additional metadata object.

Response

200OK

HTTP 200 response for accountCoins.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get an Account's Unspent Coins

curl -X POST 'https://ada-blockfrost.nownodes.io/account/coins' \
  -H 'Content-Type: application/json' \
  -d '{
    "network_identifier": {
      "blockchain": "cardano",
      "network": "mainnet",
      "sub_network_identifier": {
        "network": "shard 1",
        "metadata": {
          "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
        }
      }
    },
    "account_identifier": {
      "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
      "sub_account": {
        "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
        "metadata": {}
      },
      "metadata": {
        "chain_code": "chain_code_example"
      }
    },
    "include_mempool": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
    "currencies": [
      {
        "symbol": "BTC",
        "decimals": 8,
        "metadata": {}
      }
    ]
  }'

const response = await fetch('https://ada-blockfrost.nownodes.io/account/coins', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "network_identifier": {
        "blockchain": "cardano",
        "network": "mainnet",
        "sub_network_identifier": {
          "network": "shard 1",
          "metadata": {
            "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
          }
        }
      },
      "account_identifier": {
        "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
        "sub_account": {
          "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
          "metadata": {}
        },
        "metadata": {
          "chain_code": "chain_code_example"
        }
      },
      "include_mempool": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
      "currencies": [
        {
          "symbol": "BTC",
          "decimals": 8,
          "metadata": {}
        }
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "account_identifier": {
    "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
    "sub_account": {
      "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "metadata": {}
    },
    "metadata": {
      "chain_code": "chain_code_example"
    }
  },
  "include_mempool": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
  "currencies": [
    {
      "symbol": "BTC",
      "decimals": 8,
      "metadata": {}
    }
  ]
}

response = requests.post('https://ada-blockfrost.nownodes.io/account/coins', json=payload)
data = response.json()

Request Body

{
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "account_identifier": {
    "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
    "sub_account": {
      "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "metadata": {}
    },
    "metadata": {
      "chain_code": "chain_code_example"
    }
  },
  "include_mempool": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
  "currencies": [
    {
      "symbol": "BTC",
      "decimals": 8,
      "metadata": {}
    }
  ]
}

{
  "block_identifier": {
    "index": 13646894,
    "hash": "9945cd69ca8e6bcf2e5f9a14742be0c051bf9dd916f0bb0b00ab39977b140d53"
  },
  "coins": [
    {
      "coin_identifier": {
        "identifier": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650:0"
      },
      "amount": {
        "value": "94923541",
        "currency": {
          "symbol": "ADA",
          "decimals": 6
        }
      }
    }
  ]
}

{
  "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"
}

Construction

Construction operations.

Derive an AccountIdentifier from a PublicKey

POST

https://ada-blockfrost.nownodes.io/construction/derive

Derive returns the AccountIdentifier associated with a public key. Blockchains that require an on-chain action to create an account should not implement this method.

Body

application/json

Request value.

network_identifierNetworkIdentifierrequired

Rosetta network identifier object.

Show child attributes

blockchainstringrequired

Blockchain value.

networkstringrequired

If a blockchain has a specific chain-id or network identifier, it should go in this field. It is up to the client to determine which network-specific identifier is mainnet, preprod, or preview.

sub_network_identifierSubNetworkIdentifier

Sub Network Identifier value.

Show child attributes

networkstringrequired

Network value.

metadataobject

Additional metadata object.

public_keyPublicKeyrequired

Public Key value.

Show child attributes

hex_bytesstringrequired

Hex-encoded public key bytes in the format specified by the CurveType.

curve_typeCurveTypesecp256k1secp256r1edwards25519tweedlerequired

Curve Type value.

metadataobject

Additional metadata object.

Show child attributes

staking_credentialPublicKey

Staking Credential value.

Show child attributes

hex_bytesstringrequired

Hex-encoded public key bytes in the format specified by the CurveType.

curve_typeCurveTypesecp256k1secp256r1edwards25519tweedlerequired

Curve Type value.

address_typeAddressType

Cardano address.

Response

200OK

HTTP 200 response for constructionDerive.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Derive an AccountIdentifier from a PublicKey

curl -X POST 'https://ada-blockfrost.nownodes.io/construction/derive' \
  -H 'Content-Type: application/json' \
  -d '{
    "network_identifier": {
      "blockchain": "cardano",
      "network": "mainnet",
      "sub_network_identifier": {
        "network": "shard 1",
        "metadata": {
          "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
        }
      }
    },
    "public_key": {
      "hex_bytes": "hex_bytes_example",
      "curve_type": "secp256k1"
    },
    "metadata": {
      "staking_credential": {
        "hex_bytes": "hex_bytes_example",
        "curve_type": "secp256k1"
      },
      "address_type": "schema46_example"
    }
  }'

const response = await fetch('https://ada-blockfrost.nownodes.io/construction/derive', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "network_identifier": {
        "blockchain": "cardano",
        "network": "mainnet",
        "sub_network_identifier": {
          "network": "shard 1",
          "metadata": {
            "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
          }
        }
      },
      "public_key": {
        "hex_bytes": "hex_bytes_example",
        "curve_type": "secp256k1"
      },
      "metadata": {
        "staking_credential": {
          "hex_bytes": "hex_bytes_example",
          "curve_type": "secp256k1"
        },
        "address_type": "schema46_example"
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "public_key": {
    "hex_bytes": "hex_bytes_example",
    "curve_type": "secp256k1"
  },
  "metadata": {
    "staking_credential": {
      "hex_bytes": "hex_bytes_example",
      "curve_type": "secp256k1"
    },
    "address_type": "schema46_example"
  }
}

response = requests.post('https://ada-blockfrost.nownodes.io/construction/derive', json=payload)
data = response.json()

Request Body

{
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "public_key": {
    "hex_bytes": "hex_bytes_example",
    "curve_type": "secp256k1"
  },
  "metadata": {
    "staking_credential": {
      "hex_bytes": "hex_bytes_example",
      "curve_type": "secp256k1"
    },
    "address_type": "schema46_example"
  }
}

{
  "metadata": {
    "network": "mainnet"
  },
  "unsigned_transaction": "84a4008182582004cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
  "payloads": []
}

{
  "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"
}

Create a Request to Fetch Metadata

POST

https://ada-blockfrost.nownodes.io/construction/preprocess

Preprocess is called prior to /construction/payloads to construct a request for any metadata that is needed for transaction construction given (i.e. account nonce). The options object returned from this endpoint will be sent to the /construction/metadata endpoint UNMODIFIED by the caller (in an offline execution environment). If your Construction API implementation has configuration options, they MUST be specified in the /construction/preprocess request (in the metadata field).

Body

application/json

Request value.

network_identifierobjectrequired

Rosetta network identifier.

Show child attributes

blockchainstringrequired

Blockchain name, always "cardano".

networkstringrequired

Cardano network identifier.

operationsArray<object>required

List of operations to preprocess.

Show child attributes

operation_identifierobjectrequired

Operation Identifier value.

Show child attributes

indexintegerrequired

The index of this operation within the transaction (0-based).

typestringrequired

Type of operation. For DRep delegation use "dRepVoteDelegation".

accountobjectrequired

Account value.

Show child attributes

addressstringrequired

The bech32 or bech32m encoded staking address.

metadataobject

Operation-specific metadata. Required for delegation.

Show child attributes

staking_credentialobjectrequired

Staking Credential value.

Show child attributes

hex_bytesstringrequired

Hex-encoded stake credential (28 bytes).

curve_typestringrequired

Curve type of the staking key.

drepobjectrequired

DRep delegation target. If using a 29-byte CIP-129 ID, omit type; for a raw 28-byte ID, type is required.

Show child attributes

idstringrequired

Hex-encoded DRep ID. 28-byte raw ID or 29-byte prefixed CIP-129 ID (0x22=key, 0x23=script).

typestring

Required only for raw 28-byte IDs. Either "key_hash" or "script_hash".

Response

200OK

HTTP 200 response for constructionPreprocess.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Create a Request to Fetch Metadata

curl -X POST 'https://ada-blockfrost.nownodes.io/construction/preprocess' \
  -H 'Content-Type: application/json' \
  -d '{
    "network_identifier": {
      "blockchain": "cardano",
      "network": "mainnet"
    },
    "operations": [
      {
        "operation_identifier": {
          "index": 0
        },
        "type": "dRepVoteDelegation",
        "account": {
          "address": "stake1uxa5pudxg77g3sdaddecmw8tvc6hmynywn49lltt4fmvn7caek7a5"
        },
        "metadata": {
          "staking_credential": {
            "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
            "curve_type": "edwards25519"
          },
          "drep": {
            "id": "74984fae4ca1715fa1f8759f9d871015ac87f449a85dea6cf9956da1",
            "type": "key_hash"
          }
        }
      }
    ]
  }'

const response = await fetch('https://ada-blockfrost.nownodes.io/construction/preprocess', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "network_identifier": {
        "blockchain": "cardano",
        "network": "mainnet"
      },
      "operations": [
        {
          "operation_identifier": {
            "index": 0
          },
          "type": "dRepVoteDelegation",
          "account": {
            "address": "stake1uxa5pudxg77g3sdaddecmw8tvc6hmynywn49lltt4fmvn7caek7a5"
          },
          "metadata": {
            "staking_credential": {
              "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
              "curve_type": "edwards25519"
            },
            "drep": {
              "id": "74984fae4ca1715fa1f8759f9d871015ac87f449a85dea6cf9956da1",
              "type": "key_hash"
            }
          }
        }
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet"
  },
  "operations": [
    {
      "operation_identifier": {
        "index": 0
      },
      "type": "dRepVoteDelegation",
      "account": {
        "address": "stake1uxa5pudxg77g3sdaddecmw8tvc6hmynywn49lltt4fmvn7caek7a5"
      },
      "metadata": {
        "staking_credential": {
          "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
          "curve_type": "edwards25519"
        },
        "drep": {
          "id": "74984fae4ca1715fa1f8759f9d871015ac87f449a85dea6cf9956da1",
          "type": "key_hash"
        }
      }
    }
  ]
}

response = requests.post('https://ada-blockfrost.nownodes.io/construction/preprocess', json=payload)
data = response.json()

Request Body

{
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet"
  },
  "operations": [
    {
      "operation_identifier": {
        "index": 0
      },
      "type": "dRepVoteDelegation",
      "account": {
        "address": "stake1uxa5pudxg77g3sdaddecmw8tvc6hmynywn49lltt4fmvn7caek7a5"
      },
      "metadata": {
        "staking_credential": {
          "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
          "curve_type": "edwards25519"
        },
        "drep": {
          "id": "74984fae4ca1715fa1f8759f9d871015ac87f449a85dea6cf9956da1",
          "type": "key_hash"
        }
      }
    }
  ]
}

{
  "metadata": {
    "network": "mainnet"
  },
  "unsigned_transaction": "84a4008182582004cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
  "payloads": []
}

{
  "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"
}

Get Metadata for Transaction Construction

POST

https://ada-blockfrost.nownodes.io/construction/metadata

Get any information required to construct a transaction for a specific network. Metadata returned here could be a recent hash to use, an account sequence number, or even arbitrary chain state. The request used when calling this endpoint is created by calling /construction/preprocess in an offline environment. You should NEVER assume that the request sent to this endpoint will be created by the caller or populated with any custom parameters. This must occur in /construction/preprocess. It is important to clarify that this endpoint should not pre-construct any transactions for the client (this should happen in /construction/payloads). This endpoint is left purposely unstructured because of the wide scope of metadata that could be required.

Body

application/json

Request value.

network_identifierNetworkIdentifierrequired

Rosetta network identifier object.

Show child attributes

blockchainstringrequired

Blockchain value.

networkstringrequired

If a blockchain has a specific chain-id or network identifier, it should go in this field. It is up to the client to determine which network-specific identifier is mainnet, preprod, or preview.

sub_network_identifierSubNetworkIdentifier

Sub Network Identifier value.

Show child attributes

networkstringrequired

Network value.

metadataobject

Additional metadata object.

optionsobjectrequired

Some blockchains require different metadata for different types of transaction construction (ex: delegation versus a transfer). Instead of requiring a blockchain node to return all possible types of metadata for construction (which may require multiple node fetches), the client can populate an options object to limit the metadata returned to only the subset required.

Show child attributes

relative_ttlnumberrequired

Relative Ttl value.

transaction_sizenumberrequired

Transaction Size value.

public_keysArray<PublicKey>

Public Keys value.

Show child attributes

hex_bytesstringrequired

Hex-encoded public key bytes in the format specified by the CurveType.

curve_typeCurveTypesecp256k1secp256r1edwards25519tweedlerequired

Curve Type value.

Response

200OK

HTTP 200 response for constructionMetadata.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get Metadata for Transaction Construction

curl -X POST 'https://ada-blockfrost.nownodes.io/construction/metadata' \
  -H 'Content-Type: application/json' \
  -d '{
    "network_identifier": {
      "blockchain": "cardano",
      "network": "mainnet",
      "sub_network_identifier": {
        "network": "shard 1",
        "metadata": {
          "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
        }
      }
    },
    "options": {
      "relative_ttl": 1,
      "transaction_size": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650"
    },
    "public_keys": [
      {
        "hex_bytes": "hex_bytes_example",
        "curve_type": "secp256k1"
      }
    ]
  }'

const response = await fetch('https://ada-blockfrost.nownodes.io/construction/metadata', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "network_identifier": {
        "blockchain": "cardano",
        "network": "mainnet",
        "sub_network_identifier": {
          "network": "shard 1",
          "metadata": {
            "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
          }
        }
      },
      "options": {
        "relative_ttl": 1,
        "transaction_size": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650"
      },
      "public_keys": [
        {
          "hex_bytes": "hex_bytes_example",
          "curve_type": "secp256k1"
        }
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "options": {
    "relative_ttl": 1,
    "transaction_size": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650"
  },
  "public_keys": [
    {
      "hex_bytes": "hex_bytes_example",
      "curve_type": "secp256k1"
    }
  ]
}

response = requests.post('https://ada-blockfrost.nownodes.io/construction/metadata', json=payload)
data = response.json()

Request Body

{
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "options": {
    "relative_ttl": 1,
    "transaction_size": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650"
  },
  "public_keys": [
    {
      "hex_bytes": "hex_bytes_example",
      "curve_type": "secp256k1"
    }
  ]
}

{
  "metadata": {
    "network": "mainnet"
  },
  "unsigned_transaction": "84a4008182582004cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
  "payloads": []
}

{
  "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"
}

Generate an Unsigned Transaction and Signing Payloads

POST

https://ada-blockfrost.nownodes.io/construction/payloads

Payloads is called with an array of operations and the response from /construction/metadata. It returns an unsigned transaction blob and a collection of payloads that must be signed by particular AccountIdentifiers using a certain SignatureType. The array of operations provided in transaction construction often times can not specify all "effects" of a transaction (consider invoked transactions in Ethereum). However, they can deterministically specify the "intent" of the transaction, which is sufficient for construction. For this reason, parsing the corresponding transaction in the Data API (when it lands on chain) will contain a superset of whatever operations were provided during construction.

Body

application/json

Request value.

network_identifierNetworkIdentifierrequired

Rosetta network identifier object.

Show child attributes

blockchainstringrequired

Blockchain value.

networkstringrequired

If a blockchain has a specific chain-id or network identifier, it should go in this field. It is up to the client to determine which network-specific identifier is mainnet, preprod, or preview.

sub_network_identifierSubNetworkIdentifier

Sub Network Identifier value.

Show child attributes

networkstringrequired

Network value.

metadataobject

Additional metadata object.

operationsArray<Operation>required

Operations value.

Show child attributes

operation_identifierOperationIdentifierrequired

Operation Identifier value.

Show child attributes

indexinteger<int64>>= 0required

The operation index is used to ensure each operation has a unique identifier within a transaction. This index is only relative to the transaction and NOT GLOBAL. The operations in each transaction should start from index 0. To clarify, there may not be any notion of an operation index in the blockchain being described.

network_indexinteger<int64>>= 0

Some blockchains specify an operation index that is essential for client use. For example, Bitcoin uses a network_index to identify which UTXO was used in a transaction. network_index should not be populated if there is no notion of an operation index in a blockchain (typically most account-based blockchains).

related_operationsArray<OperationIdentifier>

Restrict referenced related_operations to identifier indices < the current operation_identifier.index. This ensures there exists a clear DAG-structure of relations. Since operations are one-sided, one could imagine relating operations in a single transfer or linking operations in a call tree.

Show child attributes

indexinteger<int64>>= 0required

network_indexinteger<int64>>= 0

typestringrequired

Type is the network-specific type of the operation. Ensure that any type that can be returned here is also specified in the NetworkOptionsResponse. This can be very useful to downstream consumers that parse all block data.

statusstring

Status is the network-specific status of the operation. Status is not defined on the transaction object because blockchains with smart contracts may have transactions that partially apply (some operations are successful and some are not). Blockchains with atomic transactions (all operations succeed or all operations fail) will have the same status for each operation. On-chain operations (operations retrieved in the /block and /block/transaction endpoints) MUST have a populated status field (anything on-chain must have succeeded or failed). However, operations provided during transaction construction (often times called "intent" in the documentation) MUST NOT have a populated status field (operations yet to be included on-chain have not yet succeeded or failed).

accountAccountIdentifier

Rosetta account identifier object.

Show child attributes

addressstringrequired

The address may be a cryptographic public key (or some encoding of it) or a provided username.

sub_accountSubAccountIdentifier

Sub Account value.

Show child attributes

addressstringrequired

The SubAccount address may be a cryptographic value or some other identifier (ex: bonded) that uniquely specifies a SubAccount.

metadataobject

Blockchains that utilize a username model (where the address is not a derivative of a cryptographic public key) should specify the public key(s) owned by the address in metadata.

Show child attributes

chain_codestring

Hex string encoded extension of bip32 private and public keys with an extra 256 bits of entropy that consists of 32 bytes

amountAmount

Amount value.

Show child attributes

valuestringrequired

Value of the transaction in atomic units represented as an arbitrary-sized signed integer. For example, 1 BTC would be represented by a value of 100000000.

currencyCurrencyrequired

Rosetta currency object.

Show child attributes

symbolstringrequired

Canonical symbol associated with a currency.

decimalsinteger<int32>>= 0required

metadataany

Additional metadata object.

metadataobject

Additional metadata object.

coin_changeCoinChange

Coin Change value.

Show child attributes

coin_identifierCoinIdentifierrequired

Rosetta coin identifier object.

Show child attributes

identifierstringrequired

Identifier should be populated with a globally unique identifier of a Coin. In Bitcoin, this identifier would be transaction_hash:index.

coin_actionCoinActioncoin_createdcoin_spentrequired

Coin Action value.

metadataOperationMetadata

Additional metadata object.

Show child attributes

withdrawalAmountAmount

If it's a withdrawal operation, the amount will re returned here.

Show child attributes

valuestringrequired

Value of the transaction in atomic units represented as an arbitrary-sized signed integer. For example, 1 BTC would be represented by a value of 100000000.

currencyCurrencyrequired

Rosetta currency object.

Show child attributes

symbolstringrequired

Canonical symbol associated with a currency.

decimalsinteger<int32>>= 0required

metadataany

Additional metadata object.

metadataobject

Additional metadata object.

depositAmountAmount

If it's a registration operation, the amount will re returned here.

Show child attributes

valuestringrequired

Value of the transaction in atomic units represented as an arbitrary-sized signed integer. For example, 1 BTC would be represented by a value of 100000000.

currencyCurrencyrequired

Rosetta currency object.

Show child attributes

symbolstringrequired

Canonical symbol associated with a currency.

decimalsinteger<int32>>= 0required

metadataany

Additional metadata object.

metadataobject

Additional metadata object.

refundAmountAmount

If it's a deregistration operation, the amount will re returned here.

Show child attributes

valuestringrequired

Value of the transaction in atomic units represented as an arbitrary-sized signed integer. For example, 1 BTC would be represented by a value of 100000000.

currencyCurrencyrequired

Rosetta currency object.

Show child attributes

symbolstringrequired

Canonical symbol associated with a currency.

decimalsinteger<int32>>= 0required

metadataany

Additional metadata object.

metadataobject

Additional metadata object.

staking_credentialPublicKey

Staking Credential value.

Show child attributes

hex_bytesstringrequired

Hex-encoded public key bytes in the format specified by the CurveType.

curve_typeCurveTypesecp256k1secp256r1edwards25519tweedlerequired

Curve Type value.

pool_key_hashstring

Cardano transaction hash.

epochnumber

Cardano epoch number.

tokenBundleArray<TokenBundleItem>

A token bundle is a heterogeneous (‘mixed’) collection of tokens. Any tokens can be bundled together. Token bundles are the standard - and only - way to represent and store assets on the Cardano blockchain.

Show child attributes

policyIdstringrequired

Policy Id hex string

tokensArray<Amount>required

Tokens value.

Show child attributes

valuestringrequired

Value of the transaction in atomic units represented as an arbitrary-sized signed integer. For example, 1 BTC would be represented by a value of 100000000.

currencyCurrencyrequired

Rosetta currency object.

Show child attributes

symbolstringrequired

Canonical symbol associated with a currency.

decimalsinteger<int32>>= 0required

metadataany

Additional metadata object.

metadataobject

Additional metadata object.

poolRegistrationCertstring

Certificate of a pool registration encoded as hex string

poolRegistrationParamsPoolRegistrationParams

Cardano stake pool identifier or key hash.

Show child attributes

vrfKeyHashstringrequired

Cardano transaction hash.

rewardAddressstringrequired

Cardano reward address.

pledgestringrequired

Lovelace amount to pledge

coststringrequired

Operational costs per epoch lovelace

poolOwnersArray<string>required

Cardano stake pool identifier or key hash.

relaysArray<Relay>required

Relays value.

Show child attributes

typestring

Type value.

ipv4string

Ipv4 value.

ipv6string

Ipv6 value.

dnsNamestring

Dns Name value.

portstring

Port value.

marginPoolMargin

Margin value.

Show child attributes

numeratorstringrequired

Numerator value.

denominatorstringrequired

Denominator value.

margin_percentagestring

Margin Percentage value.

poolMetadataPoolMetadata

Cardano stake pool identifier or key hash.

Show child attributes

urlstringrequired

Url value.

hashstringrequired

Cardano transaction hash.

voteRegistrationMetadataVoteRegistrationMetadata

A Catalyst registration transaction is a regular Cardano transaction with a specific transaction metadata associated with it.

Show child attributes

stakeKeyPublicKeyrequired

The staking key on the Cardano network

Show child attributes

hex_bytesstringrequired

Hex-encoded public key bytes in the format specified by the CurveType.

curve_typeCurveTypesecp256k1secp256r1edwards25519tweedlerequired

Curve Type value.

votingKeyPublicKeyrequired

Catalyst voting key

Show child attributes

hex_bytesstringrequired

Hex-encoded public key bytes in the format specified by the CurveType.

curve_typeCurveTypesecp256k1secp256r1edwards25519tweedlerequired

Curve Type value.

rewardAddressstringrequired

Shelley address to receive rewards

votingNoncenumberrequired

Unsigned integer (of CBOR major type 0). Current slot number

votingSignaturestringrequired

ED25119 signature CBOR byte array of blake2b-256 hash of the registration metadata signed using the staking key

metadataobjectrequired

Additional metadata object.

Show child attributes

ttlstringrequired

Ttl value.

protocol_parametersProtocolParametersrequired

Protocol Parameters value.

Show child attributes

coinsPerUtxoSizestringrequired

Coins Per Utxo Size value.

maxTxSizenumberrequired

Max Tx Size value.

maxValSizenumberrequired

Max Val Size value.

keyDepositstringrequired

key registration cost in Lovelace

maxCollateralInputsnumberrequired

Max Collateral Inputs value.

minFeeCoefficientnumberrequired

Min Fee Coefficient value.

minFeeConstantnumberrequired

Min Fee Constant value.

minPoolCoststringrequired

Cardano stake pool identifier or key hash.

poolDepositstringrequired

pool registration cost in Lovelace

protocolintegerrequired

Protocol value.

public_keysArray<PublicKey>

Public Keys value.

Show child attributes

hex_bytesstringrequired

Hex-encoded public key bytes in the format specified by the CurveType.

curve_typeCurveTypesecp256k1secp256r1edwards25519tweedlerequired

Curve Type value.

Response

200OK

HTTP 200 response for constructionPayloads.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Generate an Unsigned Transaction and Signing Payloads

curl -X POST 'https://ada-blockfrost.nownodes.io/construction/payloads' \
  -H 'Content-Type: application/json' \
  -d '{
    "network_identifier": {
      "blockchain": "cardano",
      "network": "mainnet",
      "sub_network_identifier": {
        "network": "shard 1",
        "metadata": {
          "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
        }
      }
    },
    "operations": [
      {
        "operation_identifier": {
          "index": 5,
          "network_index": 0
        },
        "related_operations": [
          {
            "index": 1
          },
          {
            "index": 2
          }
        ],
        "type": "Transfer",
        "status": "Reverted",
        "account": {
          "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
          "sub_account": {
            "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
            "metadata": {}
          },
          "metadata": {
            "chain_code": "chain_code_example"
          }
        },
        "amount": {
          "value": "1238089899992",
          "currency": {
            "symbol": "BTC",
            "decimals": 8,
            "metadata": {}
          },
          "metadata": {}
        },
        "coin_change": {
          "coin_identifier": {
            "identifier": "0x2f23fd8cca835af21f3ac375bac601f97ead75f2e79143bdf71fe2c4be043e8f:1"
          },
          "coin_action": "coin_created"
        },
        "metadata": {
          "staking_credential": {
            "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
            "curve_type": "edwards25519"
          },
          "payment_key": {
            "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
            "curve_type": "edwards25519"
          },
          "asm": "304502201fd8abb11443f8b1b9a04e0495e0543d05611473a790c8939f089d073f90509a022100f4677825136605d732e2126d09a2d38c20c75946cd9fc239c0497e84c634e3dd01 03301a8259a12e35694cc22ebc45fee635f4993064190f6ce96e7fb19a03bb6be2",
          "hex": "48304502201fd8abb11443f8b1b9a04e0495e0543d05611473a790c8939f089d073f90509a022100f4677825136605d732e2126d09a2d38c20c75946cd9fc239c0497e84c634e3dd012103301a8259a12e35694cc22ebc45fee635f4993064190f6ce96e7fb19a03bb6be2"
        }
      }
    ],
    "metadata": {
      "ttl": "ttl_example",
      "protocol_parameters": {
        "coinsPerUtxoSize": "coinsperutxosize_example",
        "maxTxSize": 1,
        "maxValSize": 1,
        "keyDeposit": "keydeposit_example",
        "maxCollateralInputs": 1,
        "minFeeCoefficient": 1,
        "minFeeConstant": 1,
        "minPoolCost": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
        "poolDeposit": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
        "protocol": 1
      }
    },
    "public_keys": [
      {
        "hex_bytes": "hex_bytes_example",
        "curve_type": "secp256k1"
      }
    ]
  }'

const response = await fetch('https://ada-blockfrost.nownodes.io/construction/payloads', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "network_identifier": {
        "blockchain": "cardano",
        "network": "mainnet",
        "sub_network_identifier": {
          "network": "shard 1",
          "metadata": {
            "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
          }
        }
      },
      "operations": [
        {
          "operation_identifier": {
            "index": 5,
            "network_index": 0
          },
          "related_operations": [
            {
              "index": 1
            },
            {
              "index": 2
            }
          ],
          "type": "Transfer",
          "status": "Reverted",
          "account": {
            "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
            "sub_account": {
              "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
              "metadata": {}
            },
            "metadata": {
              "chain_code": "chain_code_example"
            }
          },
          "amount": {
            "value": "1238089899992",
            "currency": {
              "symbol": "BTC",
              "decimals": 8,
              "metadata": {}
            },
            "metadata": {}
          },
          "coin_change": {
            "coin_identifier": {
              "identifier": "0x2f23fd8cca835af21f3ac375bac601f97ead75f2e79143bdf71fe2c4be043e8f:1"
            },
            "coin_action": "coin_created"
          },
          "metadata": {
            "staking_credential": {
              "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
              "curve_type": "edwards25519"
            },
            "payment_key": {
              "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
              "curve_type": "edwards25519"
            },
            "asm": "304502201fd8abb11443f8b1b9a04e0495e0543d05611473a790c8939f089d073f90509a022100f4677825136605d732e2126d09a2d38c20c75946cd9fc239c0497e84c634e3dd01 03301a8259a12e35694cc22ebc45fee635f4993064190f6ce96e7fb19a03bb6be2",
            "hex": "48304502201fd8abb11443f8b1b9a04e0495e0543d05611473a790c8939f089d073f90509a022100f4677825136605d732e2126d09a2d38c20c75946cd9fc239c0497e84c634e3dd012103301a8259a12e35694cc22ebc45fee635f4993064190f6ce96e7fb19a03bb6be2"
          }
        }
      ],
      "metadata": {
        "ttl": "ttl_example",
        "protocol_parameters": {
          "coinsPerUtxoSize": "coinsperutxosize_example",
          "maxTxSize": 1,
          "maxValSize": 1,
          "keyDeposit": "keydeposit_example",
          "maxCollateralInputs": 1,
          "minFeeCoefficient": 1,
          "minFeeConstant": 1,
          "minPoolCost": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
          "poolDeposit": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
          "protocol": 1
        }
      },
      "public_keys": [
        {
          "hex_bytes": "hex_bytes_example",
          "curve_type": "secp256k1"
        }
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "operations": [
    {
      "operation_identifier": {
        "index": 5,
        "network_index": 0
      },
      "related_operations": [
        {
          "index": 1
        },
        {
          "index": 2
        }
      ],
      "type": "Transfer",
      "status": "Reverted",
      "account": {
        "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
        "sub_account": {
          "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
          "metadata": {}
        },
        "metadata": {
          "chain_code": "chain_code_example"
        }
      },
      "amount": {
        "value": "1238089899992",
        "currency": {
          "symbol": "BTC",
          "decimals": 8,
          "metadata": {}
        },
        "metadata": {}
      },
      "coin_change": {
        "coin_identifier": {
          "identifier": "0x2f23fd8cca835af21f3ac375bac601f97ead75f2e79143bdf71fe2c4be043e8f:1"
        },
        "coin_action": "coin_created"
      },
      "metadata": {
        "staking_credential": {
          "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
          "curve_type": "edwards25519"
        },
        "payment_key": {
          "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
          "curve_type": "edwards25519"
        },
        "asm": "304502201fd8abb11443f8b1b9a04e0495e0543d05611473a790c8939f089d073f90509a022100f4677825136605d732e2126d09a2d38c20c75946cd9fc239c0497e84c634e3dd01 03301a8259a12e35694cc22ebc45fee635f4993064190f6ce96e7fb19a03bb6be2",
        "hex": "48304502201fd8abb11443f8b1b9a04e0495e0543d05611473a790c8939f089d073f90509a022100f4677825136605d732e2126d09a2d38c20c75946cd9fc239c0497e84c634e3dd012103301a8259a12e35694cc22ebc45fee635f4993064190f6ce96e7fb19a03bb6be2"
      }
    }
  ],
  "metadata": {
    "ttl": "ttl_example",
    "protocol_parameters": {
      "coinsPerUtxoSize": "coinsperutxosize_example",
      "maxTxSize": 1,
      "maxValSize": 1,
      "keyDeposit": "keydeposit_example",
      "maxCollateralInputs": 1,
      "minFeeCoefficient": 1,
      "minFeeConstant": 1,
      "minPoolCost": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
      "poolDeposit": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
      "protocol": 1
    }
  },
  "public_keys": [
    {
      "hex_bytes": "hex_bytes_example",
      "curve_type": "secp256k1"
    }
  ]
}

response = requests.post('https://ada-blockfrost.nownodes.io/construction/payloads', json=payload)
data = response.json()

Request Body

{
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "operations": [
    {
      "operation_identifier": {
        "index": 5,
        "network_index": 0
      },
      "related_operations": [
        {
          "index": 1
        },
        {
          "index": 2
        }
      ],
      "type": "Transfer",
      "status": "Reverted",
      "account": {
        "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
        "sub_account": {
          "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
          "metadata": {}
        },
        "metadata": {
          "chain_code": "chain_code_example"
        }
      },
      "amount": {
        "value": "1238089899992",
        "currency": {
          "symbol": "BTC",
          "decimals": 8,
          "metadata": {}
        },
        "metadata": {}
      },
      "coin_change": {
        "coin_identifier": {
          "identifier": "0x2f23fd8cca835af21f3ac375bac601f97ead75f2e79143bdf71fe2c4be043e8f:1"
        },
        "coin_action": "coin_created"
      },
      "metadata": {
        "staking_credential": {
          "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
          "curve_type": "edwards25519"
        },
        "payment_key": {
          "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
          "curve_type": "edwards25519"
        },
        "asm": "304502201fd8abb11443f8b1b9a04e0495e0543d05611473a790c8939f089d073f90509a022100f4677825136605d732e2126d09a2d38c20c75946cd9fc239c0497e84c634e3dd01 03301a8259a12e35694cc22ebc45fee635f4993064190f6ce96e7fb19a03bb6be2",
        "hex": "48304502201fd8abb11443f8b1b9a04e0495e0543d05611473a790c8939f089d073f90509a022100f4677825136605d732e2126d09a2d38c20c75946cd9fc239c0497e84c634e3dd012103301a8259a12e35694cc22ebc45fee635f4993064190f6ce96e7fb19a03bb6be2"
      }
    }
  ],
  "metadata": {
    "ttl": "ttl_example",
    "protocol_parameters": {
      "coinsPerUtxoSize": "coinsperutxosize_example",
      "maxTxSize": 1,
      "maxValSize": 1,
      "keyDeposit": "keydeposit_example",
      "maxCollateralInputs": 1,
      "minFeeCoefficient": 1,
      "minFeeConstant": 1,
      "minPoolCost": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
      "poolDeposit": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
      "protocol": 1
    }
  },
  "public_keys": [
    {
      "hex_bytes": "hex_bytes_example",
      "curve_type": "secp256k1"
    }
  ]
}

{
  "metadata": {
    "network": "mainnet"
  },
  "unsigned_transaction": "84a4008182582004cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
  "payloads": []
}

{
  "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"
}

Create Network Transaction from Signatures

POST

https://ada-blockfrost.nownodes.io/construction/combine

Combine creates a network-specific transaction from an unsigned transaction and an array of provided signatures. The signed transaction returned from this method will be sent to the /construction/submit endpoint by the caller.

Body

application/json

Request value.

network_identifierNetworkIdentifierrequired

Rosetta network identifier object.

Show child attributes

blockchainstringrequired

Blockchain value.

networkstringrequired

If a blockchain has a specific chain-id or network identifier, it should go in this field. It is up to the client to determine which network-specific identifier is mainnet, preprod, or preview.

sub_network_identifierSubNetworkIdentifier

Sub Network Identifier value.

Show child attributes

networkstringrequired

Network value.

metadataobject

Additional metadata object.

unsigned_transactionstringrequired

Unsigned Transaction value.

signaturesArray<Signature>required

Signatures value.

Show child attributes

signing_payloadSigningPayloadrequired

Signing Payload value.

Show child attributes

addressstring

[DEPRECATED by account_identifier in v1.4.4] The network-specific address of the account that should sign the payload.

account_identifierAccountIdentifier

Rosetta account identifier object.

Show child attributes

addressstringrequired

The address may be a cryptographic public key (or some encoding of it) or a provided username.

sub_accountSubAccountIdentifier

Sub Account value.

Show child attributes

addressstringrequired

The SubAccount address may be a cryptographic value or some other identifier (ex: bonded) that uniquely specifies a SubAccount.

metadataobject

Blockchains that utilize a username model (where the address is not a derivative of a cryptographic public key) should specify the public key(s) owned by the address in metadata.

Show child attributes

chain_codestring

Hex string encoded extension of bip32 private and public keys with an extra 256 bits of entropy that consists of 32 bytes

hex_bytesstringrequired

Hex Bytes value.

signature_typeSignatureTypeecdsaecdsa_recoveryed25519schnorr_1schnorr_poseidon

Signature Type value.

public_keyPublicKeyrequired

Public Key value.

Show child attributes

hex_bytesstringrequired

Hex-encoded public key bytes in the format specified by the CurveType.

curve_typeCurveTypesecp256k1secp256r1edwards25519tweedlerequired

Curve Type value.

signature_typeSignatureTypeecdsaecdsa_recoveryed25519schnorr_1schnorr_poseidonrequired

Signature Type value.

hex_bytesstringrequired

Hex Bytes value.

Response

200OK

HTTP 200 response for constructionCombine.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Create Network Transaction from Signatures

curl -X POST 'https://ada-blockfrost.nownodes.io/construction/combine' \
  -H 'Content-Type: application/json' \
  -d '{
    "network_identifier": {
      "blockchain": "cardano",
      "network": "mainnet",
      "sub_network_identifier": {
        "network": "shard 1",
        "metadata": {
          "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
        }
      }
    },
    "unsigned_transaction": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
    "signatures": [
      {
        "signing_payload": {
          "address": "addr1qx2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3a3cw7eygp6r7g4w0n4q3f4zq0j6x8",
          "account_identifier": {
            "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
            "sub_account": {
              "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
              "metadata": {}
            },
            "metadata": {
              "chain_code": "chain_code_example"
            }
          },
          "hex_bytes": "hex_bytes_example",
          "signature_type": "ecdsa"
        },
        "public_key": {
          "hex_bytes": "hex_bytes_example",
          "curve_type": "secp256k1"
        },
        "signature_type": "ecdsa",
        "hex_bytes": "hex_bytes_example"
      }
    ]
  }'

const response = await fetch('https://ada-blockfrost.nownodes.io/construction/combine', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "network_identifier": {
        "blockchain": "cardano",
        "network": "mainnet",
        "sub_network_identifier": {
          "network": "shard 1",
          "metadata": {
            "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
          }
        }
      },
      "unsigned_transaction": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
      "signatures": [
        {
          "signing_payload": {
            "address": "addr1qx2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3a3cw7eygp6r7g4w0n4q3f4zq0j6x8",
            "account_identifier": {
              "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
              "sub_account": {
                "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
                "metadata": {}
              },
              "metadata": {
                "chain_code": "chain_code_example"
              }
            },
            "hex_bytes": "hex_bytes_example",
            "signature_type": "ecdsa"
          },
          "public_key": {
            "hex_bytes": "hex_bytes_example",
            "curve_type": "secp256k1"
          },
          "signature_type": "ecdsa",
          "hex_bytes": "hex_bytes_example"
        }
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "unsigned_transaction": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
  "signatures": [
    {
      "signing_payload": {
        "address": "addr1qx2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3a3cw7eygp6r7g4w0n4q3f4zq0j6x8",
        "account_identifier": {
          "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
          "sub_account": {
            "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
            "metadata": {}
          },
          "metadata": {
            "chain_code": "chain_code_example"
          }
        },
        "hex_bytes": "hex_bytes_example",
        "signature_type": "ecdsa"
      },
      "public_key": {
        "hex_bytes": "hex_bytes_example",
        "curve_type": "secp256k1"
      },
      "signature_type": "ecdsa",
      "hex_bytes": "hex_bytes_example"
    }
  ]
}

response = requests.post('https://ada-blockfrost.nownodes.io/construction/combine', json=payload)
data = response.json()

Request Body

{
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "unsigned_transaction": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
  "signatures": [
    {
      "signing_payload": {
        "address": "addr1qx2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3a3cw7eygp6r7g4w0n4q3f4zq0j6x8",
        "account_identifier": {
          "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
          "sub_account": {
            "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
            "metadata": {}
          },
          "metadata": {
            "chain_code": "chain_code_example"
          }
        },
        "hex_bytes": "hex_bytes_example",
        "signature_type": "ecdsa"
      },
      "public_key": {
        "hex_bytes": "hex_bytes_example",
        "curve_type": "secp256k1"
      },
      "signature_type": "ecdsa",
      "hex_bytes": "hex_bytes_example"
    }
  ]
}

{
  "metadata": {
    "network": "mainnet"
  },
  "unsigned_transaction": "84a4008182582004cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
  "payloads": []
}

{
  "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"
}

Parse a Transaction

POST

https://ada-blockfrost.nownodes.io/construction/parse

Parse is called on both unsigned and signed transactions to understand the intent of the formulated transaction. This is run as a sanity check before signing (after /construction/payloads) and before broadcast (after /construction/combine).

Body

application/json

Request value.

network_identifierNetworkIdentifierrequired

Rosetta network identifier object.

Show child attributes

blockchainstringrequired

Blockchain value.

networkstringrequired

If a blockchain has a specific chain-id or network identifier, it should go in this field. It is up to the client to determine which network-specific identifier is mainnet, preprod, or preview.

sub_network_identifierSubNetworkIdentifier

Sub Network Identifier value.

Show child attributes

networkstringrequired

Network value.

metadataobject

Additional metadata object.

signedbooleanrequired

Signed is a boolean indicating whether the transaction is signed.

transactionstringrequired

This must be either the unsigned transaction blob returned by /construction/payloads or the signed transaction blob returned by /construction/combine.

Response

200OK

HTTP 200 response for constructionParse.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Parse a Transaction

curl -X POST 'https://ada-blockfrost.nownodes.io/construction/parse' \
  -H 'Content-Type: application/json' \
  -d '{
    "network_identifier": {
      "blockchain": "cardano",
      "network": "mainnet",
      "sub_network_identifier": {
        "network": "shard 1",
        "metadata": {
          "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
        }
      }
    },
    "signed": true,
    "transaction": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650"
  }'

const response = await fetch('https://ada-blockfrost.nownodes.io/construction/parse', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "network_identifier": {
        "blockchain": "cardano",
        "network": "mainnet",
        "sub_network_identifier": {
          "network": "shard 1",
          "metadata": {
            "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
          }
        }
      },
      "signed": true,
      "transaction": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650"
    }),
});

const data = await response.json();

import requests

payload = {
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "signed": True,
  "transaction": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650"
}

response = requests.post('https://ada-blockfrost.nownodes.io/construction/parse', json=payload)
data = response.json()

Request Body

{
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "signed": true,
  "transaction": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650"
}

{
  "metadata": {
    "network": "mainnet"
  },
  "unsigned_transaction": "84a4008182582004cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
  "payloads": []
}

{
  "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"
}

Get the Hash of a Signed Transaction

POST

https://ada-blockfrost.nownodes.io/construction/hash

TransactionHash returns the network-specific transaction hash for a signed transaction.

Body

application/json

Request value.

network_identifierNetworkIdentifierrequired

Rosetta network identifier object.

Show child attributes

blockchainstringrequired

Blockchain value.

networkstringrequired

If a blockchain has a specific chain-id or network identifier, it should go in this field. It is up to the client to determine which network-specific identifier is mainnet, preprod, or preview.

sub_network_identifierSubNetworkIdentifier

Sub Network Identifier value.

Show child attributes

networkstringrequired

Network value.

metadataobject

Additional metadata object.

signed_transactionstringrequired

Signed Transaction value.

Response

200OK

HTTP 200 response for constructionHash.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get the Hash of a Signed Transaction

curl -X POST 'https://ada-blockfrost.nownodes.io/construction/hash' \
  -H 'Content-Type: application/json' \
  -d '{
    "network_identifier": {
      "blockchain": "cardano",
      "network": "mainnet",
      "sub_network_identifier": {
        "network": "shard 1",
        "metadata": {
          "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
        }
      }
    },
    "signed_transaction": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650"
  }'

const response = await fetch('https://ada-blockfrost.nownodes.io/construction/hash', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "network_identifier": {
        "blockchain": "cardano",
        "network": "mainnet",
        "sub_network_identifier": {
          "network": "shard 1",
          "metadata": {
            "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
          }
        }
      },
      "signed_transaction": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650"
    }),
});

const data = await response.json();

import requests

payload = {
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "signed_transaction": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650"
}

response = requests.post('https://ada-blockfrost.nownodes.io/construction/hash', json=payload)
data = response.json()

Request Body

{
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "signed_transaction": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650"
}

{
  "transaction_identifier": {
    "hash": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650"
  }
}

{
  "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"
}

Submit a Signed Transaction

POST

https://ada-blockfrost.nownodes.io/construction/submit

Submit a pre-signed transaction to the node. This call should not block on the transaction being included in a block. Rather, it should return immediately with an indication of whether or not the transaction was included in the mempool. The transaction submission response should only return a 200 status if the submitted transaction could be included in the mempool. Otherwise, it should return an error.

Body

application/json

Request value.

network_identifierNetworkIdentifierrequired

Rosetta network identifier object.

Show child attributes

blockchainstringrequired

Blockchain value.

networkstringrequired

If a blockchain has a specific chain-id or network identifier, it should go in this field. It is up to the client to determine which network-specific identifier is mainnet, preprod, or preview.

sub_network_identifierSubNetworkIdentifier

Sub Network Identifier value.

Show child attributes

networkstringrequired

Network value.

metadataobject

Additional metadata object.

signed_transactionstringrequired

Signed Transaction value.

Response

200OK

HTTP 200 response for constructionSubmit.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Submit a Signed Transaction

curl -X POST 'https://ada-blockfrost.nownodes.io/construction/submit' \
  -H 'Content-Type: application/json' \
  -d '{
    "network_identifier": {
      "blockchain": "cardano",
      "network": "mainnet",
      "sub_network_identifier": {
        "network": "shard 1",
        "metadata": {
          "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
        }
      }
    },
    "signed_transaction": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650"
  }'

const response = await fetch('https://ada-blockfrost.nownodes.io/construction/submit', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "network_identifier": {
        "blockchain": "cardano",
        "network": "mainnet",
        "sub_network_identifier": {
          "network": "shard 1",
          "metadata": {
            "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
          }
        }
      },
      "signed_transaction": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650"
    }),
});

const data = await response.json();

import requests

payload = {
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "signed_transaction": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650"
}

response = requests.post('https://ada-blockfrost.nownodes.io/construction/submit', json=payload)
data = response.json()

Request Body

{
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "signed_transaction": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650"
}

{
  "transaction_identifier": {
    "hash": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650"
  },
  "metadata": {
    "submitted": true
  }
}

{
  "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"
}

Events

Events operations.

[INDEXER] Get a range of BlockEvents

POST

https://ada-blockfrost.nownodes.io/events/blocks

/events/blocks allows the caller to query a sequence of BlockEvents indicating which blocks were added and removed from storage to reach the current state. Following BlockEvents allows lightweight clients to update their state without needing to implement their own syncing logic (like finding the common parent in a reorg). /events/blocks is considered an "indexer" endpoint and Rosetta implementations are not required to complete it to adhere to the Rosetta spec. However, any Rosetta "indexer" MUST support this endpoint.

Body

application/json

Request value.

network_identifierNetworkIdentifierrequired

Rosetta network identifier object.

Show child attributes

blockchainstringrequired

Blockchain value.

networkstringrequired

If a blockchain has a specific chain-id or network identifier, it should go in this field. It is up to the client to determine which network-specific identifier is mainnet, preprod, or preview.

sub_network_identifierSubNetworkIdentifier

Sub Network Identifier value.

Show child attributes

networkstringrequired

Network value.

metadataobject

Additional metadata object.

offsetinteger<int64>>= 0

offset is the offset into the event stream to sync events from. If this field is not populated, we return the limit events backwards from tip. If this is set to 0, we start from the beginning.

limitinteger<int64>>= 0

limit is the maximum number of events to fetch in one call. The implementation may return <= limit events.

Response

200OK

HTTP 200 response for eventsBlocks.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

[INDEXER] Get a range of BlockEvents

curl -X POST 'https://ada-blockfrost.nownodes.io/events/blocks' \
  -H 'Content-Type: application/json' \
  -d '{
    "network_identifier": {
      "blockchain": "cardano",
      "network": "mainnet",
      "sub_network_identifier": {
        "network": "shard 1",
        "metadata": {
          "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
        }
      }
    },
    "offset": 5,
    "limit": 5
  }'

const response = await fetch('https://ada-blockfrost.nownodes.io/events/blocks', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "network_identifier": {
        "blockchain": "cardano",
        "network": "mainnet",
        "sub_network_identifier": {
          "network": "shard 1",
          "metadata": {
            "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
          }
        }
      },
      "offset": 5,
      "limit": 5
    }),
});

const data = await response.json();

import requests

payload = {
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "offset": 5,
  "limit": 5
}

response = requests.post('https://ada-blockfrost.nownodes.io/events/blocks', json=payload)
data = response.json()

Request Body

{
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "offset": 5,
  "limit": 5
}

{
  "max_sequence": 13646894,
  "events": [
    {
      "sequence": 13646894,
      "block_identifier": {
        "index": 13646894,
        "hash": "9945cd69ca8e6bcf2e5f9a14742be0c051bf9dd916f0bb0b00ab39977b140d53"
      },
      "type": "block_added"
    }
  ]
}

{
  "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"
}

Search

Search operations.

[INDEXER] Search for Transactions

POST

https://ada-blockfrost.nownodes.io/search/transactions

/search/transactions allows the caller to search for transactions that meet certain conditions. Some conditions include matching a transaction hash, containing an operation with a certain status, or containing an operation that affects a certain account. /search/transactions is considered an "indexer" endpoint and Rosetta implementations are not required to complete it to adhere to the Rosetta spec. However, any Rosetta "indexer" MUST support this endpoint.

Body

application/json

Request value.

network_identifierNetworkIdentifierrequired

Rosetta network identifier object.

Show child attributes

blockchainstringrequired

Blockchain value.

networkstringrequired

If a blockchain has a specific chain-id or network identifier, it should go in this field. It is up to the client to determine which network-specific identifier is mainnet, preprod, or preview.

sub_network_identifierSubNetworkIdentifier

Sub Network Identifier value.

Show child attributes

networkstringrequired

Network value.

metadataobject

Additional metadata object.

operatorOperatororand

Operator value.

max_blockinteger<int64>>= 0

max_block is the largest block index to consider when searching for transactions. If this field is not populated, the current block is considered the max_block. If you do not specify a max_block, it is possible a newly synced block will interfere with paginated transaction queries (as the offset could become invalid with newly added rows).

offsetinteger<int64>>= 0

offset is the offset into the query result to start returning transactions. If any search conditions are changed, the query offset will change and you must restart your search iteration.

limitinteger<int64>>= 0

limit is the maximum number of transactions to return in one call. The implementation may return <= limit transactions.

transaction_identifierTransactionIdentifier

Rosetta transaction identifier object.

Show child attributes

hashstringrequired

Any transactions that are attributable only to a block (ex: a block event) should use the hash of the block as the identifier.

account_identifierAccountIdentifier

Rosetta account identifier object.

Show child attributes

addressstringrequired

The address may be a cryptographic public key (or some encoding of it) or a provided username.

sub_accountSubAccountIdentifier

Sub Account value.

Show child attributes

addressstringrequired

The SubAccount address may be a cryptographic value or some other identifier (ex: bonded) that uniquely specifies a SubAccount.

metadataobject

Blockchains that utilize a username model (where the address is not a derivative of a cryptographic public key) should specify the public key(s) owned by the address in metadata.

Show child attributes

chain_codestring

Hex string encoded extension of bip32 private and public keys with an extra 256 bits of entropy that consists of 32 bytes

coin_identifierCoinIdentifier

Rosetta coin identifier object.

Show child attributes

identifierstringrequired

Identifier should be populated with a globally unique identifier of a Coin. In Bitcoin, this identifier would be transaction_hash:index.

currencyCurrency

Rosetta currency object.

Show child attributes

symbolstringrequired

Canonical symbol associated with a currency.

decimalsinteger<int32>>= 0required

metadataany

Additional metadata object.

statusstring

status is the network-specific operation type.

typestring

type is the network-specific operation type.

addressstring

address is AccountIdentifier.Address. This is used to get all transactions related to an AccountIdentifier.Address, regardless of SubAccountIdentifier.

successboolean

success is a synthetic condition populated by parsing network-specific operation statuses (using the mapping provided in /network/options).

Response

200OK

HTTP 200 response for searchTransactions.

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.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

[INDEXER] Search for Transactions

curl -X POST 'https://ada-blockfrost.nownodes.io/search/transactions' \
  -H 'Content-Type: application/json' \
  -d '{
    "network_identifier": {
      "blockchain": "cardano",
      "network": "mainnet",
      "sub_network_identifier": {
        "network": "shard 1",
        "metadata": {
          "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
        }
      }
    },
    "operator": "or",
    "max_block": 5,
    "offset": 5,
    "limit": 5,
    "transaction_identifier": {
      "hash": "0x2f23fd8cca835af21f3ac375bac601f97ead75f2e79143bdf71fe2c4be043e8f"
    },
    "account_identifier": {
      "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
      "sub_account": {
        "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
        "metadata": {}
      },
      "metadata": {
        "chain_code": "chain_code_example"
      }
    },
    "coin_identifier": {
      "identifier": "0x2f23fd8cca835af21f3ac375bac601f97ead75f2e79143bdf71fe2c4be043e8f:1"
    },
    "currency": {
      "symbol": "BTC",
      "decimals": 8,
      "metadata": {}
    },
    "status": "reverted",
    "type": "transfer",
    "address": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "success": true
  }'

const response = await fetch('https://ada-blockfrost.nownodes.io/search/transactions', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "network_identifier": {
        "blockchain": "cardano",
        "network": "mainnet",
        "sub_network_identifier": {
          "network": "shard 1",
          "metadata": {
            "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
          }
        }
      },
      "operator": "or",
      "max_block": 5,
      "offset": 5,
      "limit": 5,
      "transaction_identifier": {
        "hash": "0x2f23fd8cca835af21f3ac375bac601f97ead75f2e79143bdf71fe2c4be043e8f"
      },
      "account_identifier": {
        "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
        "sub_account": {
          "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
          "metadata": {}
        },
        "metadata": {
          "chain_code": "chain_code_example"
        }
      },
      "coin_identifier": {
        "identifier": "0x2f23fd8cca835af21f3ac375bac601f97ead75f2e79143bdf71fe2c4be043e8f:1"
      },
      "currency": {
        "symbol": "BTC",
        "decimals": 8,
        "metadata": {}
      },
      "status": "reverted",
      "type": "transfer",
      "address": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
      "success": true
    }),
});

const data = await response.json();

import requests

payload = {
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "operator": "or",
  "max_block": 5,
  "offset": 5,
  "limit": 5,
  "transaction_identifier": {
    "hash": "0x2f23fd8cca835af21f3ac375bac601f97ead75f2e79143bdf71fe2c4be043e8f"
  },
  "account_identifier": {
    "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
    "sub_account": {
      "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "metadata": {}
    },
    "metadata": {
      "chain_code": "chain_code_example"
    }
  },
  "coin_identifier": {
    "identifier": "0x2f23fd8cca835af21f3ac375bac601f97ead75f2e79143bdf71fe2c4be043e8f:1"
  },
  "currency": {
    "symbol": "BTC",
    "decimals": 8,
    "metadata": {}
  },
  "status": "reverted",
  "type": "transfer",
  "address": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
  "success": True
}

response = requests.post('https://ada-blockfrost.nownodes.io/search/transactions', json=payload)
data = response.json()

Request Body

{
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "operator": "or",
  "max_block": 5,
  "offset": 5,
  "limit": 5,
  "transaction_identifier": {
    "hash": "0x2f23fd8cca835af21f3ac375bac601f97ead75f2e79143bdf71fe2c4be043e8f"
  },
  "account_identifier": {
    "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
    "sub_account": {
      "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "metadata": {}
    },
    "metadata": {
      "chain_code": "chain_code_example"
    }
  },
  "coin_identifier": {
    "identifier": "0x2f23fd8cca835af21f3ac375bac601f97ead75f2e79143bdf71fe2c4be043e8f:1"
  },
  "currency": {
    "symbol": "BTC",
    "decimals": 8,
    "metadata": {}
  },
  "status": "reverted",
  "type": "transfer",
  "address": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
  "success": true
}

{
  "transactions": [
    {
      "block_identifier": {
        "index": 13646894,
        "hash": "9945cd69ca8e6bcf2e5f9a14742be0c051bf9dd916f0bb0b00ab39977b140d53"
      },
      "transaction": {
        "transaction_identifier": {
          "hash": "04cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650"
        }
      }
    }
  ],
  "total_count": 1
}

{
  "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"
}