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

# Fetch Exchange Rates

> Get current exchange rate for a cryptocurrency

<Note>
  **Auth method: Basic (Access ID)** — this endpoint only requires your
  `x-access-id` header. No request signing is needed. See
  [Authentication](/api-reference/authentication#basic-access-id-authentication).
</Note>

## Path Parameters

<ParamField path="coin" type="string" required>
  Coin identifier

  **Example:** `"bitcoin"`
</ParamField>

## Query Parameters

<ParamField query="currency" type="string">
  Target fiat currency code (optional)

  **Example:** `"ngn"`
</ParamField>

## Headers

<ParamField header="x-access-id" type="string" required>
  Your API access ID provided by Tender

  **Example:** `"your-access-id-here"`
</ParamField>

## Response

<ResponseField name="status" type="string" required>
  Status of the API request

  **Example:** `"success"`
</ResponseField>

<ResponseField name="message" type="string" required>
  Human-readable message describing the result

  **Example:** `"success"`
</ResponseField>

<ResponseField name="data" type="object" required>
  Exchange rate information for the requested coin

  <Expandable title="data properties">
    <ResponseField name="coin" type="string">
      Coin identifier

      **Example:** `"bitcoin"`
    </ResponseField>

    <ResponseField name="usd" type="number">
      Current price in USD

      **Example:** `82752`
    </ResponseField>

    <ResponseField name="rate" type="number">
      Exchange rate to the target currency

      **Example:** `127843151.04`
    </ResponseField>

    <ResponseField name="currency" type="string">
      Target fiat currency code

      **Example:** `"ngn"`
    </ResponseField>
  </Expandable>
</ResponseField>


## OpenAPI

````yaml GET /v1/api/system/rates/{coin}
openapi: 3.1.0
info:
  title: Tender API
  description: Tender Developer API for cryptocurrency payments and agent management
  version: 1.0.0
  contact:
    name: Tender Support
    url: https://tender.cash
servers:
  - url: https://secureapi.tender.cash
    description: Production Server
  - url: https://sandbox-api.tender.cash
    description: Sandbox Server
security:
  - SignedAuth: []
tags:
  - name: Agents
    description: Manage agents and sub-businesses
  - name: Transactions
    description: Payment and transaction operations
  - name: System
    description: System information and configuration
  - name: Webhooks
    description: Webhook management and logs
  - name: On-ramp
    description: Fiat-to-crypto on-ramp operations
  - name: Payouts
    description: Send crypto from merchant balance to a wallet address or payout account
  - name: Subwallets
    description: Provision and manage crypto wallet infrastructure for your end-users
paths:
  /v1/api/system/rates/{coin}:
    get:
      tags:
        - System
      summary: Fetch Exchange Rates
      description: Get current exchange rate for a cryptocurrency
      operationId: getExchangeRates
      parameters:
        - name: coin
          in: path
          required: true
          description: Coin identifier (e.g., bitcoin, ethereum)
          schema:
            type: string
        - name: currency
          in: query
          required: false
          description: Target currency (e.g., ngn, usd)
          schema:
            type: string
        - name: x-access-id
          in: header
          required: true
          description: Your API access ID provided by Tender
          schema:
            type: string
          example: your-access-id-here
      responses:
        '200':
          description: Exchange rate retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExchangeRateResponse'
              example:
                status: success
                message: success
                data:
                  coin: bitcoin
                  usd: 82752
                  rate: 127843151.04
                  currency: ngn
      security:
        - AccessIdAuth: []
components:
  schemas:
    ExchangeRateResponse:
      type: object
      properties:
        status:
          type: string
        message:
          type: string
        data:
          type: object
          properties:
            coin:
              type: string
            usd:
              type: number
            rate:
              type: number
            currency:
              type: string
  securitySchemes:
    SignedAuth:
      type: apiKey
      in: header
      name: authorization
      description: >-
        Signed (HMAC) authentication. Required headers: x-access-id,
        x-request-id (UUID v4), x-timestamp (ISO 8601), and authorization
        (Base64 HMAC-SHA256 signature of {timeStamp, requestId, accessId} using
        your access secret).
    AccessIdAuth:
      type: apiKey
      in: header
      name: x-access-id
      description: >-
        Basic (Access ID) authentication. Only the x-access-id header is
        required; no request signing.

````