[INDEXER] Search for Transactions

POST

https://ada.nownodes.io/search/transactions

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

CHANGELOG — Cardano Rosetta Java 2.3.3 → 2.4.0 Breaking response content: omit zero-value script-withdrawal reward operations; transactions[].transaction.operations may have fewer entries and shifted indexes. Describe operations in the response schema, previously missing from this page.

/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.

Version 2.4.0 (breaking response-content change): Cardano Rosetta Java 2.4.0: zero-value script withdrawals are omitted from the transaction operations array (no reward-withdrawal operation is emitted for them). The array may therefore contain fewer operations than in 2.3.3, and subsequent operation_identifier.index values may shift. Non-zero withdrawals remain represented.

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

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

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

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.

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.

[INDEXER] Search for Transactions

curl -X POST 'https://ada.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.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();

require 'net/http'
require 'json'

uri = URI('https://ada.nownodes.io/search/transactions')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/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
  }'

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

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.nownodes.io/search/transactions', json=payload)
data = response.json()

const response = await fetch('https://ada.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();

const endpoint = "https://ada.nownodes.io/search/transactions";
const apiKey = "YOUR_API_KEY";

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

  return response.json();
}

const result = await nownodesRequest({
    "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
  });
console.log(result);

const response = await fetch('https://ada.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.nownodes.io/search/transactions', json=payload)
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://ada.nownodes.io/search/transactions')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/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
  }'

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

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