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

# Get Coins

> Returns the list of supported cryptocurrencies and their networks



## OpenAPI

````yaml GET /coins
openapi: 3.1.0
info:
  title: Bestflow API
  description: >-
    Bestflow is a cryptocurrency exchange aggregator that provides cross-chain
    swap capabilities without any additional fees. It aggregates multiple
    exchanges to offer users the best rates and seamless cryptocurrency swaps
    across different networks.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.bestflow.xyz
security:
  - {}
  - bearerAuth: []
paths:
  /coins:
    get:
      description: Returns the list of supported cryptocurrencies and their networks
      responses:
        '200':
          description: List of supported tokens
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Token'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '503':
          $ref: '#/components/responses/ServiceUnavailableError'
components:
  schemas:
    Token:
      type: object
      required:
        - currency
        - name
        - logo
        - networks
      properties:
        currency:
          type: string
          description: The currency ticker symbol
          example: ETH
        name:
          type: string
          description: The full name of the cryptocurrency
          example: Ethereum
        logo:
          type: string
          description: URL to the currency's logo image
          example: >-
            https://cdn.jsdelivr.net/gh/bestflow-exchange/assets@main/coins/ethereum.svg
        networks:
          type: array
          description: List of supported networks for this currency
          items:
            $ref: '#/components/schemas/TokenNetwork'
    TokenNetwork:
      type: object
      required:
        - network
        - contract
        - memo
      properties:
        network:
          type: string
          description: The network identifier
          example: ETH
        contract:
          type:
            - string
            - 'null'
          description: Smart contract address for tokens; null for native coins
          example: null
        memo:
          type: boolean
          description: Whether this network expects a memo/tag for deposits
          example: false
        explorer:
          type: string
          description: Base URL of the blockchain explorer
          example: https://etherscan.io
        explorerHash:
          type: string
          description: URL template for viewing transactions ({{txid}} placeholder)
          example: https://etherscan.io/tx/{{txid}}
        explorerAddress:
          type: string
          description: URL template for viewing addresses ({{addr}} placeholder)
          example: https://etherscan.io/address/{{addr}}
        explorerContract:
          type: string
          description: URL template for viewing smart contracts ({{contr}} placeholder)
          example: https://etherscan.io/token/{{contr}}
    Error:
      type: object
      required:
        - error
        - message
      properties:
        error:
          type: string
          description: Error code
          enum:
            - VALIDATION_ERROR
            - INVALID_FORMAT
            - UNKNOWN_EXCHANGE
            - SWAP_ERROR
            - SWAP_NOT_FOUND
            - UNAUTHORIZED
            - RATE_LIMITED
            - SERVICE_UNAVAILABLE
        message:
          type: string
          description: Human-readable error message
  responses:
    UnauthorizedError:
      description: Invalid or unknown API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: UNAUTHORIZED
            message: Invalid API key
    ServiceUnavailableError:
      description: Auth dependency unavailable
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: SERVICE_UNAVAILABLE
            message: Auth service unavailable
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Optional Bearer authentication using an API key provided as a Bearer
        token. Required for unlimited requests and revenue sharing.

````