> For the complete documentation index, see [llms.txt](https://help.rails.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.rails.xyz/support/troubleshooting-guide.md).

# Troubleshooting Guide

We've got tips to help you troubleshoot the most common issues. Need more help?

{% hint style="info" %}
Should you have additional questions not covered in this troubleshooting guide, please reach out to a support team member by [sending us an email](https://railsxyz.zendesk.com/hc/en-us/requests/new).
{% endhint %}

### Sign Up

<details>

<summary>ID Document Verification</summary>

If you're having issues verifying your government-issued driver's license, passport, or ID card:

* Ensure your browser is up to date (whether you’re on a computer or mobile device).
* Complete the verification process on your mobile device by clicking **Continue on phone**. Your phone’s camera typically produces the clearest photo.

<div align="center"><figure><img src="https://1893902947-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvoJ4s2ha99AB453yyXn5%2Fuploads%2FvBpstrS1NPcQS7oCOdRA%2FScreenshot%202025-02-11%20at%2012.39.58%E2%80%AFPM.png?alt=media&amp;token=2a15e4bc-b73f-42f2-8cf3-ccfd94169100" alt="" width="375"><figcaption><p>This option is found at the bottom of each screen in this process.</p></figcaption></figure></div>

* If you must use a webcam, try setting the ID flat down and move the webcam instead of moving the ID.
* Use indirect light to capture your ID to avoid glare.
* Use a plain background for the photo.
* Ensure all corners of the ID are visible, and there are no objects in the way.

</details>

<details>

<summary>Facial Recognition Issues</summary>

* Make sure your area is well-lit (natural light works best).
* Keep your face centered and fully visible in the frame.
* Avoid unnecessary accessories or obstructions — If you have glasses on in your ID photo, keep them on, but take off your hat.
* If you're using a webcam, it works best if you are eye-level with the camera.

</details>

### Manage Account

#### General

<details>

<summary>Sign-In Issues</summary>

**Invalid Credentials:** If you're receiving this error message when attempting to sign in, it could be due to the following reasons:

* **Incorrect Sign-In Page**: Make sure you're using the [correct URL](https://exchange.rails.xyz/) to log in to your account.
* **Incorrect Email:** Confirm you're entering the correct email associated with your account.
* **Incorrect Password:** If you're certain you're using the correct email and sign-in page, try resetting your password or signing in with Google if you're using Gmail.

**MFA Issues:** If your One-Time-Passcode (OTP) or passkey is not working, try the following:

* **Try Another Method**: If you have multiple authentication methods configured on your account (i.e. at least 2 of OTP, passkeys or Sign in with Google), try again with a different method.
* **Troubleshoot**: View the tips below to help if you're not receiving the email for OTP, or if your passkey isn't working.

</details>

<details>

<summary>Password Reset/OTP Email Not Received</summary>

If you're not receiving password reset or OTP emails, this could be a bug that we'll need to investigate. Try these steps to debug any potential problems or issues.

1. Ensure you are using the correct email associated with your account.
2. Check all available Spam or Junk folders and any tabs (Promotions, Updates, etc).
3. Search your email inbox for any emails from <no-reply@rails.xyz>.
4. Add <no-reply@rails.xyz> to your contacts list to whitelist the emails from our end.
5. Clear your browser cache , then try to use the reset password link again.

If the email is still not being received, please submit a [support request](https://railsxyz.zendesk.com/hc/en-us/requests/new) and our team will contact you as soon as possible. Any further error messages or screenshots of what you're experiencing, and confirmation that you've tried to troubleshoot the above can be added to your request, and will help us expedite a resolution for you.

</details>

<details>

<summary>Passkey Issues</summary>

If you're having issues setting up or logging in with a passkey, it may be due to the following common issues:

**Wrong account**

Make sure you are signed into the correct account associated with the passkey service you set up. For example, if you set up your iCloud passkey with your personal iCloud account (e.g. @gmail.com), but are trying to verify the passkey on a work device with a separate iCloud account (e.g. @workdomain.org) it will fail.

**Device or browser not up to date**

Passkey functionality relies on up-to-date operating systems and browsers. Outdated software may lack necessary features or security updates.

* Ensure your device’s OS is updated to the latest version.
* Use the latest version of Chrome or other browsers like Safari, Edge or Firefox.
* Ensure your settings related to security and privacy don't block passkey functionality.

**Expired or invalid session**

Sessions can expire due to inactivity, network issues, or security policies, leading to failed authentication attempts.

* Reload the sign-in page and attempt to sign in again.
* Clear cookies and cache to remove any corrupted session data.

</details>

#### Wallet Connection

<details>

<summary>Common Wallet Connection Issues</summary>

Here are some common issues that may impact your ability to connect your wallet.

**Network mismatch:**

* Rails supports a few [compatible wallets](https://help.rails.xyz/manage-account/wallet-connection.md#compatible-wallets) on the Stellar network. Make sure you're connecting the right wallet on the right chain.

**Permissions not completed:**

* You need to accept permissions and sign the request in your wallet. If the approval is pending or not completed, you cannot proceed.

**"Please connect to your linked wallet"**

* One wallet address is linked or fixed to each account at a time. [Changes](https://help.rails.xyz/manage-account/wallet-connection.md#changing-your-wallet) can only be made with an account balance of $0.00. If you forgot which wallet you have connected, open **Settings → Wallet**.

**Attempting on mobile:**

* Wallet connection, deposit and withdrawal functions are only available on desktop for now.

</details>

<details>

<summary>Common Wallet Unlinking Issues</summary>

Here are the key reasons you may not be permitted to unlink your wallet.

**Account Balance:**

* Your account balance must be $0 to unlink your wallet. All open positions must be closed and funds withdrawn to the wallet connected.

**Attempting on mobile:**

* Wallet connection, deposit and withdrawal functions are only available on desktop for now.

</details>

<details>

<summary>What is a connected vs. linked wallet?</summary>

Since Rails uses on-chain custody, a digital wallet is required to be **connected** and **linked** to your account to deposit or withdraw funds.

* **Connected**: Provide authorization for the Rails platform to interact with your wallet by verifying the connection in your wallet.
* **Linked**: One wallet address is linked or fixed to each account at a time. Wallets are automatically linked to your account at time of first connection. [Changes](https://help.rails.xyz/manage-account/wallet-connection.md#changing-your-wallet) can only be made by unlinking your wallet which requires an account balance of $0.00.

</details>

<details>

<summary>What if I forgot which wallet address is linked to my account?</summary>

To find the public address of your linked wallet, do the following:

1. [Sign in](https://exchange.rails.xyz/) to your Rails account.
2. Click the profile icon in the bottom-left-hand corner of your screen (in the left sidebar), then select **Settings**.
3. Click **Wallet** in the left-hand navigation bar.
4. Your public address is listed under <kbd>Wallet Address</kbd>. If you don't see this section, you do not have a linked wallet and may connect a new one.

</details>

<details>

<summary>What if I've lost access to my linked wallet address?</summary>

As an onchain custody platform, if you lose access to your wallet we are not able to help you reclaim access to it or any tokens it may have held.

If you've lost access to your linked wallet and your account balance is greater than 0, you will not be permitted to change it. You will need to open a new account to connect a new wallet, or wait until your balance is 0. [Contact Us](https://help.rails.xyz/support/contactus.md)for help with next steps.

{% hint style="danger" %}
Not your keys, not your coins! Never share your private keys with ANYONE. Rails will never ask for these.
{% endhint %}

</details>

<details>

<summary>Why can't I change my wallet when I have a balance?</summary>

Rails restricts or limits wallet changes intentionally to increase security and reduce risk on the platform.

This means that all open positions must be closed and funds withdrawn to an already connected wallet. Users are only permitted to change their wallet address if their account balance is 0.

Rails users must take proactive steps to secure their private keys or secret recovery codes.

</details>

#### Account Funding

<details>

<summary>Common Deposit Issues</summary>

Here are some common issues that may impact your ability to deposit funds.

* **Insufficient Funds:** You must have enough USDT in your wallet to cover your deposit amount. Our article on [Acquiring USDT](https://help.rails.xyz/manage-account/manage-funds/acquiring-usdt.md) offers multiple solutions.
* **Transaction approval not completed:** You need to approve and “sign” the deposit in your Varial Wallet. If the approval is pending or not completed, the deposit cannot proceed.
* **Network mismatch:** Make sure you are using your Stellar-supported wallet **and** that it's connected to the Stellar network.
* **Deposit transaction failed:** This may happen in rare instances, such as if the gas or network costs change during the time the transaction takes to process and you no longer have sufficient funds, or if there is a network error. Click **Try Deposit Again** when prompted.
* **Attempting on mobile:** Wallet connection, deposit and withdrawal functions are only available on desktop for now.
* **Under review:** Due to our commitment to fighting illicit activity and meeting regulatory requirements, all wallet addresses are screened against international sanctions lists. This is done using an automated service which may trigger a manual review of your account. Deposits are not permitted until this review is complete. Our team will contact you within 1 business day to confirm when your deposits are enabled.

</details>

<details>

<summary>Common Deposit Issues</summary>

Here are some common issues that may impact your ability to deposit funds.

* **Insufficient Funds:** You must have enough USDT in your wallet to cover your deposit amount. Our article on [Acquiring USDT](https://help.rails.xyz/manage-account/manage-funds/acquiring-usdt.md) offers multiple solutions.
* **Transaction approval not completed:** You need to approve and “sign” the deposit in your Varial Wallet. If the approval is pending or not completed, the deposit cannot proceed.
* **Network mismatch:** Make sure you are using a [Stellar-compatible wallet](https://help.rails.xyz/manage-account/wallet-connection.md#compatible-wallets) **and** that it's connected to the Stellar network.
* **Deposit transaction failed:** This may happen in rare instances, such as if the gas or network costs change during the time the transaction takes to process and you no longer have sufficient funds, or if there is a network error. Click **Try Deposit Again** when prompted.
* **Attempting on mobile:** Wallet connection, deposit and withdrawal functions are only available on desktop for now.
* **Under review:** Due to our commitment to fighting illicit activity and meeting regulatory requirements, all wallet addresses are screened against international sanctions lists. This is done using an automated service which may trigger a manual review of your account. Deposits are not permitted until this review is complete. Our team will contact you within 1 business day to confirm when your deposits are enabled.

</details>

<details>

<summary>Why are deposits restricted to USDT/USDT0?</summary>

We've chosen to leverage [Tether's](https://tether.to/en/) USDT token on the Stellar network as our required collateral for the Rails platform. USDT is the most widely accepted stablecoin in the world.

</details>

<details>

<summary>Common Withdrawal Issues</summary>

Here are some common withdrawal issues and tips to resolve them.

* **Wallet not connected:**
  * Make sure you are logged into your wallet extension and the wallet address associated with your Rails account is connected. Not sure what wallet is connected? See [Wallet Connection](https://help.rails.xyz/manage-account/wallet-connection.md).
  * Try restarting your browser and/or wallet extension if Rails is telling you the wallet is not connected but your wallet suggests that it is. This may indicate a caching issue.
* **Withdrawal limit not met:** There is a $10 minimum for all withdrawals.
* **Permissions not completed:** You need to accept permissions and sign the request in your wallet. If the approval is pending or not completed, you cannot proceed.
* **Attempting on mobile:** Wallet connection, deposit and withdrawal functions are only available on desktop for now.

</details>

### Trading

#### General

<details>

<summary>What is slippage and why does it happen?</summary>

**What is slippage?**

Slippage happens when the price at which your order is executed is different from the price you expected when you placed the order.

Slippage usually occurs with market orders because they are filled instantly at the best available prices in the order book. If there isn’t enough liquidity at your expected price level, the system continues filling your order at the next best available price until the full order is matched.

**Why does slippage happen?**

* Low Liquidity: If the order book doesn’t have enough buy/sell orders close to your requested price.
* Large Orders: Bigger trades may move through multiple price levels in the book.
* Fast Markets: During volatile price swings, prices can change between the moment you place your order and when it is filled.

For Perpetuals, the max slippage on an order is 0.02, or 2%.

For Options, the max slippage is 0.1, or 10%.

{% hint style="success" %}
To execute at your chosen price, use a limit order. To reduce the price impact of a large market order, use TWAP orders (Perpetuals only).
{% endhint %}

</details>

<details>

<summary>Why did I see lower profit than I expected?</summary>

If your realized profit was lower than you expected, it's likely due to slippage.

Additionally, one discrepancy may be because the unrealized P\&L displayed in your open position reflects the mark price, but order execution uses the order book price.

To avoid slippage and ensure your trade is executed at your chosen price, use a limit order instead of a market order. This applies to trigger orders as well.

</details>

#### Perpetuals

<details>

<summary>Common Order Placement Issues</summary>

There are a few reasons why your order may have failed or not closed. The following questions will help you troubleshoot the issue.

* **Insufficient funds in your Available Balance:** Ensure that the balance available to trade in your account is sufficient to execute your trade, including all fees. If you recently [changed your leverage multiplier](https://help.rails.xyz/trading/perpetuals/margin-leverage-and-liquidation.md#leverage) by selecting a different leverage in the order panel, this would have impacted your buying power. Perpetuals and Options have separate balances. If your funds are in your Options balance, [transfer](https://help.rails.xyz/manage-account/manage-funds/transfer.md) them to your Perpetuals balance first, or vice-versa.
* **Insufficient equity to reach your margin minimum:** If you are using leverage, you can’t place an order that will cause your maintenance or minimum balance to drop lower than the required amounts.
* **Limit price not reached:** Your order stays open until the market reaches your limit price, which is the most you'll pay on a buy or the least you'll accept on a sell.
* **Multiple pending orders impacting trades:** Pending orders in other markets reserve part of your available balance. If not enough remains, a new order won't execute.
* **Account restricted from trading:** There may be restrictions imposed on a user account that could prevent them from executing certain orders. You will be notified via email anytime restrictions are added to your account.
* **Scheduled maintenance:** Maintenance of the Rails platform is always scheduled and users are notified either on the site or app along with estimated duration. Depending on the type of maintenance, orders may or may not execute. We will let you know in advance if this is the case.
* **Asset is scheduled for delisting:** When assets are scheduled for delisting, new orders, open orders and open positions may be restricted. Find out more [here](#asset-delisting).

</details>

<details>

<summary>How to select the right limit price</summary>

Selecting the best price when you are trading an asset involves setting a specific price at which you are willing to buy or sell it. The goal is to get the desired price, but it requires careful consideration of market conditions and your own trading strategy. Further, failure to select an appropriate price may result in your order not closing if there is no buyer or seller willing to accept your trade.

Steps to Select the Best Price for a Limit Order

**Analyze the Market:**

* **Current Price:** Check the Order Book Price of the asset you want to trade. This gives you a baseline.
* **Order Book:** Examine the order book, which shows the prices and quantities of buy and sell orders currently placed on Rails. This can help you understand where most traders are placing their orders.

**Set Your Desired Price:**

* **For Buying:** Choose a price below the current price. This means you are waiting for the price to drop to your set level before your order executes.
* **For Selling:** Choose a price above the current price. Your order will only execute if the price rises to your set level.

</details>

<details>

<summary>Order book price vs index price</summary>

**Order Book Price**

The order book price for derivatives is shown above the chart at the top left of the trading page. It is the midpoint between the best bid (highest price someone is willing to buy) and the best ask (lowest price someone is willing to sell) on Rails.

This is a “fair” reference price in the middle of the current buy and sell offers. It’s often used to give traders a quick view of the market’s balance.

**Index Price**

The current asset price in USD pulled from our [Index Price Sources](https://help.rails.xyz/trading/price-feeds-and-sources.md#index-price). It smooths out sudden spikes or drops that might occur on any one exchange, giving you a more stable and reliable benchmark.

* Positions are opened or closed based on the **order book price**.
* Market Orders are placed using the **index price, but executed using the order book price**, sometimes causing slippage.

</details>

<details>

<summary>Are funding payments a fee Rails is charging me?</summary>

No. Funding payments are not fees. Funding is a balancing mechanism to ensure the perpetual futures contract price stays near the index price. Payments are made between traders only.

</details>

<details>

<summary>How frequently does funding occur?</summary>

Funding payments take place every hour. You can see the last funding rate calculation as well as when the next funding event will take place in the [Market Data section](https://help.rails.xyz/trading/perpetuals/overview.md#market-data) of the main trading page.

Most platforms employ 8-hour funding windows, but there are key benefits to shortening that window. The main benefit is that it allows funding rates to react more quickly to real-time market conditions. This helps keep perpetual contract prices better aligned with spot prices, making trading more fair, stable, and accurate for users.

</details>

<details>

<summary>Where can I find my funding payment history?</summary>

Users can view their funding payments in one of three ways:

1. **Open Positions**: For active trades in the [Trade Summary Tabs](https://help.rails.xyz/trading/perpetuals/overview.md#trade-summary-tabs), the realized P\&L column reflects funding payments for that trade.
2. [**Account Summary**](https://help.rails.xyz/trading/perpetuals/overview.md#account-summary)**:** The funding row in the account summary contains the sum of all lifetime funding payments for each user.
3. **Historical Payments**: Individual funding payments for all historical trades can be found on the Portfolio page in the [Funding tab](https://help.rails.xyz/manage-account/portfolio-and-reporting/portfolio-overview.md#funding-tab-perpetuals-only).

</details>

<details>

<summary>How did you land on an interest rate component of 0.00125%?</summary>

Most centralized exchanges (CEXs) have 8-hour funding windows and use a standard interest rate of 0.01%. Since Rails does hourly funding, we apply a 0.00125% interest rate component to the funding value calculation to remain in line with industry standards.

</details>

#### Options

<details>

<summary>Is the mark price the same as the last traded price?</summary>

Not necessarily. The mark price is a model-based fair value used for platform calculations. The last traded price depends on recent trades and may deviate due to liquidity, spreads, and short-term imbalances.

</details>

<details>

<summary>Why can my option price change even if the underlying price is flat?</summary>

Because IV can change, and because time is passing (time decay). Either can move the theoretical value.

</details>

<details>

<summary>Why do call and put prices “move together” sometimes?</summary>

If the main driver is a change in IV, both calls and puts can increase or decrease together (especially at-the-money options).

</details>

#### Asset Delisting

Rails periodically reviews available assets and markets. Occasionally, this leads to delisting, which involves removing the asset from trading and preventing new positions.

{% columns %}
{% column %}
Here's how delisting might affect you:

* New orders will be blocked or removed to prevent trading the delisted asset.
* Open orders may be deleted or canceled without execution.
* If you have an open position in an asset being delisted, we'll email you a date to close it by. After that date, the system closes it automatically.
  {% endcolumn %}

{% column %}
{% hint style="warning" %}
Rails gives advance notice before delisting any asset, so you have time to close positions.
{% endhint %}

<details>

<summary>What happens if I do nothing?</summary>

On the day the asset is delisted, any open positions will be closed by the system if you do not close your position yourself.

</details>

<details>

<summary>Will Rails ever ask for my private keys during an asset delisting?</summary>

No. Rails will never request your private keys - ever.

Always use official channels and be cautious of impersonators.

</details>
{% endcolumn %}
{% endcolumns %}

### Platform & Technical Issues

<details>

<summary>Supported Browsers</summary>

Rails supports major browsers such as Safari, Edge and Firefox, but we recommend Chrome for its wallet-extension support.

Make sure you always maintain the most up to date version of your browser, no matter which one you're using.

</details>

<details>

<summary>Page not Loading or Frozen</summary>

If you are experiencing issues such as your page/chart not loading:

**Clear Cache** and reload the page.

* For Mac Users: <mark style="color:orange;">**`Press Cmd + Shift + R`**</mark>
* For Windows Users: <mark style="color:orange;">**`Press Ctrl + F5`**</mark>

</details>
