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

# Get Wallet Currencies

> Returns the list of on-chain and fiat currencies available in the authenticated user's wallet.

Each entry includes basic metadata (ticker, name, symbol, decimals, categories) and the `actions` supported for that currency, expressed in the public rail vocabulary. Results are filtered by the user's country and KYC level.

Each item in `actions` describes one `transaction_type` (`deposit`, `withdrawal` or `swap`) and the `rails` that serve it for this currency. `rails` is a subset of `bank`, `pix`, `crypto`, `ripio`; `swap` has no rail and is always returned as an empty array. A currency whose internal actions have no public equivalent is returned with `actions: []` (it still appears in the list).

Supports optional search by ticker or name via the `search` query parameter.

---

**Authorization**

- Requires a valid API key.



## OpenAPI

````yaml get /wallet/currencies/
openapi: 3.0.0
info:
  title: Ripio Gateway
  description: Ripio API - Services documentation.
  version: 0.1.0
  x-logo:
    url: https://cwstatic.nyc3.digitaloceanspaces.com/1996/bitcointrade.png
servers:
  - url: https://api.ripio.com
    description: Production environment
security: []
paths:
  /wallet/currencies/:
    get:
      tags:
        - Ripio Wallet
      summary: currencies - Get wallet currencies
      description: >-
        Returns the list of on-chain and fiat currencies available in the
        authenticated user's wallet.


        Each entry includes basic metadata (ticker, name, symbol, decimals,
        categories) and the `actions` supported for that currency, expressed in
        the public rail vocabulary. Results are filtered by the user's country
        and KYC level.


        Each item in `actions` describes one `transaction_type` (`deposit`,
        `withdrawal` or `swap`) and the `rails` that serve it for this currency.
        `rails` is a subset of `bank`, `pix`, `crypto`, `ripio`; `swap` has no
        rail and is always returned as an empty array. A currency whose internal
        actions have no public equivalent is returned with `actions: []` (it
        still appears in the list).


        Supports optional search by ticker or name via the `search` query
        parameter.


        ---


        **Authorization**


        - Requires a valid API key.
      parameters:
        - in: header
          name: authorization
          required: true
          description: The API key as a string.
          schema:
            type: string
        - in: header
          name: signature
          required: true
          description: >-
            See the [Generating
            Signature](/static/api/authentication#generating-signature) section
            for more details.
          schema:
            type: string
        - in: header
          name: timestamp
          required: true
          description: >-
            A timestamp in milliseconds. See the [Timestamp
            Security](/static/api/authentication#timestamp-security) section for
            more details.
          schema:
            type: number
        - in: header
          name: timstamp-tolerance
          required: false
          description: >-
            An additional, non-required parameter, that you can send to specify
            the number of milliseconds after the timestamp for the request to be
            valid. See the [Timestamp
            Security](/static/api/authentication#timestamp-security) section for
            more details.
          schema:
            type: number
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                description: Wallet currencies retrieved successfully.
                properties:
                  error_code:
                    type: string
                    example: null
                  message:
                    type: string
                    example: null
                  data:
                    description: List of wallet currency objects.
                    items:
                      description: >-
                        Currency object returned by `GET currencies/`.
                        Allowlist-based (DT-002): only these fields are exposed,
                        no internal jargon (raw gateways, raw actions) leaks
                        through.
                      properties:
                        ticker:
                          description: Currency ticker.
                          type: string
                          example: BTC
                        name:
                          description: Display name of the currency.
                          type: string
                          example: Bitcoin
                        symbol:
                          description: Currency symbol.
                          type: string
                          example: ₿
                        decimals:
                          description: Number of decimal places used by the currency.
                          type: integer
                          example: 8
                        type:
                          description: Whether the currency is on-chain crypto or fiat.
                          type: string
                          example: crypto
                        color:
                          description: Brand color for the currency, as a hex string.
                          type: string
                          example: '#F7931A'
                        categories:
                          description: Categories the currency belongs to.
                          items:
                            type: string
                          type: array
                          example:
                            - crypto
                        currency_balance_id:
                          description: >-
                            Internal Ripio currency balance ID. Same identifier
                            used elsewhere in the gateway (e.g.
                            `GatewayCurrencyNetwork.currency_balance_id`).
                          type: integer
                          example: 1
                        is_favorite:
                          description: >-
                            Whether the authenticated user has marked this
                            currency as a favorite.
                          type: boolean
                          example: false
                        new:
                          description: >-
                            Whether the currency is flagged as newly added to
                            the wallet.
                          type: boolean
                          example: false
                        actions:
                          description: >-
                            Supported operations for this currency, grouped by
                            public transaction type. Empty when none of the
                            currency's internal actions map to the public triad
                            (the currency still appears in the list).
                          items:
                            description: >-
                              One supported operation for a wallet currency,
                              expressed in the public rail vocabulary
                              (`transaction_type` + `rails`). Internal actions
                              and gateways without a public equivalent (e.g.
                              buy/sell/pay/defi) are omitted rather than exposed
                              raw.
                            properties:
                              transaction_type:
                                description: Canonical public transaction type.
                                type: string
                                example: withdrawal
                              enabled:
                                description: >-
                                  Whether this transaction type is currently
                                  enabled for the currency.
                                type: boolean
                                example: true
                              rails:
                                description: >-
                                  Canonical rails serving this transaction type
                                  for this currency. Always empty for `swap`,
                                  which has no rail.
                                items:
                                  type: string
                                type: array
                                example:
                                  - crypto
                                  - ripio
                            required:
                              - transaction_type
                              - enabled
                              - rails
                            type: object
                          type: array
                      required:
                        - ticker
                        - name
                        - symbol
                        - decimals
                        - type
                        - color
                        - categories
                        - currency_balance_id
                        - is_favorite
                        - new
                        - actions
                      type: object
                    type: array
                required:
                  - error_code
                  - message
                  - data
                type: object
                example:
                  error_code: null
                  message: null
                  data:
                    - ticker: BTC
                      name: Bitcoin
                      symbol: ₿
                      decimals: 8
                      type: crypto
                      color: '#F7931A'
                      categories:
                        - crypto
                      currency_balance_id: 1
                      is_favorite: false
                      new: false
                      actions:
                        - transaction_type: deposit
                          enabled: true
                          rails:
                            - crypto
                            - ripio
                        - transaction_type: withdrawal
                          enabled: true
                          rails:
                            - crypto
                            - ripio
                        - transaction_type: swap
                          enabled: true
                          rails: []
                    - ticker: ARS
                      name: Peso Argentino
                      symbol: $
                      decimals: 2
                      type: fiat
                      color: '#74ACDF'
                      categories:
                        - fiat
                      currency_balance_id: 2
                      is_favorite: false
                      new: false
                      actions:
                        - transaction_type: deposit
                          enabled: true
                          rails:
                            - bank
                        - transaction_type: withdrawal
                          enabled: true
                          rails:
                            - bank
        '401':
          description: Error response 401
        '403':
          description: Error response 403

````