--- 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` ## Request - Base URL: `https://api.rhino.fi/bridge` - URL: `https://api.rhino.fi/bridge/deposit-addresses/{depositAddress}/{depositChain}/history` - Auth: one of: - HTTP bearer - API key in header `authorization` - TypeScript: (a function with typed inputs; its response is checked against the schema) 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.dev/rhino/apis/bridge-api.md) - [All operations](https://skmtc.dev/rhino/apis/bridge-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rhino/apis/bridge-api/revisions/fb4dd5f3c1b3?raw)