# Supported Fiats

Retrieve a list of supported fiat currencies for the specified transaction type (onramp or offramp).
**Use Cases**:
- Display available fiat currencies to customers during onboarding
- Filter payment methods by fiat currency
- Show fiat options in transaction creation UI
- Validate customer-selected fiat before transaction

**Transaction Types**:
- `onramp` - Returns fiat currencies supported for buying cryptocurrency
- `offramp` - Returns fiat currencies supported for selling cryptocurrency

**Response Structure**: Each fiat currency includes:
- `fiat` - Three-letter ISO 4217 currency code (e.g., "AUD", "USD")
- `name` - Human-readable currency name (e.g., "Australian Dollar")
- `symbol` - Currency symbol (e.g., "$", "€")
- `supportedPaymentMethods` - Array of payment methods available for this fiat

Endpoint: GET /eapi/v0/fiats/{transactionType}
Version: 0 BETA
Security: HMACAuth

## Security:

  - `HMACAuth` (unknown)
    apiKey in header Authorization

## Path parameters:

  - `transactionType` (string, required)
    The type of transaction to retrieve supported fiats for.

**Values**:
- `onramp` - Buying cryptocurrency with fiat
- `offramp` - Selling cryptocurrency for fiat

**Note**: Value is case-insensitive (e.g., `onramp`, `ONRAMP`, `OnRamp` are all valid).

## Response 200:

  - `200` (unknown)
    Successful response with list of supported fiat currencies and their payment methods.

## Response 200 fields (application/json):

  - `fiat` (string, required)
    Three-letter ISO 4217 currency code identifying the fiat currency.
    Example: AUD

  - `name` (string, required)
    Human-readable name of the fiat currency.
    Example: Australian Dollar

  - `symbol` (string, required)
    Symbol used to represent the currency (e.g., $, €, £).
    Example: $

  - `supportedPaymentMethods` (array, required)
    List of payment methods available for this fiat currency. Each method includes transaction limits.

  - `supportedPaymentMethods.method` (string, required)
    Unique identifier for the payment method.
    Example: payid-bank-transfer

  - `supportedPaymentMethods.name` (string, required)
    Human-readable name of the payment method.
    Example: Payid Bank Transfer

  - `supportedPaymentMethods.minimum` (string, required)
    Minimum allowed transaction amount for this payment method in the fiat currency's minor units (e.g., cents for AUD).
    Example: 10

  - `supportedPaymentMethods.maximum` (string, required)
    Maximum allowed transaction amount for this payment method in the fiat currency's minor units.
    Example: 50000

## Response 400:

  - `400` (unknown)
    Bad request due to invalid input.
**Common Causes**:
- Malformed JSON in request body
- Invalid data types
- Missing required fields
- Invalid request structure

## Response 400 fields (application/json):

  - `message` (string)
    Human-readable error message
    Example: Bad Request

  - `code` (integer)
    HTTP status code
    Example: 400

  - `traceId` (string)
    Unique identifier for this error instance. Use this when contacting support.
    Example: 2b6fc5d0-57e4-4b5a-9e3c-6cfbb6d8023f

## Response 401:

  - `401` (unknown)
    Authentication failed or missing credentials.
**Common Causes**:
- Missing Authorization header
- Invalid API key
- Expired or invalid HMAC signature
- Incorrect timestamp (must be within 5 minutes of server time)

## Response 401 fields (application/json):

  - `message` (string)
    Human-readable error message
    Example: Unauthenticated.

  - `code` (integer)
    HTTP status code
    Example: 401

  - `traceId` (string)
    Unique identifier for this error instance
    Example: 2b6fc5d0-57e4-4b5a-9e3c-6cfbb6d8023f

## Response 422:

  - `422` (unknown)
    Validation error - the transactionType path parameter is invalid.
**Common Causes**:
- Supplied value is not `onramp` or `offramp`
- Parameter is missing or empty

## Response 422 fields (application/json):

  - `status` (integer)
    HTTP status code
    Example: 422

  - `message` (string)
    Validation error message
    Example: Invalid transaction type. Must be one of onramp and offramp

  - `errors` (object)
    Map of field names to error messages.
    Example: {"transactionType":["Invalid transaction type. Must be one of onramp and offramp"]}

## Response 429:

  - `429` (unknown)
    Rate limit exceeded.
**Rate Limits**:
- General API: 100 requests per minute
- Price endpoint: 60 requests per minute

**Action**: Wait for the duration specified in `Retry-After` header before retrying.

## Response 429 fields (application/json):

  - `message` (string)
    Human-readable error message
    Example: Too Many Requests. Please try again later.

  - `code` (integer)
    HTTP status code
    Example: 429

  - `traceId` (string)
    Unique identifier for this error instance
    Example: 2b6fc5d0-57e4-4b5a-9e3c-6cfbb6d8023f

## Response 429 headers (application/json):

  - `Retry-After` (integer)
    Number of seconds to wait before retrying.

**Important**: Always respect this header to avoid further rate limiting.
    Example: 60

## Response 500:

  - `500` (unknown)
    Unexpected server error.
**Action**:
- Retry with exponential backoff (up to 3 attempts)
- If error persists, contact support with the traceId

**Note**: This is a temporary issue on our side, not a problem with your request.

## Response 500 fields (application/json):

  - `message` (string)
    Human-readable error message
    Example: Server Error

  - `code` (integer)
    HTTP status code
    Example: 500

  - `traceId` (string)
    Unique identifier for this error instance. **Important**: Include this when contacting support.
    Example: 2b6fc5d0-57e4-4b5a-9e3c-6cfbb6d8023f

## Response 200 examples:

  - `On-ramp supported fiats` (unknown)
    Example response for on-ramp transaction type showing available fiat currencies for buying crypto.

  - `Off-ramp supported fiats` (unknown)
    Example response for off-ramp transaction type showing available fiat currencies for selling crypto.

  - `Empty response` (unknown)
    Response when no payment providers are configured for the merchant.