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

# Search tokens



## OpenAPI

````yaml https://api-partner.houdiniswap.com/v2/openapi.json get /tokens
openapi: 3.0.0
info:
  title: houdiniswap-backend
  version: 2.1.1
  description: Houdiniswap Backend
  license:
    name: ISC
  contact: {}
servers:
  - url: https://api-partner.houdiniswap.com/v2
security: []
paths:
  /tokens:
    get:
      tags:
        - Tokens
      summary: Search tokens
      operationId: GetTokens
      parameters:
        - description: Number of results to return per page
          in: query
          name: pageSize
          required: false
          schema:
            default: 1000
            format: double
            type: number
            maximum: 1000
            minimum: 1
        - in: query
          name: page
          required: false
          schema:
            default: 1
            format: double
            type: number
            minimum: 1
            maximum: 10000
        - description: >-
            Search term that matches against name, symbol, address, keyword,
            cexTokenId fields
          in: query
          name: term
          required: false
          schema:
            type: string
            maxLength: 100
        - description: >-
            Filter by chain. Matches against token.chainData.shortName, e.g.
            "ethereum"
          in: query
          name: chain
          required: false
          schema:
            type: string
        - description: Filter native/non-native tokens
          in: query
          name: mainnet
          required: false
          schema:
            type: boolean
        - description: Filter tokens that support/don't support CEX swaps
          in: query
          name: hasCex
          required: false
          schema:
            type: boolean
        - description: Filter tokens that support/don't support DEX swaps
          in: query
          name: hasDex
          required: false
          schema:
            type: boolean
        - description: Filter tokens by contract address
          in: query
          name: address
          required: false
          schema:
            type: string
        - description: Filter tokens by symbol, matches against token.symbol field
          in: query
          name: symbol
          required: false
          schema:
            type: string
        - description: >-
            Include tokens that are auto-created from addresses and pending
            manual verification. Excluded by default.
          in: query
          name: unverified
          required: false
          schema:
            type: boolean
            default: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TokenSearchResult'
        '422':
          description: Validation Failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationError'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - apiKey: []
components:
  schemas:
    TokenSearchResult:
      properties:
        tokens:
          items:
            $ref: '#/components/schemas/Token'
          type: array
        total:
          type: number
          format: double
        totalPages:
          type: number
          format: double
      required:
        - tokens
        - total
        - totalPages
      type: object
      additionalProperties: false
    ValidationError:
      properties:
        message:
          type: string
        code:
          type: string
        requestId:
          type: string
        fields:
          $ref: '#/components/schemas/FieldErrors'
      required:
        - message
        - code
        - fields
      type: object
      additionalProperties: false
    ErrorResponse:
      properties:
        message:
          type: string
        code:
          type: string
        requestId:
          type: string
      required:
        - message
        - code
      type: object
      additionalProperties: false
    Token:
      properties:
        icon:
          type: string
        id:
          type: string
        address:
          type: string
          nullable: true
        chain:
          type: string
        decimals:
          type: number
          format: double
          default: 0
        symbol:
          type: string
          default: ''
        name:
          type: string
          default: ''
        created:
          type: string
          format: date-time
        modified:
          type: string
          format: date-time
        chainData:
          $ref: '#/components/schemas/Chain'
        description:
          type: string
          nullable: true
        mainnet:
          type: boolean
        enabled:
          type: boolean
        unverified:
          type: boolean
        hasDex:
          type: boolean
        hasCex:
          type: boolean
        hasSelfPrivate:
          type: boolean
          description: >-
            Indicates if token supports private (self-to-self) swaps.

            Stored field computed when token is saved.

            True when token has CEX support AND at least 2 enabled CEX swap
            provider mappings.
        cexTokenId:
          type: string
          default: ''
        rank:
          type: number
          format: double
          nullable: true
        cgId:
          type: string
          nullable: true
        marketCapChange24h:
          type: number
          format: double
        circulatingSupply:
          type: number
          format: double
        price:
          type: number
          format: double
          nullable: true
        marketCap:
          type: number
          format: double
          nullable: true
        volume:
          type: number
          format: double
          nullable: true
        fdv:
          type: number
          format: double
          nullable: true
        change:
          type: number
          format: double
          nullable: true
        priority:
          type: number
          format: double
          nullable: true
        warningMessage:
          type: string
        minMax:
          $ref: '#/components/schemas/TokenMinMax'
      required:
        - icon
        - id
        - chain
        - created
        - chainData
      type: object
      additionalProperties: false
    FieldErrors:
      properties: {}
      type: object
      additionalProperties:
        properties:
          value: {}
          message:
            type: string
        required:
          - message
        type: object
    Chain:
      properties:
        icon:
          type: string
        addressValidation:
          type: string
        tokenAddressValidation:
          type: string
        id:
          type: string
        created:
          type: string
          format: date-time
        modified:
          type: string
          format: date-time
        name:
          type: string
        shortName:
          type: string
        memoNeeded:
          type: boolean
          nullable: true
        hashUrl:
          type: string
        explorerUrl:
          type: string
        addressUrl:
          type: string
        priority:
          type: number
          format: double
        kind:
          type: string
        chainId:
          type: number
          format: double
          nullable: true
        enabled:
          type: boolean
        shortNameV1:
          type: string
      required:
        - icon
        - addressValidation
        - tokenAddressValidation
        - id
        - created
        - name
        - shortName
        - explorerUrl
        - addressUrl
        - kind
        - enabled
        - shortNameV1
      type: object
      additionalProperties: false
    TokenMinMax:
      properties:
        anon:
          items:
            type: number
            format: double
          type: array
        cex:
          items:
            type: number
            format: double
          type: array
        dex:
          items:
            type: number
            format: double
          type: array
      type: object
      additionalProperties: false
  securitySchemes:
    apiKey:
      type: apiKey
      name: Authorization
      in: header

````