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

# Search known tokens or look up an exact address

> No API key required. 60 requests per minute per caller, with separate shared data capacity. Search covers listed tokens or an exact contract address. Balances cover listed and selected tokens, not every wallet asset, and report partial failures. Transaction status reports chain inclusion and finality; not_found is not proof a transaction was never submitted. It does not verify a swap against its quote.

No API key required.

[API overview](/api-reference/overview)


## OpenAPI

````yaml openapi.json GET /api/v2/tokens/search
openapi: 3.1.0
info:
  title: route
  version: 2.15.0
  description: >-
    Route compares swap paths offchain and executes swaps on Robinhood Chain.
    The API returns quotes and unsigned transactions. It does not sign or submit
    for you. V2 deducts a disclosed pair-dependent output fee up to 0.50%; pool
    fees, provider charges and gas may still apply. Contracts are experimental
    and unaudited. Public routing and data endpoints require no API key. Use the
    documented /api/v2 endpoints for integrations. Builder endpoints require a
    scoped x-api-key from build.route.fun. Public quote, swap and data endpoints
    remain keyless.
servers:
  - url: https://api.route.fun
security: []
paths:
  /api/v2/tokens/search:
    get:
      tags:
        - Data
      summary: Search known tokens or look up an exact address
      description: >-
        No API key required. 60 requests per minute per caller, with separate
        shared data capacity. Search covers listed tokens or an exact contract
        address. Balances cover listed and selected tokens, not every wallet
        asset, and report partial failures. Transaction status reports chain
        inclusion and finality; not_found is not proof a transaction was never
        submitted. It does not verify a swap against its quote.
      operationId: searchTokens
      parameters:
        - in: query
          name: query
          schema:
            type: string
            maxLength: 80
        - in: query
          name: limit
          schema:
            type: integer
            minimum: 1
            maximum: 50
            default: 20
      responses:
        '200':
          description: Data response; see developer data guide for coverage and fields
          content:
            application/json:
              schema:
                type: object
                properties:
                  tokens:
                    type: array
                    items:
                      type: object
                      properties:
                        address:
                          type: string
                        name:
                          type: string
                        symbol:
                          type: string
                        decimals:
                          type: integer
                        verified:
                          type: boolean
                  coverage:
                    enum:
                      - listed-tokens
                      - address-lookup
                  hasMore:
                    type: boolean
        '400':
          description: Invalid query or address
        '409':
          description: Chain reorganization; retry status
        '429':
          description: Data lane capacity exceeded; observe Retry-After
        '503':
          description: Data source unavailable
      security: []

````