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

# Get SUI coins list with pagination

> Retrieves a paginated list of SUI tokens with optional filtering and sorting



## OpenAPI

````yaml /api-reference/openapi.json get /sui/coinsList
openapi: 3.0.0
info:
  title: Nimbus API
  version: 1.0.0
  description: >-
    API for Nimbus


    ## Rate Limiting

    This API implements rate limiting to ensure fair usage and protect our
    services. The current rate limit is:


    - **40 requests per 1 minute** per IP address


    If you exceed this limit, you will receive a 429 (Too Many Requests)
    response. Please wait for the rate limit window to reset before making
    additional requests.


    If you need more, please contact us at **thanhle@getnimbus.io** or TG
    **@thanhle27** to get premium API Key.
servers:
  - url: https://api.getnimbus.io
    description: API server
security: []
tags: []
paths:
  /sui/coinsList:
    get:
      tags:
        - Token
      summary: Get SUI coins list with pagination
      description: >-
        Retrieves a paginated list of SUI tokens with optional filtering and
        sorting
      parameters:
        - in: query
          name: page
          schema:
            type: integer
            default: 0
          description: Page number (zero-based)
        - in: query
          name: limit
          schema:
            type: integer
            default: 50
            maximum: 50
          description: Number of items per page
        - in: query
          name: search
          schema:
            type: string
          description: Search term to filter tokens by name, symbol, or coinType
        - in: query
          name: sortBy
          schema:
            type: string
            default: volume24H:desc
            enum:
              - name:asc
              - name:desc
              - symbol:asc
              - symbol:desc
              - price:asc
              - price:desc
              - marketCap:asc
              - marketCap:desc
              - priceChangePercentage24H:asc
              - priceChangePercentage24H:desc
              - priceChangePercentage7D:asc
              - priceChangePercentage7D:desc
              - volume24H:asc
              - volume24H:desc
              - holders:asc
              - holders:desc
              - totalSupply:asc
              - totalSupply:desc
              - createdAt:asc
              - createdAt:desc
              - updatedAt:asc
              - updatedAt:desc
          description: Field and direction to sort by (format field:direction)
      responses:
        '200':
          description: Successful response with paginated SUI tokens
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      tokens:
                        type: array
                        items:
                          type: object
                          properties:
                            coinType:
                              type: string
                              description: Coin type
                            creator:
                              type: string
                              description: Creator address
                            package:
                              type: string
                              description: Package address
                            totalSupply:
                              type: number
                              description: Total supply
                            holders:
                              type: number
                              description: Holders count
                            name:
                              type: string
                              description: Token name
                            symbol:
                              type: string
                              description: Token symbol
                            decimals:
                              type: integer
                              description: Token decimals
                            iconUrl:
                              type: string
                              description: Token icon URL
                            cmcId:
                              type: string
                              description: CoinMarketCap ID
                            coinGeckoId:
                              type: string
                              description: CoinGecko ID
                            circulating:
                              type: number
                              description: Circulating supply
                            marketCap:
                              type: number
                              description: Market capitalization
                            volume24H:
                              type: number
                              description: 24-hour trading volume
                            ath:
                              type: number
                              description: All-time high price
                            atl:
                              type: number
                              description: All-time low price
                            verified:
                              type: boolean
                              description: Whether the token is verified
                            createdAt:
                              type: string
                              description: Token creation time
                            lastUpdatedAt:
                              type: string
                              description: Update time
                      pagination:
                        type: object
                        properties:
                          page:
                            type: integer
                            description: Current page number
                          limit:
                            type: integer
                            description: Number of items per page
                          totalCount:
                            type: integer
                            description: Total number of items
                          totalPages:
                            type: integer
                            description: Total number of pages
        '400':
          description: Bad request due to invalid parameters
        '500':
          description: Internal server error
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication
      x-default: nimbus-6a7c85b1-99f4-4d99-b8f3-e6e49b8daad0

````