# rhino.fi - Docs ## Docs - [Get Started](https://docs.rhino.fi/get-started/introduction.md) - [What is Rhino.fi?](https://docs.rhino.fi/get-started/what-is-rhino.md): Learn about the Rhino.fi Stablecoin Activation Stack and how it turns stablecoin deposits into usable balances for enterprise teams. - [Fees](https://docs.rhino.fi/get-started/fees-and-limits.md): Learn how Rhino.fi charges fees and how the Advanced Fee & Limit Management extension gives you control and comprehensive configurability. - [Limits ](https://docs.rhino.fi/get-started/limits.md): Learn how Rhino.fi charges fees and how the Advanced Fee & Limit Management extension gives you control and comprehensive configurability. - [Smart Deposit Addresses](https://docs.rhino.fi/get-started/sda.md): Smart Deposit Addresses are the core deposit primitive in the Rhino.fi Stablecoin Activation Stack. Generate one address per user; Rhino.fi handles chain detection, routing, settlement, and compliance automatically. - [API Keys](https://docs.rhino.fi/get-started/api-keys.md): To use the API or SDK, you need to obtain an API key. API keys can either be secret or public. - [Rhino Console](https://docs.rhino.fi/get-started/rhino-console.md): The Rhino Console is the web interface for managing your Rhino integration — transaction history, analytics, team settings, and configuration. - [Extensions](https://docs.rhino.fi/get-started/extensions.md): Extensions are premium features that expand the capabilities of the Rhino Stablecoin Activation Stack. - [Enhanced Compliance & Risk Management](https://docs.rhino.fi/get-started/extensions/enhanced-compliance.md): Custom AML screening rules and real-time AML event notifications for clients with stricter compliance requirements. - [Automated Onchain Actions](https://docs.rhino.fi/get-started/extensions/automated-onchain-actions.md): Automated Onchain Actions let you specify a contract call that executes automatically when settled funds arrive on the destination chain. Configure once; Rhino handles approval, encoding, execution, and error handling. - [1:1 Stablecoin Swaps](https://docs.rhino.fi/get-started/extensions/stablecoin-swaps.md): USDT↔USDC conversion at a guaranteed 1:1 rate, no slippage, no market exposure. - [Advanced Fee & Limit Management](https://docs.rhino.fi/get-started/extensions/advanced-fee-management.md): View fee and limit configurations across the Stablecoin Activation Stack with the ability to change fee structures to customer and route levels, as well as levying a client surcharge. - [Custom Chain & Token Support](https://docs.rhino.fi/get-started/extensions/custom-chain-token-support.md): Expand supported chains or tokens beyond the standard set. - [Tron Access](https://docs.rhino.fi/get-started/extensions/tron-access.md): Enable TRON network deposits and settlement. - [Supported Chains](https://docs.rhino.fi/get-started/supported-chains.md): List of chains that Rhino.fi smart contracts are deployed on and tokens supported. The chains in the "Smart Deposit Address" tab are those chains on which you can generate SDAs. Funds from these deposit addresses can be bridged to any of our supported chains. - [Quickstart](https://docs.rhino.fi/sdk/quickstart.md): Learn how to use the bridge SDK to make bridges with only a few lines of code. - [Smart Deposit Addresses](https://docs.rhino.fi/sdk/smart-deposits.md): Manage Smart Deposit Addresses conveniently with the SDK. - [Bridge](https://docs.rhino.fi/sdk/bridge-functions/bridge.md): The SDK offers convenience functions to make bridges that handle all the low level logic of fetching/committing quotes and making the correct blockchain transactions needed. - [Prepare bridge](https://docs.rhino.fi/sdk/bridge-functions/prepare-bridge.md): If you need more control over the bridge flow, you can use the `prepareBridge` function instead of the previously discussed `bridge` function. - [Bridge and swap](https://docs.rhino.fi/sdk/bridge-and-swap.md): Rhino also supports cross chain swaps using external swap aggregators. - [Bridge API](https://docs.rhino.fi/sdk/bridge-api.md): Learn how to use the SDK to interact with the bridge API directly. - [Interacting with Stellar](https://docs.rhino.fi/interacting-with-stellar.md) - [Concepts](https://docs.rhino.fi/sdk/concepts.md): Learn about the core concepts of the SDK. - [Token Prices](https://docs.rhino.fi/sdk/token-prices.md): Learn how to easily fetch token prices through the SDK. - [Chain Adapters Overview](https://docs.rhino.fi/sdk/chain-adapters/overview.md): The SDK ships with ready-to-use chain adapters for all chains that Rhino supports. - [EVM Chain Adapter](https://docs.rhino.fi/sdk/chain-adapters/evm-chains.md) - [Solana Chain Adapter](https://docs.rhino.fi/sdk/chain-adapters/solana.md) - [Starknet Chain Adapter](https://docs.rhino.fi/sdk/chain-adapters/starknet.md) - [Ton Chain Adapter](https://docs.rhino.fi/sdk/chain-adapters/ton.md) - [Tron Chain Adapter](https://docs.rhino.fi/sdk/chain-adapters/tron.md) - [Paradex Chain Adapter](https://docs.rhino.fi/sdk/chain-adapters/paradex.md) - [Custom chain adapters](https://docs.rhino.fi/sdk/chain-adapters/custom-chain-adapters.md) - [To SDK version 1.x](https://docs.rhino.fi/migration-guides/to-1x.md): Learn how to upgrade your code to version 1.x if you have been using a 0.x version of the SDK before. - [From API to SDK](https://docs.rhino.fi/migration-guides/from-api.md): This guide will help you migrate to the SDK if you have been using the API directly before. Depending on how sophisticated your use case is, you can choose between different levels of using the SDK. - [Deprecated endpoint](https://docs.rhino.fi/migration-guides/deprecated-endpoints.md): Learn how to migrate from the deprecated user quote endpoint to its replacement. - [Server setup](https://docs.rhino.fi/webhook/endpoint-setup.md) - [Subscribe to webhooks](https://docs.rhino.fi/webhook/subscribe.md): You can either setup your webhook URL once for your project in the Rhino Console or pass it on invidual bridges. - [Verify signature](https://docs.rhino.fi/webhook/verify-webhook-signature.md) - [Get missed events](https://docs.rhino.fi/webhook/get-missed-events.md) - [Events List](https://docs.rhino.fi/webhook/events-list.md) - [API Integration](https://docs.rhino.fi/api-integration/introduction.md): Integrate the Rhino Stablecoin Activation Stack directly via REST API. - [Authentication](https://docs.rhino.fi/api-integration/authentication.md) - [Making a bridge](https://docs.rhino.fi/api-integration/bridge.md): This guide walks you through integrating our bridge API into your application. By following these steps, you’ll be able to transfer assets between chains using our API and smart contract interactions. - [Making a bridge & swap](https://docs.rhino.fi/api-integration/swap.md): This guide walks you through integrating our bridge API into your application. By following these steps, you’ll be able to transfer and swap assets between chains using our API and smart contract interactions. - [Bridge Status & History](https://docs.rhino.fi/api-integration/status-history.md): This section explains how to retrieve the status and history of your bridge transactions. You can use these endpoints to monitor transaction progress and confirm successful transfers. - [Smart Deposit Addresses](https://docs.rhino.fi/api-integration/smart-deposits.md): Use the Smart Deposit Addresses API to generate addresses that accept stablecoin deposits from any supported chain and automatically settle to a specified destination. Includes support for cross-stable swaps, Automated Onchain Actions, and configurable fee handling. - [Overview](https://docs.rhino.fi/contracts/contract-examples.md): This section provides integration examples for interacting with the rhino.fi bridge smart contracts across different blockchain environments. Whether you're working with **EVM-based chains** like Ethereum and Scroll or **non-EVM chains** such as Solana, Tron, TON, and Starknet, you'll find practical… - [EVM (Ethereum / L2s)](https://docs.rhino.fi/contracts/evm.md): This guide explains how to interact with the [**Bridge Contract**](https://github.com/rhinofi/contracts_public/blob/master/bridge-deposit/DVFDepositContract.sol) on EVM-compatible blockchains. - [Solana Contracts](https://docs.rhino.fi/contracts/solana.md): This guide explains how to interact with the rhino.fi Bridge program on Solana. - [Starknet Contracts](https://docs.rhino.fi/contracts/starknet.md): This guide explains how to interact with the rhino.fi Bridge contract on Starknet. - [TON Contracts](https://docs.rhino.fi/contracts/ton.md): This guide explains how to interact with the rhino.fi Bridge contract on TON. - [TRON Contracts](https://docs.rhino.fi/contracts/tron.md): This guide explains how to interact with the rhino.fi Bridge contract on Tron. - [iframe Widget](https://docs.rhino.fi/widget/widget.md): The widget will allow you easily integrate a fully functional bridge UI into your application with only a few lines of code - [iframe SDA Widget](https://docs.rhino.fi/widget/sda-widget.md): The SDA Widget lets you integrate a fully functional Smart Deposit Address bridge UI into your application with only a few lines of code - [Contract addresses](https://docs.rhino.fi/general/contract-addresses.md): List of rhino.fi smart contract addresses deployed across our supported chains - [Status page](https://docs.rhino.fi/general/status-page.md) - [Rhino API Reference](https://docs.rhino.fi/api-reference/introduction.md): Full endpoint reference for the Rhino Stablecoin Activation Stack — deposit address generation, bridge quotes and execution, transaction history, and Extensions. - [Public Quote](https://docs.rhino.fi/api-reference/bridge/quote/public-quote.md): Deprecated: Use /quote/bridge-swap/public instead. Fetch public bridge quote. - [User Quote](https://docs.rhino.fi/api-reference/bridge/quote/user-quote.md): Deprecated: Use /quote/bridge-swap/user instead. Fetch bridge user quote when authenticated. - [Commit an already generated quote](https://docs.rhino.fi/api-reference/bridge/quote/commit-an-already-generated-quote.md): This endpoint allows you to commit a generated quote from the `POST /quote/user` or `POST /quote/bridge-swap/user` endpoints so that it is picked up and tracked by the Rhino.fi system. - [Public Quote for Bridge & Swap](https://docs.rhino.fi/api-reference/bridge/quote/public-quote-for-bridge-&-swap.md): Fetch public bridge and swap quote. - [Generate a bridge/bridge+swap quote](https://docs.rhino.fi/api-reference/bridge/quote/generate-a-bridgebridge+swap-quote.md): This endpoint allows you to obtain a quote for a bridge or bridge+swap transaction that can be submitted through the `POST /quote/commit/{quoteId}` endpoint. - [Obtain token and chain details for swapping and/or bridging activity](https://docs.rhino.fi/api-reference/bridge/configs/obtain-token-and-chain-details-for-swapping-andor-bridging-activity.md): This endpoint provides key information about the chains and tokens that Rhino.fi supports swapping and/or bridging across as well as field names that should be used in other endpoints. - [Obtain token and chain details for swapping and/or bridging activity for a specific token on a specific chain](https://docs.rhino.fi/api-reference/bridge/configs/obtain-token-and-chain-details-for-swapping-andor-bridging-activity-for-a-specific-token-on-a-specific-chain.md): This endpoint provides key information a chain or token that Rhino.fi supports swapping and/or bridging across as well as field names that should be used in other endpoints. - [Single Config (token address/chain)](https://docs.rhino.fi/api-reference/bridge/configs/single-config-token-addresschain.md): Fetch config for a token by address - [Obtain details for which swap tokens are supported by Rhino.fi on which chains](https://docs.rhino.fi/api-reference/bridge/configs/obtain-details-for-which-swap-tokens-are-supported-by-rhinofi-on-which-chains.md): This endpoint provides a list of which swap tokens are supported by Rhino.fi on which chains and key details for each chain and token. These are the tokens available for swapping activity. - [User History](https://docs.rhino.fi/api-reference/bridge/history/user-history.md): Fetch bridge history for a user. Will be removed in the future, please use /histor-cursor instead. - [Obtain a list of previously generated swapping and/or bridging quotes](https://docs.rhino.fi/api-reference/bridge/history/obtain-a-list-of-previously-generated-swapping-andor-bridging-quotes.md): This endpoint provides a full history of a user's bridging and swapping activity. This includes commits for quotes generated through the `POST /quote/user` and `POST /quote/bridge-swap/user` endpoints and submitted through `POST /quote/commit/{quoteId}`, as well as bridges initiated via a Smart Depo… - [Obtain the status of a specific bridge transaction](https://docs.rhino.fi/api-reference/bridge/history/obtain-the-status-of-a-specific-bridge-transaction.md): This endpoint provides the status of a bridge transaction as created through the `POST /quote/user` or `POST /quote/bridge-swap/user` endpoints. For status information for Smart Deposit Address transactions, the `GET /sda/deposit-addresses/{depositAddress}/{depositChain}` endpoint should be used. - [Patch Bridge Status](https://docs.rhino.fi/api-reference/bridge/history/patch-bridge-status.md): Patch the status of a bridge. - [Bridge Status (Withdraw Hash)](https://docs.rhino.fi/api-reference/bridge/history/bridge-status-withdraw-hash.md): Fetch the status of a single executed bridge by withdraw transaction hash. - [Obtain the status of a specific bridge transaction by withdrawal hash](https://docs.rhino.fi/api-reference/bridge/history/obtain-the-status-of-a-specific-bridge-transaction-by-withdrawal-hash.md): This endpoint provides the status of a bridge transaction as created through the `POST /quote/user` or `POST /quote/bridge-swap/user` endpoints based on a given withdrawal transaction hash. For status information for Smart Deposit Address transactions, the `GET /sda/deposit-addresses/{depositAddress… - [Obtain the status of a specific bridge transaction by deposit hash](https://docs.rhino.fi/api-reference/bridge/history/obtain-the-status-of-a-specific-bridge-transaction-by-deposit-hash.md): This endpoint provides the status of a bridge transaction as created through the `POST /quote/user` or `POST /quote/bridge-swap/user` endpoints based on a given deposit transaction hash. For status information for Smart Deposit Address transactions, the `GET /sda/deposit-addresses/{depositAddress}/{… - [Calldata to execute a single swap](https://docs.rhino.fi/api-reference/bridge/swap/calldata-to-execute-a-single-swap.md): Get the calldata needed to execute a single swap. - [Generate a new smart deposit address](https://docs.rhino.fi/api-reference/bridge/depositaddresses/generate-a-new-smart-deposit-address.md): Please use the identical endpoint under https://api.rhino.fi/sda. The sda endpoints here exist only for backwards compatibility and will be removed in the future. If you use the SDK, please upgrade to the latest version which uses the correct endpoint. - [Reactivate deposit address](https://docs.rhino.fi/api-reference/bridge/depositaddresses/reactivate-deposit-address.md): Please use the identical endpoint under https://api.rhino.fi/sda. The sda endpoints here exist only for backwards compatibility and will be removed in the future. If you use the SDK, please upgrade to the latest version which uses the correct endpoint. - [Get deposit address status](https://docs.rhino.fi/api-reference/bridge/depositaddresses/get-deposit-address-status.md): Please use the identical endpoint under https://api.rhino.fi/sda. The sda endpoints here exist only for backwards compatibility and will be removed in the future. If you use the SDK, please upgrade to the latest version which uses the correct endpoint. - [Obtain a list of previous activity for a Smart Deposit Address](https://docs.rhino.fi/api-reference/bridge/depositaddresses/obtain-a-list-of-previous-activity-for-a-smart-deposit-address.md): Please use the identical endpoint under https://api.rhino.fi/sda. The sda endpoints here exist only for backwards compatibility and will be removed in the future. If you use the SDK, please upgrade to the latest version which uses the correct endpoint. - [Get public deposit address status](https://docs.rhino.fi/api-reference/bridge/depositaddresses/get-public-deposit-address-status.md): Please use the identical endpoint under https://api.rhino.fi/sda. The sda endpoints here exist only for backwards compatibility and will be removed in the future. If you use the SDK, please upgrade to the latest version which uses the correct endpoint. - [Obtain the supported tokens for a Smart Deposit Address](https://docs.rhino.fi/api-reference/bridge/depositaddresses/obtain-the-supported-tokens-for-a-smart-deposit-address.md): Please use the identical endpoint under https://api.rhino.fi/sda. The sda endpoints here exist only for backwards compatibility and will be removed in the future. If you use the SDK, please upgrade to the latest version which uses the correct endpoint. - [Obtain a specific Smart Deposit Address/es based on various criteria](https://docs.rhino.fi/api-reference/bridge/depositaddresses/obtain-a-specific-smart-deposit-addresses-based-on-various-criteria.md): Please use the identical endpoint under https://api.rhino.fi/sda. The sda endpoints here exist only for backwards compatibility and will be removed in the future. If you use the SDK, please upgrade to the latest version which uses the correct endpoint. - [Generate a new smart deposit address](https://docs.rhino.fi/api-reference/sda/depositaddresses/generate-a-new-smart-deposit-address.md): This endpoint allows you to generate a new smart deposit address for a given set of chains and set the swapping and/or bridging activity that should be done for any funds sent to it. - [Reactivate deposit address](https://docs.rhino.fi/api-reference/sda/depositaddresses/reactivate-deposit-address.md): Reactivates a deposit address that is inactive. - [Pause, unpause, or update deposit addresses](https://docs.rhino.fi/api-reference/sda/depositaddresses/pause-unpause-or-update-deposit-addresses.md): Pauses or unpauses deposit address(es) matching the given address, or updates the destination address using signature authorization. For Pause and Unpause, depositChain limits the action to one chain when provided; otherwise all matching deposit addresses are affected. Signature-authorized destinati… - [Get deposit address status](https://docs.rhino.fi/api-reference/sda/depositaddresses/get-deposit-address-status.md): Returns the status of a deposit address on a given chain - [Obtain a list of previous activity for a Smart Deposit Address](https://docs.rhino.fi/api-reference/sda/depositaddresses/obtain-a-list-of-previous-activity-for-a-smart-deposit-address.md): This endpoint provides the history of activity (both successful and unsuccessful) for a given Smart Deposit Address within a given time window. By default the previous 7 days of activity are returned, with a maximum window of 31 days (configurable via the `from` and `to` query params). - [Get public deposit address status](https://docs.rhino.fi/api-reference/sda/depositaddresses/get-public-deposit-address-status.md): Returns the status of a deposit address on a given chain - [Get completed SDA refunds](https://docs.rhino.fi/api-reference/sda/depositaddresses/get-completed-sda-refunds.md): Returns the list of completed refunds for the given deposit address on a given chain. - [Obtain the supported tokens for a Smart Deposit Address](https://docs.rhino.fi/api-reference/sda/depositaddresses/obtain-the-supported-tokens-for-a-smart-deposit-address.md): This endpoint provides key information about the chains and tokens that Rhino.fi supports swapping and/or bridging on for Smart Deposit Addresses. - [Obtain a specific Smart Deposit Address/es based on various criteria](https://docs.rhino.fi/api-reference/sda/depositaddresses/obtain-a-specific-smart-deposit-addresses-based-on-various-criteria.md): This endpoint allows you to find a specific Smart Deposit Address or Addresses based on provided criteria. - [Obtain the current rate limit usage for Smart Deposit Address creation](https://docs.rhino.fi/api-reference/sda/depositaddresses/obtain-the-current-rate-limit-usage-for-smart-deposit-address-creation.md): This endpoint allows you to see what your total number of generated Smart Deposit Addresses is, as well as what any limits across any frequencies are. - [Rhino.fi Webhook Public Key](https://docs.rhino.fi/api-reference/webhook/signature/rhinofi-webhook-public-key.md): Rhino.fi public key used to verify webhook events signatures. - [Webhook user events (deprecated)](https://docs.rhino.fi/api-reference/webhook/user-events/webhook-user-events-deprecated.md): Will be removed in the future, please use /user-events-cursor instead. - [Obtain a list of previously generated webhook events](https://docs.rhino.fi/api-reference/webhook/user-events/obtain-a-list-of-previously-generated-webhook-events.md): This endpoint provides the webhook events generated for your project since a given point in time, using cursor-based pagination. It can be used to reconcile or replay events, for example where your webhook endpoint was unavailable at the time an event was sent. ## OpenAPI Specs - [swagger](https://api.rhino.fi/bridge/swagger.json) ## Optional - [Rhino.fi Console](https://console.rhino.fi) - [Website](https://rhino.fi/) - [Bridge now](https://app.rhino.fi/bridge) - [Blog](https://rhino.fi/blog/)