Check TX Status

post https://api.rango.exchange/tx/check-status

After that user signed a transaction on his/her wallet you should call this endpoint periodically to see that transaction's status.

Responses

Response body

object

status

string

Status of the transaction, while the status is running, client should retry the check status

running failed success

extraMessage

string

A message in case of failure, that can be shown to user

failedType

string

type of failure

TX_FAIL UNKNOWN GENERAL_SERVER_ERROR FETCH_TX_FAILED USER_REJECT USER_CANCEL CALL_WALLET_FAILED SEND_TX_FAILED CLIENT_UNEXPECTED_BEHAVIOUR TX_EXPIRED INSUFFICIENT_APPROVE USER_CANCELED_TX CALL_OR_SEND_FAILED TX_FAILED_IN_BLOCKCHAIN PREREQUISITE_FAILED WALLET_NOT_FOUND INVALID_WALLET FAILED_IN_ROUTING CREATE_TX_NOT_ALLOWED TOO_MANY_REQUEST IBC_TIMEOUT INVALID_INFORMATION_TO_ACCESS PRICE_CHANGE LOW_INPUT_VS_FEE CREATION_FAILED NULL_VARIABLE_VALUE INVALID_STATE RUNNING_CHECK_STATUS INTERNAL_ERROR VALIDATION_ERROR INPUT_LIMIT_EXCEED HIGH_IMPACT_ERROR ESTIMATION_BIG_DIFFERENCE_ERROR MISS_CONFIGURATION EXPIRED_ROUTE CALCULATION_EXCEPTION THIRD_PARTY_EXCEPTION INTERNAL_SWAPPER_EXCEPTION FEE_ESTIMATION INSUFFICIENT_LIQUIDITY BALANCE_EXCEPTION NO_ROUTE_EXCEPTION AFFILIATE_LOGIN_EXCEPTION REFERRER_ERROR NO_CACHED_REQUEST_EXCEPTION NOT_FOUND_IN_BLOCKCHAIN NOT_FOUND_IN_RANGO PRE_TRANSFER_FAILED TX_DATA_PROBLEM SOURCE_FAILED SOURCE_FAILED_AND_REFUNDED DESTINATION_FAILED DESTINATION_FAILED_AND_REFUNDED DESTINATION_DEX_FAILED KYC_REQUIRED METHOD_NOT_IMPLEMENTED EXPIRED WRONG_TX_HASH MANUAL_REFUND MAX_RETRY_REACHED TOKEN_NOT_FOUND AUTHENTICATION NOT_SUPPORTED_BLOCKCHAIN PARTIALLY_REFUNDED

timestamp

int64

The timestamp of the final executed transaction. Beware that timestamp can be null even if the status is successful or failed

outputAmount

number

The output amount of the transaction if it was successful

explorerUrl

array of objects

List of explorer urls for the transactions that happened in this step.

explorerUrl

object

url

string

required

Url of the transaction in bscscan/harmony explorer/plygonscan/etc.

description

string

A custom display name to help user distinguish the transactions from eachother. Ex: Inbound, Outbound, Bridge, or null

referrals

array of objects

List of referral reward for the dApp and Rango

referrals

object

amount

integer

required

The machine-readable amount of the reward

blockChain

string

required

The blockchain that reward is generated in

ETH BSC ARBITRUM POLYGON ZKSYNC STARKNET OPTIMISM AVAX_CCHAIN POLYGONZK BASE LINEA MODE TON TRON BTC SCROLL BLAST COSMOS OSMOSIS NEUTRON NOBLE DYDX SOLANA CRONOS BNB FANTOM AURORA MAYA THOR BOBA MOONBEAM MOONRIVER OKC BOBA_BNB BOBA_AVALANCHE LTC BCH HARMONY EVMOS HECO METIS SIF BRISE STARGAZE FUSE CRYPTO_ORG CHIHUAHUA BANDCHAIN COMDEX REGEN IRIS EMONEY GNOSIS JUNO AXELAR STRIDE KCC MARS TERRA TELOS BITSONG AKASH KI PERSISTENCE MEDIBLOC KUJIRA SENTINEL INJECTIVE SECRET KONSTELLATION STARNAME BITCANNA UMEE DESMOS LUMNETWORK TERRA_CLASSIC CELO DASH SHIMMER XLAYER IOTA SUI TAIKO POLKADOT DOGE GOERLI GOERLI_ARBITRUM GOERLI_OPTIMISM SEPOLIA SEPOLIA_ARBITRUM SEPOLIA_OPTIMISM ZORA SONIC BERACHAIN

symbol

string

The symbol of the asset that is rewarded

address

string

The smart contract address of rewarded asset, null for native assets

decimals

int32

The decimals of the rewarded asset

newTx

diagnosisUrl

string

In some special cases [ex: AnySwap], user should follow some steps outside Rango to get its assets. You can show this to user as help

steps

array of objects

In some special cases [ex: Wormhole Bridge], user should sign multiple transactions for a step to succeed. in such cases you can use steps data and show internal steps of one swap to user

steps

object

name

string

required

The step name

state

string

required

Show the step state. e.g., PENDING, FAILED, etc.

PENDING CREATED WAITING SIGNED SUCCESSED FAILED

current

boolean

required

Show whether the swap is in this state or not.

outputToken

object

All metadata of a token, unique by (blockchain, symbol, address) tuple

blockchain

string

required

The blockchain which this token belongs to

symbol

string

required

The display symbol, e.g. USDT, BTC, etc.

image

string

required

Url of its image

address

string

Smart contract address of token, null for native tokens

usdPrice

double

USD unit price of this token if available

decimals

int32

Decimals of token in blockchain

name

string

Display name of token, e.g: Cardano for ADA. It can be null

isPopular

boolean

required

If true, means that the token is popular token on the blockchain

isSecondaryCoin

boolean

required

If true, means that the token's trading is high risk. Better to warn user before proceeding

coinSource

string

If the token is secondary, coinSource indicates the third-party list that Rango found this token in

coinSourceUrl

string

The url of the list that token was extracted from

supportedSwappers

array of strings

required

Supported swappers for this token

supportedSwappers*

outputType

string

Specifies the type of received output token

REVERTED_TO_INPUT MIDDLE_ASSET_IN_SRC MIDDLE_ASSET_IN_DEST DESIRED_OUTPUT

bridgeExtra

object

requireRefundAction

boolean

required

srcTx

string

destTx

string

error

string

Error occurred during operation

errorCode

int32

Error code show error type in rango

traceId

int32

Trace id help Rango support to resolve the issue

400

Bad client request

403

Forbidden

429

Too many requests

500

Internal error

Language

Credentials

Query


xxxxxxxxxx
1
curl --request POST \
2
     --url 'https://api.rango.exchange/tx/check-status?apiKey=c6381a79-2817-4602-83bf-6a641a409e32' \
3
     --header 'accept: */*' \
4
     --header 'content-type: application/json'

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

*/*

200OK

404Not Found