> ## Documentation Index
> Fetch the complete documentation index at: https://developers.particle.network/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction to On-Ramp

> D2C fiat-crypto exchanges on your platform

Particle Network offers integration with multiple on-ramp vendors, supporting a wide range of fiat currencies, chains, and cryptocurrencies.

## On-Ramp Overview

By integrating Particle's on-ramp solutions, you can:

* Enable users to purchase cryptocurrencies directly with fiat currency.
* Support a wide array of fiat currencies and cryptocurrencies.
* Provide a seamless onboarding process for new users, increasing engagement and retention.

## Supported Currencies

Particle supports a diverse range of fiat currencies and cryptocurrencies, ensuring broad compatibility with various payment methods.

* **[Supported Fiat Currencies](https://ramp.particle.network/supported_fiat.html)**
* **[Supported Cryptocurrencies](https://ramp.particle.network/supported_cryptocurrencies.html)**

### Live Demos

Explore live demos to see how Particle's On-Ramp solutions work in real-time:

* **[On-Ramp Demo](https://ramp.particle.network/)**
* **[Wallet Demo](https://wallet.particle.network/)**

<Note>Alternatively, access the On-Ramp page directly via the 'Buy' button in the wallet interface.</Note>

## SDK Integration

Integrating the on-ramp feature into your platform allows for extensive customization of the buy/sell experience. Below are the parameters you can use to tailor the user experience:

| Name            | Description                                                                  | Type    |
| --------------- | ---------------------------------------------------------------------------- | ------- |
| `network`       | Blockchain network to be used (e.g., Solana, Ethereum, Binance Smart Chain). | string  |
| `fiatCoin`      | The fiat currency the user wishes to use.                                    | string  |
| `cryptoCoin`    | The cryptocurrency the user wishes to buy or sell.                           | string  |
| `fiatAmt`       | The amount of fiat currency the user wants to spend (for buying crypto).     | number  |
| `cryptAmt`      | The amount of cryptocurrency the user wants to sell.                         | number  |
| `fixFiatCoin`   | Prevent the user from changing the fiat currency.                            | boolean |
| `fixCryptoCoin` | Prevent the user from changing the cryptocurrency.                           | boolean |
| `fixFiatAmt`    | Lock the fiat amount, preventing the user from changing it.                  | boolean |
| `walletAddress` | Wallet address where the purchased cryptocurrency should be sent.            | string  |
| `theme`         | Interface theme: `light` or `dark`.                                          | string  |
| `language`      | Language selection: `en`, `zh-CN`, `zh-TW`, `ja`, `ko`.                      | string  |

## Example usage

To integrate, simply pass the desired options into the SDKs API, or construct a URL with the corresponding parameters.

Below is an example of using the `openBuy` method from the `useAuthCore` hook (from [Particle Auth](/social-logins/auth/desktop-sdks/web)).

```tsx App.tsx theme={null}
  const { address } = useEthereum();
  const { openBuy } = useAuthCore();

  const handleOpenBuy = () => {
    // Example parameters for the buy page
    const options = {
      fiatCoin: "USD",
      fiatAmt: "29.99",
      cryptoCoin: "ETH",
      network: "Ethereum",
      theme: "dark",
      language: "en",
      walletAddress: address, // You can use any address, or leave blank to allow the user to choose
    };

    openBuy(options);
  };
```

### Build an On-Ramp URL

Alternatively, you can manually build a URL with the desired parameters to redirect users directly to the On-Ramp buy page.

```tsx App.tsx theme={null}
  // Parameters
  const fiatCoin = 'USD';
  const cryptoCoin = 'ETH';
  const network = 'Ethereum';
  const theme = 'dark';
  const language = 'en';

  // Function to handle the button click
  const handleOnRamp = () => {
    const onRampUrl = `https://ramp.particle.network/?fiatCoin=${fiatCoin}&cryptoCoin=${cryptoCoin}&network=${network}&theme=${theme}&language=${language}`;
    window.open(onRampUrl, '_blank');
  };
```