--- title: "Get deposit address history" method: GET path: "/deposit-addresses/{depositAddress}/{depositChain}/history" tags: ["depositAddresses"] --- # Get deposit address history `GET /deposit-addresses/{depositAddress}/{depositChain}/history` Returns the history of a deposit address on a given chain. This includes all accepted (with precise history), failed, and rejected bridge transactions. ## Path parameters - `depositAddress` union, required - string — a string that will be trimmed - string — Tron basic address format - string - string - `depositChain` string, required ## Query parameters - `from` string — Start date for the history query, in milliseconds since epoch or Date.parse compatible string. Optional, defaults to 7 days ago. Max window is 31 days - `to` string — Start date for the history query, in milliseconds since epoch or Date.parse compatible string. Optional, defaults to 7 days ago. Max window is 31 days ## Response `200` DepositAddressHistoryResponse - DepositAddressHistoryResponse - `depositAddress` string, required — The deposit address for which history is being retrieved. - `depositChain` string, required — The blockchain network identifier of the deposit address. - `bridges` union[], required — Array of bridge transactions associated with this deposit address, including accepted, failed, and rejected transactions. - union - DepositAddressBridgeFailedApi - `_id` string, required — a non empty string - `tokenSymbol` string, required — a non empty string - `tokenAddress` string, required — a non empty string - `amount` string, required — A value representing the human readable, normalized transaction amount or balance - `amountUsd` number, required — a number to be decoded into a BigDecimal - `amountWei` string, required — a string to be decoded into a bigint - `sender` string, required — a non empty string - `txHash` string, required — a non empty string - `originalErrorTag` string — a non empty string - `createdAt` string, required — a string to be decoded into a DateTime.Utc - `_tag` 'failed', required - DepositAddressBridgeRejectedApi - `_id` string, required — a non empty string - `tokenSymbol` string, required — a non empty string - `tokenAddress` string, required — a non empty string - `amount` string, required — A value representing the human readable, normalized transaction amount or balance - `amountUsd` number, required — a number to be decoded into a BigDecimal - `amountWei` string, required — a string to be decoded into a bigint - `sender` string, required - `txHash` string, required - `originalErrorTag` string — a non empty string - `originalErrorJson` string - `reason` 'OVER_MAX' | 'UNDER_MIN' | 'OPERATION_UNAVAILABLE' | 'TERMINAL_PROCESSING_ISSUE' | 'NO_ROUTE_FOUND' | 'UNSUPPORTED_TOKEN' | 'SDA_PAUSED', required - `txUid` string, required — a non empty string - `createdAt` string, required — a string to be decoded into a DateTime.Utc - `blockNumber` integer — an integer - `_tag` 'rejected', required - DepositAddressBridgeAcceptedApi - `_id` string, required — a non empty string - `tokenSymbol` string, required — a non empty string - `tokenAddress` string, required — a non empty string - `amount` string, required — A value representing the human readable, normalized transaction amount or balance - `amountUsd` number, required — a number to be decoded into a BigDecimal - `amountWei` string, required — a string to be decoded into a bigint - `sender` string, required — a non empty string - `txHash` string, required — a non empty string - `history` union, required - object - `_tag` 'depositAddressBridge', required - `_id` string, required - `userId` string, required - `chainIn` string, required - `chainOut` string, required - `amountIn` string, required — a string to be decoded into a BigDecimal - `amountInUsd` number, required — a number to be decoded into a BigDecimal - `amountOut` string, required — a string to be decoded into a BigDecimal - `amountOutUsd` number, required — a number to be decoded into a BigDecimal - `amountNative` string, required — a string to be decoded into a BigDecimal - `amountNativeUsd` number, required — a number to be decoded into a BigDecimal - `fee` string, required — a string to be decoded into a BigDecimal - `feeUsd` number, required — a number to be decoded into a BigDecimal - `gasFee` string, required — a string to be decoded into a BigDecimal - `gasFeeUsd` number, required — a number to be decoded into a BigDecimal - `platformFee` string, required — a string to be decoded into a BigDecimal - `platformFeeUsd` number, required — a number to be decoded into a BigDecimal - `percentageFee` string, required — a string to be decoded into a BigDecimal - `percentageFeeUsd` number, required — a number to be decoded into a BigDecimal - `sourceGasFee` string, required — a string to be decoded into a BigDecimal - `sourceGasFeeUsd` number, required — a number to be decoded into a BigDecimal - `sponsoredFees` object, required - … - `recipient` string, required - `depositor` string, required - `createdAt` string, required — a string to be decoded into a Date - `commitmentDate` string, required — a string to be decoded into a Date - `speed` 'fast' | 'standard' | 'slow' - `estimatedDuration` number — a non-negative number to be decoded into a Duration - `postBridgeData` union - … - `flowCredits` number — a number to be decoded into a BigDecimal - `token` string, required - `tokenOut` string - `usdPrice` number, required — a number to be decoded into a BigDecimal - `depositAddress` string - `preSwap` SwapQuote - … - `postSwap` SwapQuote - … - `state` 'PENDING', required - object - `_tag` 'depositAddressBridge', required - `_id` string, required - `userId` string, required - `chainIn` string, required - `chainOut` string, required - `amountIn` string, required — a string to be decoded into a BigDecimal - `amountInUsd` number, required — a number to be decoded into a BigDecimal - `amountOut` string, required — a string to be decoded into a BigDecimal - `amountOutUsd` number, required — a number to be decoded into a BigDecimal - `amountNative` string, required — a string to be decoded into a BigDecimal - `amountNativeUsd` number, required — a number to be decoded into a BigDecimal - `fee` string, required — a string to be decoded into a BigDecimal - `feeUsd` number, required — a number to be decoded into a BigDecimal - `gasFee` string, required — a string to be decoded into a BigDecimal - `gasFeeUsd` number, required — a number to be decoded into a BigDecimal - `platformFee` string, required — a string to be decoded into a BigDecimal - `platformFeeUsd` number, required — a number to be decoded into a BigDecimal - `percentageFee` string, required — a string to be decoded into a BigDecimal - `percentageFeeUsd` number, required — a number to be decoded into a BigDecimal - `sourceGasFee` string, required — a string to be decoded into a BigDecimal - `sourceGasFeeUsd` number, required — a number to be decoded into a BigDecimal - `sponsoredFees` object, required - … - `recipient` string, required - `depositor` string, required - `createdAt` string, required — a string to be decoded into a Date - `commitmentDate` string, required — a string to be decoded into a Date - `speed` 'fast' | 'standard' | 'slow' - `estimatedDuration` number — a non-negative number to be decoded into a Duration - `postBridgeData` union - … - `flowCredits` number — a number to be decoded into a BigDecimal - `token` string, required - `tokenOut` string - `usdPrice` number, required — a number to be decoded into a BigDecimal - `depositAddress` string - `preSwap` SwapQuote - … - `postSwap` SwapQuote - … - `depositTxHash` string, required - `depositDiscoveredAt` string, required — a string to be decoded into a Date - `expectedDepositConfirmedAt` string, required — a string to be decoded into a Date - `expectedDepositConfirmedAtBlock` integer, required — an integer - `state` 'PENDING_CONFIRMATION', required - object - `_tag` 'depositAddressBridge', required - `_id` string, required - `userId` string, required - `chainIn` string, required - `chainOut` string, required - `amountIn` string, required — a string to be decoded into a BigDecimal - `amountInUsd` number, required — a number to be decoded into a BigDecimal - `amountOut` string, required — a string to be decoded into a BigDecimal - `amountOutUsd` number, required — a number to be decoded into a BigDecimal - `amountNative` string, required — a string to be decoded into a BigDecimal - `amountNativeUsd` number, required — a number to be decoded into a BigDecimal - `fee` string, required — a string to be decoded into a BigDecimal - `feeUsd` number, required — a number to be decoded into a BigDecimal - `gasFee` string, required — a string to be decoded into a BigDecimal - `gasFeeUsd` number, required — a number to be decoded into a BigDecimal - `platformFee` string, required — a string to be decoded into a BigDecimal - `platformFeeUsd` number, required — a number to be decoded into a BigDecimal - `percentageFee` string, required — a string to be decoded into a BigDecimal - `percentageFeeUsd` number, required — a number to be decoded into a BigDecimal - `sourceGasFee` string, required — a string to be decoded into a BigDecimal - `sourceGasFeeUsd` number, required — a number to be decoded into a BigDecimal - `sponsoredFees` object, required - … - `recipient` string, required - `depositor` string, required - `createdAt` string, required — a string to be decoded into a Date - `commitmentDate` string, required — a string to be decoded into a Date - `speed` 'fast' | 'standard' | 'slow' - `estimatedDuration` number — a non-negative number to be decoded into a Duration - `postBridgeData` union - … - `flowCredits` number — a number to be decoded into a BigDecimal - `token` string, required - `tokenOut` string - `usdPrice` number, required — a number to be decoded into a BigDecimal - `depositAddress` string - `preSwap` SwapQuote - … - `postSwap` SwapQuote - … - `depositTxHash` string, required - `depositCommittedAt` string, required — a string to be decoded into a Date - `depositDiscoveredAt` string — a string to be decoded into a Date - `depositConfirmedAt` string — a string to be decoded into a Date - `expectedDepositConfirmedAt` string — a string to be decoded into a Date - `expectedDepositConfirmedAtBlock` integer — an integer - `preSwapTxHash` string - `preSwapCommittedAt` string — a string to be decoded into a Date - `isConfirmed` boolean - `failedAt` string, required — a string to be decoded into a Date - `state` 'FAILED', required - object - `_tag` 'depositAddressBridge', required - `_id` string, required - `userId` string, required - `chainIn` string, required - `chainOut` string, required - `amountIn` string, required — a string to be decoded into a BigDecimal - `amountInUsd` number, required — a number to be decoded into a BigDecimal - `amountOut` string, required — a string to be decoded into a BigDecimal - `amountOutUsd` number, required — a number to be decoded into a BigDecimal - `amountNative` string, required — a string to be decoded into a BigDecimal - `amountNativeUsd` number, required — a number to be decoded into a BigDecimal - `fee` string, required — a string to be decoded into a BigDecimal - `feeUsd` number, required — a number to be decoded into a BigDecimal - `gasFee` string, required — a string to be decoded into a BigDecimal - `gasFeeUsd` number, required — a number to be decoded into a BigDecimal - `platformFee` string, required — a string to be decoded into a BigDecimal - `platformFeeUsd` number, required — a number to be decoded into a BigDecimal - `percentageFee` string, required — a string to be decoded into a BigDecimal - `percentageFeeUsd` number, required — a number to be decoded into a BigDecimal - `sourceGasFee` string, required — a string to be decoded into a BigDecimal - `sourceGasFeeUsd` number, required — a number to be decoded into a BigDecimal - `sponsoredFees` object, required - … - `recipient` string, required - `depositor` string, required - `createdAt` string, required — a string to be decoded into a Date - `commitmentDate` string, required — a string to be decoded into a Date - `speed` 'fast' | 'standard' | 'slow' - `estimatedDuration` number — a non-negative number to be decoded into a Duration - `postBridgeData` union - … - `flowCredits` number — a number to be decoded into a BigDecimal - `token` string, required - `tokenOut` string - `usdPrice` number, required — a number to be decoded into a BigDecimal - `depositAddress` string - `preSwap` SwapQuote - … - `postSwap` SwapQuote - … - `depositTxHash` string, required - `depositCommittedAt` string, required — a string to be decoded into a Date - `depositDiscoveredAt` string — a string to be decoded into a Date - `depositConfirmedAt` string — a string to be decoded into a Date - `expectedDepositConfirmedAt` string — a string to be decoded into a Date - `expectedDepositConfirmedAtBlock` integer — an integer - `preSwapTxHash` string - `preSwapCommittedAt` string — a string to be decoded into a Date - `isConfirmed` boolean - `state` 'DEPOSIT_ACCEPTED', required - object - `_tag` 'depositAddressBridge', required - `_id` string, required - `userId` string, required - `chainIn` string, required - `chainOut` string, required - `amountIn` string, required — a string to be decoded into a BigDecimal - `amountInUsd` number, required — a number to be decoded into a BigDecimal - `amountOut` string, required — a string to be decoded into a BigDecimal - `amountOutUsd` number, required — a number to be decoded into a BigDecimal - `amountNative` string, required — a string to be decoded into a BigDecimal - `amountNativeUsd` number, required — a number to be decoded into a BigDecimal - `fee` string, required — a string to be decoded into a BigDecimal - `feeUsd` number, required — a number to be decoded into a BigDecimal - `gasFee` string, required — a string to be decoded into a BigDecimal - `gasFeeUsd` number, required — a number to be decoded into a BigDecimal - `platformFee` string, required — a string to be decoded into a BigDecimal - `platformFeeUsd` number, required — a number to be decoded into a BigDecimal - `percentageFee` string, required — a string to be decoded into a BigDecimal - `percentageFeeUsd` number, required — a number to be decoded into a BigDecimal - `sourceGasFee` string, required — a string to be decoded into a BigDecimal - `sourceGasFeeUsd` number, required — a number to be decoded into a BigDecimal - `sponsoredFees` object, required - … - `recipient` string, required - `depositor` string, required - `createdAt` string, required — a string to be decoded into a Date - `commitmentDate` string, required — a string to be decoded into a Date - `speed` 'fast' | 'standard' | 'slow' - `estimatedDuration` number — a non-negative number to be decoded into a Duration - `postBridgeData` union - … - `flowCredits` number — a number to be decoded into a BigDecimal - `token` string, required - `tokenOut` string - `usdPrice` number, required — a number to be decoded into a BigDecimal - `depositAddress` string - `preSwap` SwapQuote - … - `postSwap` SwapQuote - … - `depositTxHash` string, required - `depositCommittedAt` string, required — a string to be decoded into a Date - `depositDiscoveredAt` string — a string to be decoded into a Date - `depositConfirmedAt` string — a string to be decoded into a Date - `expectedDepositConfirmedAt` string — a string to be decoded into a Date - `expectedDepositConfirmedAtBlock` integer — an integer - `preSwapTxHash` string - `preSwapCommittedAt` string — a string to be decoded into a Date - `isConfirmed` boolean - `state` 'ACCEPTED', required - object - `_tag` 'depositAddressBridge', required - `_id` string, required - `userId` string, required - `chainIn` string, required - `chainOut` string, required - `amountIn` string, required — a string to be decoded into a BigDecimal - `amountInUsd` number, required — a number to be decoded into a BigDecimal - `amountOut` string, required — a string to be decoded into a BigDecimal - `amountOutUsd` number, required — a number to be decoded into a BigDecimal - `amountNative` string, required — a string to be decoded into a BigDecimal - `amountNativeUsd` number, required — a number to be decoded into a BigDecimal - `fee` string, required — a string to be decoded into a BigDecimal - `feeUsd` number, required — a number to be decoded into a BigDecimal - `gasFee` string, required — a string to be decoded into a BigDecimal - `gasFeeUsd` number, required — a number to be decoded into a BigDecimal - `platformFee` string, required — a string to be decoded into a BigDecimal - `platformFeeUsd` number, required — a number to be decoded into a BigDecimal - `percentageFee` string, required — a string to be decoded into a BigDecimal - `percentageFeeUsd` number, required — a number to be decoded into a BigDecimal - `sourceGasFee` string, required — a string to be decoded into a BigDecimal - `sourceGasFeeUsd` number, required — a number to be decoded into a BigDecimal - `sponsoredFees` object, required - … - `recipient` string, required - `depositor` string, required - `createdAt` string, required — a string to be decoded into a Date - `commitmentDate` string, required — a string to be decoded into a Date - `speed` 'fast' | 'standard' | 'slow' - `estimatedDuration` number — a non-negative number to be decoded into a Duration - `postBridgeData` union - … - `flowCredits` number — a number to be decoded into a BigDecimal - `token` string, required - `tokenOut` string - `usdPrice` number, required — a number to be decoded into a BigDecimal - `depositAddress` string, required - `preSwap` SwapQuote - … - `postSwap` SwapQuote - … - `depositTxHash` string, required - `depositCommittedAt` string, required — a string to be decoded into a Date - `depositDiscoveredAt` string — a string to be decoded into a Date - `depositConfirmedAt` string — a string to be decoded into a Date - `expectedDepositConfirmedAt` string — a string to be decoded into a Date - `expectedDepositConfirmedAtBlock` integer — an integer - `preSwapTxHash` string - `preSwapCommittedAt` string — a string to be decoded into a Date - `isConfirmed` boolean - `withdrawTxHash` string, required - `withdrawCommittedAt` string, required — a string to be decoded into a Date - `state` 'EXECUTED', required - `createdAt` string, required — a string to be decoded into a DateTime.Utc - `_tag` 'accepted', required ## Other responses - `400` — The request did not match the expected schema - `401` — Unauthorized - `422` — DepositAddressNotFound - `503` — EndpointDisabledError --- [API](https://skmtc.net/rhino/apis/bridge-api.md) · [All operations](https://skmtc.net/rhino/apis/bridge-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rhino/bridge-api/revisions/fb4dd5f3c1b3/schema)