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

# Get Currencies

Retrieve all currencies enabled for your account, with the code to use elsewhere in the API.

> [!NOTE]
>
> Call this before creating a transfer request or a recipient rather than
> hardcoding currency codes. The list is scoped to your account, so it reflects
> exactly what your API key may transact in.


## OpenAPI

````yaml GET /v1/currencies
openapi: 3.1.0
info:
  title: Hashrails API
  description: >-
    Comprehensive API documentation for Hashrails – easily create, manage, and
    query virtual accounts, recipients, and bank integrations. Secure, scalable,
    and developer-friendly.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.staging.railsfromthecrypt.com
  - url: https://api.hashrails.com
security:
  - bearerAuth: []
paths:
  /v1/currencies:
    get:
      tags:
        - Public Currencies
      summary: Get all currencies
      operationId: PublicCurrencyController_
      parameters:
        - name: type
          required: false
          in: query
          description: Return only fiat or only crypto currencies. Omit for both.
          schema:
            enum:
              - fiat
              - crypto
            type: string
        - name: direction
          required: false
          in: query
          description: >-
            Return only currencies you can pay in (onramp) or be paid out in
            (offramp). Omit for both.
          schema:
            enum:
              - onramp
              - offramp
            type: string
      responses:
        '200':
          description: Currencies retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: Currencies retrieved successfully
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/PublicCurrencyResponseDto'
              example:
                success: true
                message: Currencies retrieved successfully
                data:
                  - code: NGN
                    name: Nigerian Naira
                    type: fiat
                  - code: KES
                    name: Kenyan Shilling
                    type: fiat
                  - code: GHS
                    name: Ghanaian Cedi
                    type: fiat
                  - code: ZAR
                    name: South African Rand
                    type: fiat
                  - code: USDT
                    name: Tether
                    type: crypto
                  - code: USDC
                    name: USD Coin
                    type: crypto
        '400':
          description: Bad request - unknown direction
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                    example: direction must be onramp or offramp
        '401':
          description: Unauthorized - Invalid API key
components:
  schemas:
    PublicCurrencyResponseDto:
      type: object
      properties:
        code:
          type: string
          example: NGN
          description: The value to send as a currency in other requests
        name:
          type: string
          example: Nigerian Naira
        type:
          type: string
          enum:
            - fiat
            - crypto
          example: fiat
      required:
        - code
        - name
        - type
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Your JWT access token from [Issue
        Token](/api-reference/auth/issue-token).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.