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

# List tokens on a chain

> Returns every token PAJ has on record for the given chain, sorted by symbol. The list holds tokens that have already been looked up, so a token missing here can still be fetched by address with GET /pub/v2/tokens/{address}.

Returns the tokens Paj has on record for one chain, sorted by symbol. `chain`
is required and takes the same values as [Get chains](https://docs.paj.cash/api-reference/get-chains.md).

The list holds tokens Paj has already looked up — the stablecoins, popular
tokens, and anything a partner or payer has asked about before. It is not every
token that exists on the chain. If the token you want is missing, fetch it by
address with [Get a token](https://docs.paj.cash/api-reference/get-token.md); after that it shows up
here too.

There is no pagination.


## OpenAPI

````yaml GET /pub/v2/tokens
openapi: 3.0.0
info:
  title: Paj Public API
  description: >-
    Programmatic access to Paj's on/off ramp. Register a Nigerian bank account,
    get

    the on-chain address that pays it, create offramp orders for a specific
    amount,

    and read the live conversion rates.


    Every request must carry an `x-api-key` header. Keys are scoped to a
    business,

    and the rates you receive already have that business's fee applied.
  version: 2.0.0
  contact: {}
servers:
  - url: https://api.paj.cash
    description: Production
security: []
tags: []
paths:
  /pub/v2/tokens:
    get:
      tags:
        - Pub V2
      summary: List tokens on a chain
      description: >-
        Returns every token PAJ has on record for the given chain, sorted by
        symbol. The list holds tokens that have already been looked up, so a
        token missing here can still be fetched by address with GET
        /pub/v2/tokens/{address}.
      operationId: PubV2Controller_getTokens
      parameters:
        - name: chain
          required: true
          in: query
          description: Chain the token lives on
          schema:
            type: string
            enum:
              - SOLANA
              - MONAD
              - ETHEREUM
              - BSC
              - BASE
              - ARC
              - ZCASH
              - SUI
              - NEAR
              - TON
              - ROBINHOOD
            example: SOLANA
      responses:
        '200':
          description: The tokens on the chain
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TokenResDto'
        '400':
          description: Missing or unknown chain
        '401':
          description: Missing or invalid API key (x-api-key header)
      security:
        - x-api-key: []
components:
  schemas:
    TokenResDto:
      type: object
      properties:
        chain:
          type: string
          enum:
            - SOLANA
            - MONAD
            - ETHEREUM
            - BSC
            - BASE
            - ARC
            - ZCASH
            - SUI
            - NEAR
            - TON
            - ROBINHOOD
          example: SOLANA
        address:
          type: string
          description: >-
            Mint (Solana), contract address (EVM), jetton master (TON) or coin
            type (Sui)
          example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
        name:
          type: string
          example: USD Coin
        symbol:
          type: string
          example: USDC
        decimals:
          type: number
          nullable: true
          example: 6
        logo:
          type: string
          nullable: true
          description: Logo URL, when the chain provides one
          example: https://...
      required:
        - chain
        - address
        - name
        - symbol
        - decimals
        - logo
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key

````

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