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.

​
Live Demos

Explore live demos to see how Particle’s On-Ramp solutions work in real-time:
Alternatively, access the On-Ramp page directly via the ‘Buy’ button in the wallet interface.

​
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:
NameDescriptionType
networkBlockchain network to be used (e.g., Solana, Ethereum, Binance Smart Chain).string
fiatCoinThe fiat currency the user wishes to use.string
cryptoCoinThe cryptocurrency the user wishes to buy or sell.string
fiatAmtThe amount of fiat currency the user wants to spend (for buying crypto).number
cryptAmtThe amount of cryptocurrency the user wants to sell.number
fixFiatCoinPrevent the user from changing the fiat currency.boolean
fixCryptoCoinPrevent the user from changing the cryptocurrency.boolean
fixFiatAmtLock the fiat amount, preventing the user from changing it.boolean
walletAddressWallet address where the purchased cryptocurrency should be sent.string
themeInterface theme: light or dark.string
languageLanguage 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).
App.tsx
  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.
App.tsx
  // 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');
  };