Transaction

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

bridge

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

affiliateId

string

Associated Affiliate Partner Id with this transaction

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

fallbackTokenAddress

string

The final token address fallbacks into the destination chain

fallbackAmount

string

The final token amount fallbacks into the destination chain

contractCall

boolean

toContractCallAddress

string

toContractCallData

string

toContractCallTokenAddress

string

toContractCallApprovalAddress

string

toContractCallGasLimit

string

destinationTxFee

string

destinationTxFeeUsdValue

string

bridgeFee

string

bridgeFeeUsdValue

string

bridgeFeeInNativeTokenUsdValue

string

bridgeFeeInNativeToken

string

bridgeTokenAddress

string

bridgeTokenSymbol

string

bridgeAmount

string

bridgeAmountUsdValue

string

gasUsage

string

gasUsageUsdValue

string

partnerShare

string

partnerShareUsdValue

string

swingShare

string

swingShareUsdValue

string

updatedAt

string

createdAt

string

flatFeeShare

string

flatFeeShareUsdValue

string

percentageFeeShare

string

percentageFeeShareUsdValue

string

Example

preparing...