Skip to main content
POST
/
rpc
/
Trails
/
GetFiatCurrencyList
GetFiatCurrencyList returns the list of supported fiat currencies for display preferences.
curl --request POST \
  --url https://trails-api.sequence.app/rpc/Trails/GetFiatCurrencyList \
  --header 'Content-Type: application/json' \
  --data '{}'
{
  "currencies": [
    {
      "code": "<string>",
      "symbol": "<string>",
      "name": "<string>",
      "flag": "<string>",
      "decimals": 123
    }
  ]
}

​
Overview

The GetFiatCurrencyList endpoint returns the list of fiat currencies supported for onramp and fiat-denominated displays. Use this to populate currency selectors in fund flows and onramp integrations.

​
Use Cases

  • Build a currency picker for onramp flows
  • Display flags and symbols for supported currencies
  • Validate that a user’s local currency is supported before showing fiat input options

​
Request Parameters

This endpoint takes no parameters — send an empty request body.

​
Response

  • currencies (FiatCurrency[]): Array of supported fiat currency objects

​
FiatCurrency Object Structure

Each currency includes:
  • code (string): ISO 4217 currency code (e.g. "USD", "EUR", "GBP")
  • symbol (string): Currency symbol (e.g. "$", "€", "£")
  • name (string): Full currency name (e.g. "US Dollar")
  • flag (string): Emoji flag for the currency’s primary country
  • decimals (number): Number of decimal places for display

​
Examples

​
Get All Supported Currencies

const response = await fetch('https://trails-api.sequence.app/rpc/Trails/GetFiatCurrencyList', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Access-Key': 'YOUR_ACCESS_KEY'
  },
  body: JSON.stringify({})
});

const { currencies } = await response.json();

currencies.forEach(c => {
  console.log(`${c.flag} ${c.name} (${c.code}): ${c.symbol}`);
});

​
Build a Currency Selector

import { useEffect, useState } from 'react';

interface FiatCurrency {
  code: string;
  symbol: string;
  name: string;
  flag: string;
  decimals: number;
}

export const CurrencySelector = ({
  onSelect
}: {
  onSelect: (code: string) => void;
}) => {
  const [currencies, setCurrencies] = useState<FiatCurrency[]>([]);

  useEffect(() => {
    fetch('https://trails-api.sequence.app/rpc/Trails/GetFiatCurrencyList', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'X-Access-Key': 'YOUR_ACCESS_KEY'
      },
      body: JSON.stringify({})
    })
      .then(res => res.json())
      .then(({ currencies }) => setCurrencies(currencies));
  }, []);

  return (
    <select onChange={(e) => onSelect(e.target.value)}>
      {currencies.map(c => (
        <option key={c.code} value={c.code}>
          {c.flag} {c.name} ({c.code})
        </option>
      ))}
    </select>
  );
};

​
Next Steps

GetExchangeRate

Get live exchange rates for a currency

Fund Mode

Use fiat currencies in the fund widget

Body

application/json

The body is of type object.

Response

OK

​
currencies
object[]

[]FiatCurrency