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

# Indicative fiat vs USD rates

> Returns **indicative** ``buy`` / ``sell`` rates for the requested ISO fiat codes — **not** a binding quote (use ``POST /partner/orders/quote`` for checkout pricing). Response body: ``requested``, ``rates``, ``fetched_at``. **Auth:** ``X-API-Key``.

Returns **indicative** `buy` / `sell` rates for comma-separated ISO fiat codes.

<Warning>
  These rates are **not** binding. Use [`POST /partner/orders/quote`](/partner/orders/quote) for checkout pricing.
</Warning>

Response `data` includes `requested`, `rates`, and `fetched_at`.

**Auth:** `X-API-Key` header.


## OpenAPI

````yaml /api-reference/openapi.json get /partner/rates/indicative
openapi: 3.1.0
info:
  title: Element Pay Partner API
  description: >-
    Provider-neutral fiat ↔ crypto ramps for partners. Discover corridors,
    create a binding quote, accept it, and receive webhooks. African local fiat
    (mobile money and bank) is auto-routed by corridor.
  version: 1.0.0
servers:
  - url: https://sandbox.elementpay.net/api/v1
    description: Sandbox
security:
  - APIKeyHeader: []
tags:
  - name: partner
    description: >-
      Corridor discovery, indicative rates, binding quotes, and order acceptance
      (including account currency conversion).
    x-group: Partner
  - name: partner-customers
    description: >-
      Vault KYC: requirements, create, list, get/update, documents, and submit
      (pcus_*).
    x-group: Customers
  - name: partner-customer-accounts
    description: >-
      Customer accounts and funding: open/list/get rails, deposit instructions,
      stablecoin sends, and same-currency fiat book transfers.
    x-group: Customer accounts
paths:
  /partner/rates/indicative:
    get:
      tags:
        - partner
      summary: Indicative fiat vs USD rates
      description: >-
        Returns **indicative** ``buy`` / ``sell`` rates for the requested ISO
        fiat codes — **not** a binding quote (use ``POST /partner/orders/quote``
        for checkout pricing). Response body: ``requested``, ``rates``,
        ``fetched_at``. **Auth:** ``X-API-Key``.
      operationId: partner_indicative_rates_partner_rates_indicative_get
      parameters:
        - name: fiat
          in: query
          required: true
          schema:
            type: string
            description: Comma-separated ISO 4217 codes (e.g. `NGN,KES,GHS`).
            examples:
              - NGN,KES,GHS
            title: Fiat
          description: Comma-separated ISO 4217 codes (e.g. `NGN,KES,GHS`).
      responses:
        '200':
          description: Indicative fiat vs USD rates (non-binding)
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - message
                properties:
                  status:
                    type: string
                    enum:
                      - success
                  message:
                    type: string
                  data:
                    type: object
              example:
                status: success
                message: Indicative rates (non-binding)
                data:
                  requested:
                    - KES
                    - NGN
                    - UGX
                  fetched_at: '2026-07-07T10:00:00Z'
                  rates:
                    - currency: KES
                      buy: 131.5
                      sell: 128
                    - currency: NGN
                      buy: 1580
                      sell: 1550
              examples:
                kes_ngn_ugx:
                  summary: East Africa tickers
                  value:
                    status: success
                    message: Indicative rates (non-binding)
                    data:
                      requested:
                        - KES
                        - NGN
                        - UGX
                      fetched_at: '2026-07-07T10:00:00Z'
                      rates:
                        - currency: KES
                          buy: 131.5
                          sell: 128
                        - currency: NGN
                          buy: 1580
                          sell: 1550
        '400':
          description: Invalid `fiat` query parameter
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - message
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  message:
                    type: string
                  data:
                    type:
                      - object
                      - 'null'
                    properties:
                      field:
                        type: string
                      country:
                        type: string
                      currency:
                        type: string
                      upstream_http_status:
                        type: integer
              example:
                status: error
                message: >-
                  Invalid fiat code 'XX'; use three-letter ISO 4217 codes (e.g.
                  NGN,KES).
                data:
                  field: fiat
              examples:
                invalid_fiat_code:
                  summary: Unrecognized ISO code
                  value:
                    status: error
                    message: >-
                      Invalid fiat code 'XX'; use three-letter ISO 4217 codes
                      (e.g. NGN,KES).
                    data:
                      field: fiat
        '422':
          description: Missing required query parameters
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - message
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  message:
                    type: string
                  data:
                    type:
                      - object
                      - 'null'
                    properties:
                      field:
                        type: string
                      country:
                        type: string
                      currency:
                        type: string
                      upstream_http_status:
                        type: integer
              example:
                status: error
                message: Query parameter `fiat` is required (e.g. fiat=NGN,KES,GHS).
                data:
                  field: fiat
              examples:
                missing_fiat:
                  summary: fiat query param omitted
                  value:
                    status: error
                    message: >-
                      Query parameter `fiat` is required (e.g.
                      fiat=NGN,KES,GHS).
                    data:
                      field: fiat
        '502':
          description: Upstream discovery temporarily unavailable
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - message
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  message:
                    type: string
                  data:
                    type:
                      - object
                      - 'null'
                    properties:
                      field:
                        type: string
                      country:
                        type: string
                      currency:
                        type: string
                      upstream_http_status:
                        type: integer
              example:
                status: error
                message: Quote request failed
                data:
                  upstream_http_status: 502
              examples:
                upstream_unavailable:
                  summary: Discovery upstream error
                  value:
                    status: error
                    message: Quote request failed
                    data:
                      upstream_http_status: 502
      security:
        - APIKeyHeader: []
components:
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key

````