[INDEXER] Search for Transactions

post https://rpc.chain49.com/cardano/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 Params

network_identifier

object

required

The network_identifier specifies which network a particular object is associated with.

operator

string

Operator is used by query-related endpoints to determine how to apply conditions. If this field is not populated, the default and value will be used.

max_block

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

offset

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.

limit

int64

≥ 0

limit is the maximum number of transactions to return in one call. The implementation may return <= limit transactions.

transaction_identifier

object

The transaction_identifier uniquely identifies a transaction in a particular network and block or in the mempool.

account_identifier

object

The account_identifier uniquely identifies an account within a network. All fields in the account_identifier are utilized to determine this uniqueness (including the metadata field, if populated).

coin_identifier

object

CoinIdentifier uniquely identifies a Coin.

currency

object

Currency is composed of a canonical Symbol and Decimals. This Decimals value is used to convert an Amount.Value from atomic units (Satoshis) to standard units (Bitcoins).

status

string

status is the network-specific operation type.

type

string

type is the network-specific operation type.

address

string

address is AccountIdentifier.Address. This is used to get all transactions related to an AccountIdentifier.Address, regardless of SubAccountIdentifier.

success

boolean

success is a synthetic condition populated by parsing network-specific operation statuses (using the mapping provided in /network/options).

Responses

Language

Credentials

Header

URL


xxxxxxxxxx
12
1
curl --request POST \
2
     --url https://rpc.chain49.com/cardano/search/transactions \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "network_identifier": {
8
    "blockchain": "cardano",
9
    "network": "mainnet"
10
  }
11
}
12
'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Expected response to a valid request

500unexpected error