Transaction

The underlying partner bridge or route taken for this Transaction whether it's a cross-chain swap/transfer or single-chain swap

bridge
txId
string

Internal unique identifier used by underlying bridge. Not guaranteed to be the transaction hash. For celer this is the transferId.

status
string
required

The main status of the transaction from start to finish

Allowed values:
SubmittedPending Source ChainPending Destination ChainCompletedRefund RequiredRefundedFailed Source ChainFailed Destination ChainFallbackNot SentClaim Required
Example:
Submitted
integration
string

Name of the underlying contract integration associated with this quote. Bridges, DEXs, Staking Providers, and Lending Protocols

type
string

Category of transaction including contract-call execution type

Allowed values:
swapcustom_contractdepositwithdrawclaim
needClaim
boolean

If true, need to call /claim endpoint to claim token on the destination chain for this specific transaction.

refundReason
string

If transaction is in a refund state, this will reflect additional information about the state of the refund

Example:
BAD_LIQUIDITY
errorReason
string

If transaction is in a failed state, this will reflect additional information about the reason for the failure

fromTokenAddress
string

Token Address of sending token on the source chain

fromChainId
number

Chain ID of the source chain

fromChainSlug
string

Chain slug of the source chain

Example:
ethereum
fromAmount
string

Initial token amount sent from the source chain

fromAmountUsdValue
string

Initial token amount sent from the source chain (in $USD)

toTokenAddress
string

Token Address of receiving token on the destination chain

toChainId
number

Chain ID of the destination chain

toChainSlug
string

Chain slug of the destination chain

Example:
ethereum
toAmount
string

Final token amount deposited into the destination chain

toAmountUsdValue
string

Final token amount deposited into the destination chain (in $USD)

fromChainTxHash
string

The transaction hash returned from the source chain

toChainTxHash
string

The transaction hash on the destination chain

fromTokenSymbol
string

Token symbol of the sending token on the source chain

toTokenSymbol
string

Token symbol of the receiving token on the destination chain

fromUserAddress
string

The source address for the transaction

toUserAddress
string

The destination address for the transaction

txStartedTimestamp
number

Unix timestamp of when the transaction was first initiated

txCompletedTimestamp
number

Unix timestamp of when the Transaction was completed

updatedAt
string
createdAt
string
fallbackTokenAddress
string

The final token address fallbacks into the destination chain

fallbackAmount
string

The final token amount fallbacks into the destination chain

id
number

Swing Unique Identifier for this transaction. Can be used as a reference ID in support inquiries.

projectId
string

Associated Swing Project Id with this transaction

Example
preparing...