Skip to main content

Get a swap

GEThttps://api.radom.com/swap/{id}

Returns the details of a single swap belonging to your organization.

Authorization

Send your API key in the Authorization header. Scheme: radomToken.

Parameters

idstring<uuid>pathrequired

Responses

200Swap retrieved successfully
idstring<uuid>required
statusSwapStatusrequired
AllowedPendingInitiatedFailedFinalized
orgIdstring<uuid>required
swapSettingsIdstring<uuid>nullable
externalIdstringnullable
fromNetworkNetworkrequired
AllowedBitcoinBitcoinTestnetLitecoinLitecoinTestnetDogecoinDogecoinTestnetBitcoinCashBitcoinCashTestnetBitcoinSVBitcoinSVTestnetHarryPotterObamaSonic10InuHarryPotterObamaSonic10InuTestnetSolanaSolanaTestnetSolanaDevnetEthereumSepoliaTestnetPolygonPolygonTestnetBNBBNBTestnetArbitrumArbitrumTestnetPolkadotPolkadotTestnetPolkadotAssetHubPolkadotAssetHubTestnetTronTronTestnetAvalancheAvalancheTestnetBaseBaseTestnetOptimismOptimismTestnetOpBnbFiat
fromTokenstringnullable
fromAmountstringrequired
fromTransactionIdstring<uuid>nullable
fromTxidstringnullable
toNetworkNetworkrequired
AllowedBitcoinBitcoinTestnetLitecoinLitecoinTestnetDogecoinDogecoinTestnetBitcoinCashBitcoinCashTestnetBitcoinSVBitcoinSVTestnetHarryPotterObamaSonic10InuHarryPotterObamaSonic10InuTestnetSolanaSolanaTestnetSolanaDevnetEthereumSepoliaTestnetPolygonPolygonTestnetBNBBNBTestnetArbitrumArbitrumTestnetPolkadotPolkadotTestnetPolkadotAssetHubPolkadotAssetHubTestnetTronTronTestnetAvalancheAvalancheTestnetBaseBaseTestnetOptimismOptimismTestnetOpBnbFiat
toTokenstringnullable
toTransactionIdstring<uuid>nullable
toTxidstringnullable
toAmountstringnullable
swapFeestringnullable
failReasonstringnullable
providerSwapProviderrequired
AllowedFixedFloatOKXPegasusSwapBastionScrypt
createdAtstring<date-time>required
updatedAtstring<date-time>required
fundsAvailableboolean

True once the destination balance has been credited — for instantly settled conversions that happens at confirmation, before the provider legs finish. Populated by the transactions manager, not stored.

401Unauthorized
errorstringrequired
404Not Found
errorstringrequired
500Internal server error
errorstringrequired