> ## 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 On-ramp Coins

> List cryptocurrencies available for on-ramp delivery, optionally filtered by chain

<Note>
  **Auth method: Signed (HMAC)** — this endpoint requires the full set of signed
  headers: `x-access-id`, `x-request-id`, `x-timestamp`, and an HMAC-SHA256
  `authorization` signature. See [Authentication](/api-reference/authentication#signed-hmac-authentication).
</Note>

## Headers

<ParamField header="authorization" type="string" required>
  Base64-encoded HMAC-SHA256 signature using your API secret
</ParamField>

<ParamField header="x-timestamp" type="string" required>
  **Example:** `"2025-03-15T09:45:53.000Z"`
</ParamField>

<ParamField header="x-request-id" type="string" required>
  **Example:** `"550e8400-e29b-41d4-a716-446655440000"`
</ParamField>

<ParamField header="x-access-id" type="string" required>
  **Example:** `"your-access-id-here"`
</ParamField>

## Query Parameters

<ParamField query="chain" type="string">
  Filter coins to those supported on a specific chain. Must match a chain `id` from
  [Fetch On-ramp Chains](/api-reference/endpoint/onramp/chains).

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

## Response

<ResponseField name="status" type="string" required>
  **Example:** `"success"`
</ResponseField>

<ResponseField name="message" type="string" required>
  **Example:** `"success"`
</ResponseField>

<ResponseField name="data" type="array" required>
  Array of supported coins

  <Expandable title="coin object">
    <ResponseField name="id" type="string">
      Coin identifier — use as `targetCurrency` in Initiate On-ramp

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

    <ResponseField name="name" type="string">
      **Example:** `"Tether USD"`
    </ResponseField>

    <ResponseField name="symbol" type="string">
      **Example:** `"USDT"`
    </ResponseField>

    <ResponseField name="icon" type="string">
      **Example:** `"https://cdn.tender.cash/coins/usdt.png"`
    </ResponseField>

    <ResponseField name="chains" type="array">
      Chain IDs this coin is available on

      **Example:** `["tron", "ethereum"]`
    </ResponseField>

    <ResponseField name="isContract" type="boolean">
      Whether this is an ERC-20 / TRC-20 token

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

    <ResponseField name="isStableCoin" type="boolean">
      **Example:** `true`
    </ResponseField>
  </Expandable>
</ResponseField>


## OpenAPI

````yaml GET /v1/api/onramp/coins
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/onramp/coins:
    get:
      tags:
        - On-ramp
      summary: Fetch On-ramp Coins
      description: >-
        List cryptocurrencies available for on-ramp delivery. Optionally filter
        by chain.
      operationId: fetchOnrampCoins
      parameters:
        - name: authorization
          in: header
          required: true
          schema:
            type: string
        - name: x-timestamp
          in: header
          required: true
          schema:
            type: string
            format: date-time
        - name: x-request-id
          in: header
          required: true
          schema:
            type: string
            format: uuid
        - name: x-access-id
          in: header
          required: true
          schema:
            type: string
        - name: chain
          in: query
          required: false
          description: Filter to coins supported on this chain ID
          schema:
            type: string
          example: tron
      responses:
        '200':
          description: List of on-ramp coins
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                  message:
                    type: string
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/OnrampCoin'
              example:
                status: success
                message: success
                data:
                  - id: usdt
                    name: Tether USD
                    symbol: USDT
                    icon: https://cdn.tender.cash/coins/usdt.png
                    chains:
                      - tron
                      - ethereum
                    isContract: true
                    isStableCoin: true
      security:
        - SignedAuth: []
components:
  schemas:
    OnrampCoin:
      type: object
      properties:
        id:
          type: string
          example: usdt
        name:
          type: string
          example: Tether USD
        symbol:
          type: string
          example: USDT
        icon:
          type: string
        chains:
          type: array
          items:
            type: string
          example:
            - tron
            - ethereum
        isContract:
          type: boolean
          example: true
        isStableCoin:
          type: boolean
          example: true
  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).

````