> ## 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 All Currencies

> Retrieve all supported currencies with their chain mappings

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

## 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="array" required>
  Array of all supported currencies across all chains

  <Expandable title="currency object">
    <ResponseField name="_id" type="string">
      Unique MongoDB identifier for the currency

      **Example:** `"64fc4cda43812c15552311d7"`
    </ResponseField>

    <ResponseField name="id" type="string">
      Unique identifier for the currency

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

    <ResponseField name="name" type="string">
      Display name of the currency

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

    <ResponseField name="icon" type="string">
      URL to the currency's icon image

      **Example:** `"https://secureapi.tender.cash/icons/usdc.png"`
    </ResponseField>

    <ResponseField name="isContract" type="boolean">
      Whether this is a smart contract token

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

    <ResponseField name="chains" type="array">
      Array of chains where this currency is available

      **Example:** `["avalanche", "ethereum", "polygon", "solana"]`
    </ResponseField>

    <ResponseField name="priceTag" type="string">
      Price identifier for market data

      **Example:** `"usd-coin"`
    </ResponseField>

    <ResponseField name="fee" type="object">
      Fee configuration per chain

      **Example:** `{ "ethereum": "25", "polygon": "3" }`
    </ResponseField>

    <ResponseField name="symbol" type="string">
      Currency symbol

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

    <ResponseField name="status" type="string">
      Current status of the currency

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

    <ResponseField name="contractAddress" type="object">
      Smart contract addresses per chain

      <Expandable title="contract addresses">
        <ResponseField name="ethereum" type="string">
          Contract address on Ethereum

          **Example:** `"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"`
        </ResponseField>

        <ResponseField name="polygon" type="string">
          Contract address on Polygon

          **Example:** `"0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174"`
        </ResponseField>

        <ResponseField name="avalanche" type="string">
          Contract address on Avalanche

          **Example:** `"0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E"`
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="activationFee" type="object">
      Activation fees per chain (if applicable)

      **Example:** `{ "stellar": "1.1" }`
    </ResponseField>

    <ResponseField name="walletApps" type="array">
      Compatible wallet applications

      **Example:** `["beam"]`
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      ISO 8601 timestamp when the currency was added

      **Example:** `"2023-09-05T19:29:57.194Z"`
    </ResponseField>

    <ResponseField name="updatedAt" type="string">
      ISO 8601 timestamp when the currency was last updated

      **Example:** `"2024-08-03T23:02:51.067Z"`
    </ResponseField>
  </Expandable>
</ResponseField>


## OpenAPI

````yaml GET /v1/api/system/currency
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/currency:
    get:
      tags:
        - System
      summary: Fetch All Currencies
      description: Get all available currencies with their supported chains
      operationId: getAllCurrencies
      parameters:
        - 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: Currencies retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CurrenciesResponse'
      security:
        - AccessIdAuth: []
components:
  schemas:
    CurrenciesResponse:
      type: object
      properties:
        status:
          type: string
        message:
          type: string
        data:
          type: array
          items:
            $ref: '#/components/schemas/Currency'
    Currency:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the currency
        name:
          type: string
        icon:
          type: string
        isContract:
          type: boolean
        chains:
          type: array
          items:
            type: string
        priceTag:
          type: string
        fee:
          type: object
        symbol:
          type: string
        status:
          type: string
        contractAddress:
          type: object
  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.

````