GetFiatCurrencyList

POST /rpc/Trails/GetFiatCurrencyList

GetFiatCurrencyList returns the list of supported fiat currencies for display preferences.

cURL

curl --request POST \
  --url https://api.example.com/rpc/Trails/GetFiatCurrencyList \
  --header 'Content-Type: application/json' \
  --data '{}'

200

{
  "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

200

application/json

OK

currencies · object[]

[]FiatCurrency

Show child attributes