Skip to content
SwapKit is a powerful suite of tools for building blockchain applications.

/track

POST
/track

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
forceUpdate
string

Request Body

Section titled “Request Body ”
object
hash

Hash for the first transaction broadcasted by the end user. e.g. 88D1819378ECD09E5284C54937CDC1E99B52F253C007617A02DD1200710CE677

string
chainId

ChainId for the hash. e.g. thorchain-1

string
block

Block number. Required for Polkadot chain. e.g. 123456

number
depositChannelId

Deposit channel ID, required for Chainflip if tx was broadcasted without wallet connection

string
depositAddress

Deposit address associated with a deposit channel

string

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Default Response

object
chainId
required
string
Allowed values: 42161 1313161554 43114 8453 80094 56 bitcoin bitcoincash 3637 cardano chainflip 1116 21000000 cosmoshub-4 25 dash dogecoin 1 100 harbor-1 harbor-stagenet-1 2868 kaiyo-1 litecoin mayachain-mainnet-v1 mayachain-stagenet-v1 near noble-1 10 polkadot 137 radix-mainnet ripple solana 146 sui thorchain-1 thorchain-stagenet-v2 ton 728126428 130 196 zcash
hash
required
string
block
required
number
type
required
string
Allowed values: approve claim deposit lending lp_action native_contract_call native_send stake unstake streaming_swap swap thorname_action token_contract_call token_transfer unknown donate
status
required
string
Allowed values: unknown not_started pending swapping completed refunded failed
trackingStatus
string
Allowed values: not_started starting broadcasted mempool inbound outbound swapping completed refunded partially_refunded dropped reverted replaced retries_exceeded parsing_error
fromAsset
required
string
fromAmount
required
string
fromAddress
required
string
toAsset
required
string
toAmount
required
string
toAddress
required
string
finalAsset
object
chain
required
string
Allowed values: ARB AURORA AVAX BASE BERA BSC ADA BOTANIX CORE CORN CRO BTC BCH GAIA DASH DOGE ETH GNO HARBOR HYPEREVM KUJI SONIC UNI XLAYER LTC MAYA NEAR NOBLE OP DOT FLIP POL XRD XRP THOR SOL SUI TON TRON ZEC
symbol
required
string
ticker
required
string
decimal
number
address
string
isGasAsset
required
boolean
isSynthetic
required
boolean
tax
object
buy
required
number
sell
required
number
finalAddress
string
finalisedAt
required
number
transient
object
estimatedTimeToComplete
required
number
currentLegIndex
number
estimates
object
inboundObservation
required
number
inboundConfirmation
required
number
streamingSwap
required
number
outboundDelay
required
number
outboundObservation
required
number
currentStage
required
string
providerDetails
object
streamingDetails
object
quantity
number
count
number
interval
number
subSwapsMap
Array<number>
depositChannelId
string
meta
object
broadcastedAt
number
wallet
string
quoteId
string
explorerUrl
string
affiliate
string
fees
object
network
object
chain
required
string
Allowed values: ARB AURORA AVAX BASE BERA BSC ADA BOTANIX CORE CORN CRO BTC BCH GAIA DASH DOGE ETH GNO HARBOR HYPEREVM KUJI SONIC UNI XLAYER LTC MAYA NEAR NOBLE OP DOT FLIP POL XRD XRP THOR SOL SUI TON TRON ZEC
symbol
required
string
ticker
required
string
decimal
number
address
string
isGasAsset
required
boolean
isSynthetic
required
boolean
tax
object
buy
required
number
sell
required
number
affiliate
object
chain
required
string
Allowed values: ARB AURORA AVAX BASE BERA BSC ADA BOTANIX CORE CORN CRO BTC BCH GAIA DASH DOGE ETH GNO HARBOR HYPEREVM KUJI SONIC UNI XLAYER LTC MAYA NEAR NOBLE OP DOT FLIP POL XRD XRP THOR SOL SUI TON TRON ZEC
symbol
required
string
ticker
required
string
decimal
number
address
string
isGasAsset
required
boolean
isSynthetic
required
boolean
tax
object
buy
required
number
sell
required
number
liquidity
object
chain
required
string
Allowed values: ARB AURORA AVAX BASE BERA BSC ADA BOTANIX CORE CORN CRO BTC BCH GAIA DASH DOGE ETH GNO HARBOR HYPEREVM KUJI SONIC UNI XLAYER LTC MAYA NEAR NOBLE OP DOT FLIP POL XRD XRP THOR SOL SUI TON TRON ZEC
symbol
required
string
ticker
required
string
decimal
number
address
string
isGasAsset
required
boolean
isSynthetic
required
boolean
tax
object
buy
required
number
sell
required
number
protocol
object
chain
required
string
Allowed values: ARB AURORA AVAX BASE BERA BSC ADA BOTANIX CORE CORN CRO BTC BCH GAIA DASH DOGE ETH GNO HARBOR HYPEREVM KUJI SONIC UNI XLAYER LTC MAYA NEAR NOBLE OP DOT FLIP POL XRD XRP THOR SOL SUI TON TRON ZEC
symbol
required
string
ticker
required
string
decimal
number
address
string
isGasAsset
required
boolean
isSynthetic
required
boolean
tax
object
buy
required
number
sell
required
number
tax
object
chain
required
string
Allowed values: ARB AURORA AVAX BASE BERA BSC ADA BOTANIX CORE CORN CRO BTC BCH GAIA DASH DOGE ETH GNO HARBOR HYPEREVM KUJI SONIC UNI XLAYER LTC MAYA NEAR NOBLE OP DOT FLIP POL XRD XRP THOR SOL SUI TON TRON ZEC
symbol
required
string
ticker
required
string
decimal
number
address
string
isGasAsset
required
boolean
isSynthetic
required
boolean
tax
object
buy
required
number
sell
required
number
provider
string
Allowed values: CHAINFLIP CHAINFLIP_STREAMING MAYACHAIN MAYACHAIN_STREAMING ONEINCH PANCAKESWAP PANGOLIN_V1 SUSHISWAP_V2 THORCHAIN THORCHAIN_STREAMING TRADERJOE_V2 UNISWAP_V2 UNISWAP_V3 CAVIAR_V1 JUPITER CAMELOT_V3 OCISWAP_V1 OPENOCEAN_V2 OKX NEAR GARDEN HARBOR
providerAction
string
Allowed values: swap aggregation addLiquidity withdrawLiquidity addSavers withdrawSavers borrow repay name donate claim stake unstake
images
object
from
string
to
string
provider
string
chain
string
affiliateFees
Array<object>
object
affiliate
required
string
bps
required
string
isReferrer
required
boolean
payload
object
evmCalldata
string
logs
memo
string
spender
string
manifest
intentHash
string
thorname
string
legs
required
Array<object>
object
chainId
required
string
Allowed values: 42161 1313161554 43114 8453 80094 56 bitcoin bitcoincash 3637 cardano chainflip 1116 21000000 cosmoshub-4 25 dash dogecoin 1 100 harbor-1 harbor-stagenet-1 2868 kaiyo-1 litecoin mayachain-mainnet-v1 mayachain-stagenet-v1 near noble-1 10 polkadot 137 radix-mainnet ripple solana 146 sui thorchain-1 thorchain-stagenet-v2 ton 728126428 130 196 zcash
hash
required
string
block
required
number
type
required
string
Allowed values: approve claim deposit lending lp_action native_contract_call native_send stake unstake streaming_swap swap thorname_action token_contract_call token_transfer unknown donate
status
required
string
Allowed values: unknown not_started pending swapping completed refunded failed
trackingStatus
string
Allowed values: not_started starting broadcasted mempool inbound outbound swapping completed refunded partially_refunded dropped reverted replaced retries_exceeded parsing_error
fromAsset
required
string
fromAmount
required
string
fromAddress
required
string
toAsset
required
string
toAmount
required
string
toAddress
required
string
finalAsset
object
chain
required
string
Allowed values: ARB AURORA AVAX BASE BERA BSC ADA BOTANIX CORE CORN CRO BTC BCH GAIA DASH DOGE ETH GNO HARBOR HYPEREVM KUJI SONIC UNI XLAYER LTC MAYA NEAR NOBLE OP DOT FLIP POL XRD XRP THOR SOL SUI TON TRON ZEC
symbol
required
string
ticker
required
string
decimal
number
address
string
isGasAsset
required
boolean
isSynthetic
required
boolean
tax
object
buy
required
number
sell
required
number
finalAddress
string
finalisedAt
required
number
transient
object
estimatedTimeToComplete
required
number
currentLegIndex
number
estimates
object
inboundObservation
required
number
inboundConfirmation
required
number
streamingSwap
required
number
outboundDelay
required
number
outboundObservation
required
number
currentStage
required
string
providerDetails
object
streamingDetails
object
quantity
number
count
number
interval
number
subSwapsMap
Array<number>
depositChannelId
string
meta
object
broadcastedAt
number
wallet
string
quoteId
string
explorerUrl
string
affiliate
string
fees
object
network
object
chain
required
string
Allowed values: ARB AURORA AVAX BASE BERA BSC ADA BOTANIX CORE CORN CRO BTC BCH GAIA DASH DOGE ETH GNO HARBOR HYPEREVM KUJI SONIC UNI XLAYER LTC MAYA NEAR NOBLE OP DOT FLIP POL XRD XRP THOR SOL SUI TON TRON ZEC
symbol
required
string
ticker
required
string
decimal
number
address
string
isGasAsset
required
boolean
isSynthetic
required
boolean
tax
object
buy
required
number
sell
required
number
affiliate
object
chain
required
string
Allowed values: ARB AURORA AVAX BASE BERA BSC ADA BOTANIX CORE CORN CRO BTC BCH GAIA DASH DOGE ETH GNO HARBOR HYPEREVM KUJI SONIC UNI XLAYER LTC MAYA NEAR NOBLE OP DOT FLIP POL XRD XRP THOR SOL SUI TON TRON ZEC
symbol
required
string
ticker
required
string
decimal
number
address
string
isGasAsset
required
boolean
isSynthetic
required
boolean
tax
object
buy
required
number
sell
required
number
liquidity
object
chain
required
string
Allowed values: ARB AURORA AVAX BASE BERA BSC ADA BOTANIX CORE CORN CRO BTC BCH GAIA DASH DOGE ETH GNO HARBOR HYPEREVM KUJI SONIC UNI XLAYER LTC MAYA NEAR NOBLE OP DOT FLIP POL XRD XRP THOR SOL SUI TON TRON ZEC
symbol
required
string
ticker
required
string
decimal
number
address
string
isGasAsset
required
boolean
isSynthetic
required
boolean
tax
object
buy
required
number
sell
required
number
protocol
object
chain
required
string
Allowed values: ARB AURORA AVAX BASE BERA BSC ADA BOTANIX CORE CORN CRO BTC BCH GAIA DASH DOGE ETH GNO HARBOR HYPEREVM KUJI SONIC UNI XLAYER LTC MAYA NEAR NOBLE OP DOT FLIP POL XRD XRP THOR SOL SUI TON TRON ZEC
symbol
required
string
ticker
required
string
decimal
number
address
string
isGasAsset
required
boolean
isSynthetic
required
boolean
tax
object
buy
required
number
sell
required
number
tax
object
chain
required
string
Allowed values: ARB AURORA AVAX BASE BERA BSC ADA BOTANIX CORE CORN CRO BTC BCH GAIA DASH DOGE ETH GNO HARBOR HYPEREVM KUJI SONIC UNI XLAYER LTC MAYA NEAR NOBLE OP DOT FLIP POL XRD XRP THOR SOL SUI TON TRON ZEC
symbol
required
string
ticker
required
string
decimal
number
address
string
isGasAsset
required
boolean
isSynthetic
required
boolean
tax
object
buy
required
number
sell
required
number
provider
string
Allowed values: CHAINFLIP CHAINFLIP_STREAMING MAYACHAIN MAYACHAIN_STREAMING ONEINCH PANCAKESWAP PANGOLIN_V1 SUSHISWAP_V2 THORCHAIN THORCHAIN_STREAMING TRADERJOE_V2 UNISWAP_V2 UNISWAP_V3 CAVIAR_V1 JUPITER CAMELOT_V3 OCISWAP_V1 OPENOCEAN_V2 OKX NEAR GARDEN HARBOR
providerAction
string
Allowed values: swap aggregation addLiquidity withdrawLiquidity addSavers withdrawSavers borrow repay name donate claim stake unstake
images
object
from
string
to
string
provider
string
chain
string
affiliateFees
Array<object>
object
affiliate
required
string
bps
required
string
isReferrer
required
boolean
payload
object
evmCalldata
string
logs
memo
string
spender
string
manifest
intentHash
string
thorname
string