Get Transaction Status

Get transaction status and the metadata of the transaction.

Be aware that this endpoint only fetches transactions that were recently landed on the chain. Depending on the level of activities on the chain, this endpoint may be able to get transactions as far as serval hours. Fetching older transactions may return the status 'not_found'.

Request

Method:

GET ./api/v2/transaction

Parameters:

Parameter	Type	Description
signature	string	Signature of a Solana transaction.

Request example:

HTTP

curl --header "Authorization: $AUTH_HEADER" \
'https://ny.solana.dex.blxrbdn.com/api/v2/transaction?signature='...'

Response:

Fields:

Fields	Type	Description
status	string	Status of target transaction. Expected value "not_found", "success", and "failed".
metadata	TransactionMeta	The metadata of the transaction. See below for more details
slot	uint64	Slot in which the transaction is included
block_time	uint64	Time at which transaction landed on chain
version	int32	Version of the transaction (represents either Legacy or Version)

TransactionMeta

Parameter		Description
err	string	description of error in transaction
errored	uint64	did transaction error?
fee	uint64	transaction fee
pre_balances	uint64	balance in wallet before transaction
post_balances	uint64	balance in wallet after transaction
inner_instructions	[] TransactionMetaInnerInstruction	inner instructions inside of transaction
log_messages	string	any logs related to transaction
pre_token_balances	[] TransactionMetaTokenBalance	token balances in wallet before transaction
post_token_balances	[] TransactionMetaTokenBalance	token balances in wallet after transaction

Response Example:

JSON

# Signature has not been found
{
  "status":"not_found", 
  "metadata":{"err":"tx not found", "errored":true}
}

# Transaction is successfully landed on chain
{
  "status":"success",
  "metadata":{"preBalances":...},
  "slot":"242622328",
  "blockTime":"1705605064",
  "version":-1
}

# Transaction is failed
{
  "status":"failed", 
  "metadata":{"err":"tx not found", "errored":false...}
}