# Rubic Documentation

## Docs

- [Error Handling](https://docs.rubic.finance/api-docs/about/core-concepts/error-handling.md): This page explains how errors are structured in the Rubic API, how error codes are formed, and how they should be handled during quote and swap execution.
- [Refunds](https://docs.rubic.finance/api-docs/about/core-concepts/refunds.md): Refund handling depends on the selected provider. In most cases, refunds are processed automatically by the provider and do not require any action from the client or the user.
- [Understanding Flow Execution](https://docs.rubic.finance/api-docs/about/core-concepts/understanding-flow-execution.md)
- [Fee sharing via decentralized providers](https://docs.rubic.finance/api-docs/about/monetization/evm.md)
- [Fee sharing via deposit-based providers](https://docs.rubic.finance/api-docs/about/monetization/non-evm.md)
- [Monetization](https://docs.rubic.finance/api-docs/about/monetization/overview.md): Customize, monetize, and simplify with Rubic.
- [Swagger & OpenAPI](https://docs.rubic.finance/api-docs/about/open-api.md): Rubic API provides an interactive Swagger UI generated from its OpenAPI specification. Swagger is intended to help integrators explore available endpoints, inspect request and response schemas, and test API calls.
- [Overview](https://docs.rubic.finance/api-docs/about/overview.md): Rubic API is a unified interface for building on-chain and cross-chain swap integrations. It allows applications to discover available routes, calculate swap results, execute swaps, and track transaction status across multiple blockchains and providers. The API abstracts away provider-specific logic…
- [Referrer and Rate limits](https://docs.rubic.finance/api-docs/about/referrer.md)
- [Transaction Statuses Explained](https://docs.rubic.finance/api-docs/general/status/explain.md): This page explains the meaning of each transaction status you may encounter while tracking a cross-chain transaction. Use it to understand the current state of a transaction, identify potential issues, and determine whether any additional action is required.
- [Prevent dangerous routes](https://docs.rubic.finance/api-docs/guides/dangerous-routes.md): How to prevent swaps via routes with high slippage or price impact
- [Handling amount changes during swap](https://docs.rubic.finance/api-docs/guides/handling-amount-change.md): During swap execution, the output amount may differ from the amount returned during the quote step. This behavior is expected and can occur due to price movements, liquidity changes, or provider recalculation.
- [Get available providers](https://docs.rubic.finance/api-reference/info/get-available-providers.md): This endpoint returns a list of supported providers available for swaps in the Rubic API. Each provider object contains list of supported by provider blockchains and provider name used in the API. Contains separate information for cross-chain providers and on-chain providers
- [Get chains list](https://docs.rubic.finance/api-reference/info/get-chains-list.md): This endpoint returns a list of supported blockchains available for exchange and transactions in the Rubic API. Each blockchain object contains a name, an identifier, list of providers that support this blockchain, the type of blockchain and whether fee collection is available in this blockchain (pr…
- [Get transaction status](https://docs.rubic.finance/api-reference/info/get-transaction-status.md): You can check the status of your cross-chain transaction by providing the source transaction hash and/or the id received in the /swap response.
- [Get all available quotes](https://docs.rubic.finance/api-reference/router/get-all-available-quotes.md): Using this endpoint, you can get a preview of all possible routes for a cross-chain or on-chain swaps. The router goes through all supported DEXes, bridges, and aggregators to find and return all available routes. All routes are sorted by expected swap output, allowing you to easily compare differen…
- [Get all available quotes via deposit](https://docs.rubic.finance/api-reference/router/get-all-available-quotes-via-deposit.md): Using this endpoint, you can get a preview of all possible deposit routes for a cross-chain swap. The router goes through all supported deposit-based bridges and providers to find and return all available deposit trades.
- [Get best quote](https://docs.rubic.finance/api-reference/router/get-best-quote.md): Using this endpoint, you can get the best available route for a cross-chain or on-chain swap. The router goes through all supported DEXes, bridges, and aggregators to find and return the route with the highest expected swap output.
- [Get swap data](https://docs.rubic.finance/api-reference/router/get-swap-data.md): Using this endpoint, you can get the transaction data required to execute a swap. The data is generated based on the route selected in the previous step and can be used to send the swap transaction from the user’s wallet.
- [Get swap data for the best quote](https://docs.rubic.finance/api-reference/router/get-swap-data-for-the-best-quote.md): Using this endpoint, you can get the transaction data for executing the best available swap route. The router automatically selects the route with the highest expected swap output and returns the corresponding transaction data, ready to be sent from the user’s wallet.
- [Get swap data via deposit](https://docs.rubic.finance/api-reference/router/get-swap-data-via-deposit.md): Using this endpoint, you can get the deposit data required to perform a manual transfer to a selected deposit-based provider. The response includes the depositAddress, amountToSend, exchangeId, and optional extraFields, which can be used to manually send funds from the wallet. This data is generated…
- [Get allowance](https://docs.rubic.finance/api-reference/utility/get-allowance.md): This endpoint retrieves the current allowance value for an ERC-20 token on the specified blockchain. It is typically used before calling the approve endpoint to decide whether additional approval is needed.
- [Get approve info](https://docs.rubic.finance/api-reference/utility/get-approve-info.md): This endpoint determines whether a token approval is required on the specified blockchain. If approval is needed, it returns all transaction data required to execute the approval on-chain.
- [Get celer refund data](https://docs.rubic.finance/api-reference/utility/get-celer-refund-data.md): This endpoint returns the data required to refund a transaction via the Celer Bridge. It is used when a cross-chain transaction cannot be completed and a refund must be executed on the source or destination network.
- [Get claim tokens data](https://docs.rubic.finance/api-reference/utility/get-claim-tokens-data.md): This endpoint returns the data required to claim or redeem tokens for the Arbitrum Bridge (ETH ↔ Arbitrum). It is used after a successful source-chain transaction to prepare the on-chain call on the destination network.
- [Get message to auth wallet](https://docs.rubic.finance/api-reference/utility/get-message-to-auth-wallet.md): This endpoint provides a message required for wallet authentication when using the Retrobridge provider. The user must sign this message with their wallet, and the resulting signature must be attached to the swap request to enable transaction execution.
- [Health check](https://docs.rubic.finance/api-reference/utility/health-check.md): This endpoint returns the current health status of the API. It can be used to verify service availability and basic system readiness.
- [Configuration](https://docs.rubic.finance/configuration.md)
- [Swaps from Bitcoin](https://docs.rubic.finance/docs/api-docs/integration-examples/swaps-from-bitcoin.md): This page explains how to connect a Web3 wallet, retrieve token quotes and execute a transaction using Rubic API, with examples using CTRL wallet extension.
- [Swaps from EVM](https://docs.rubic.finance/docs/api-docs/integration-examples/swaps-from-evm.md): This page explains how to connect a Web3 wallet, retrieve token quotes, approve tokens, and execute a transaction using Rubic API, with examples using ethers.js, web3.js, and viem.
- [Swaps from Solana](https://docs.rubic.finance/docs/api-docs/integration-examples/swaps-from-solana.md): This page explains how to connect a Web3 wallet, retrieve token quotes, approve tokens, and execute a transaction using Rubic API, with examples using @solana/web3.js.
- [Swaps from TON](https://docs.rubic.finance/docs/api-docs/integration-examples/swaps-from-ton.md): This page explains how to connect a Web3 wallet, retrieve token quotes, approve tokens, and execute a transaction using Rubic API, with examples using TonConnectUI.
- [Swaps from Tron](https://docs.rubic.finance/docs/api-docs/integration-examples/swaps-from-tron.md): This page explains how to connect a Web3 wallet, retrieve token quotes, approve tokens, and execute a transaction using Rubic API, with examples using ethers.js, web3.js, and viem.
- [Swaps via Deposit](https://docs.rubic.finance/docs/api-docs/integration-examples/swaps-via-deposit.md): This page explains how to execute a transaction via deposit using Rubic API.
- [Tokens API](https://docs.rubic.finance/docs/token-api/token-api.md)
- [Error handling](https://docs.rubic.finance/error-handling.md)
- [Getting started](https://docs.rubic.finance/getting-started.md)
- [Info](https://docs.rubic.finance/info.md)
- [Overview](https://docs.rubic.finance/overview.md)
- [Quote](https://docs.rubic.finance/quote.md)
- [Rubic SDK](https://docs.rubic.finance/rubic-sdk.md)
- [MixBytes Audit](https://docs.rubic.finance/rubic/audits/audits.md)
- [Business Development](https://docs.rubic.finance/rubic/contacts/business-development.md)
- [PR and Marketing](https://docs.rubic.finance/rubic/contacts/pr-marketing.md)
- [Support](https://docs.rubic.finance/rubic/contacts/support.md)
- [Privacy Policy](https://docs.rubic.finance/rubic/legal-documentation/privacy-policy.md)
- [Terms of Use](https://docs.rubic.finance/rubic/legal-documentation/terms-of-use.md)
- [B2B Cross-Chain Toolkit](https://docs.rubic.finance/rubic/overview/b2b-tools.md)
- [Rubic's Ecosystem](https://docs.rubic.finance/rubic/overview/ecosystem.md)
- [MEV-bot protection](https://docs.rubic.finance/rubic/overview/mev-bot-protection.md)
- [Overview](https://docs.rubic.finance/rubic/overview/overview.md)
- [Roadmap](https://docs.rubic.finance/rubic/overview/roadmap.md)
- [Rubic's Private Mode Beta](https://docs.rubic.finance/rubic/overview/rubics-private-mode-beta.md)
- [Security](https://docs.rubic.finance/rubic/overview/security.md)
- [Is KYC required?](https://docs.rubic.finance/rubic/overview/support-kyc.md)
- [Stuck Transactions & Refunds](https://docs.rubic.finance/rubic/overview/support-stuck-transactions.md)
- [Tokenomics](https://docs.rubic.finance/rubic/overview/tokenomics.md)
- [Statuses](https://docs.rubic.finance/statuses.md)
- [Swap](https://docs.rubic.finance/swap.md)
- [Utility](https://docs.rubic.finance/utility.md)

## OpenAPI Specs

- [swagger-json](https://api-v2.rubic.exchange/api/routes/swagger-json)