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

# Daily usage rankings

> The boards ranking providers and endpoints by completed calls over the trailing 7 and 30 days, as of the last full UTC day, with the headline numbers. Recomputed daily at 08:00 UTC.



## OpenAPI

````yaml https://monid.ai/openapi.json get /public/v1/rankings
openapi: 3.1.0
info:
  title: Monid API
  version: 0.1.0
  description: >-
    Agentic payment platform for data — agents discover and buy data on demand.
    Authenticated `/v1/*` routes accept a Monid API key or Clerk JWT as a Bearer
    token. All errors return `{ code, message }`. List endpoints use cursor
    pagination; consult each operation schema for its last-page cursor encoding.
servers:
  - url: https://api.monid.ai
    description: Production
  - url: https://monid.ai
    description: Public registry alias (public/v1 only)
security: []
paths:
  /public/v1/rankings:
    get:
      tags:
        - Rankings
      summary: Daily usage rankings
      description: >-
        The boards ranking providers and endpoints by completed calls over the
        trailing 7 and 30 days, as of the last full UTC day, with the headline
        numbers. Recomputed daily at 08:00 UTC.
      responses:
        '200':
          description: The latest daily rankings
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RankingsIndex'
        '500':
          description: Rankings are not available yet, or internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    RankingsIndex:
      type: object
      properties:
        generatedAt:
          type: string
          description: The UTC day the numbers were computed.
        asOf:
          type: string
          description: The last full UTC day counted.
        freeWeight:
          type: number
          description: What a free call counts for against a paid one.
        headline:
          $ref: '#/components/schemas/RankingsHeadline'
        categories:
          type: array
          items:
            $ref: '#/components/schemas/RankingsCategory'
          description: Category tabs of the endpoint boards (`?category=`), busiest first.
        boards:
          type: array
          items:
            $ref: '#/components/schemas/RankingsBoardInfo'
          description: In page order.
      required:
        - generatedAt
        - asOf
        - freeWeight
        - headline
        - categories
        - boards
    Error:
      type: object
      properties:
        code:
          type: integer
          description: HTTP status code, duplicated in the body.
          example: 400
        message:
          type: string
          description: Human-readable error description.
          example: Bad Request
        hints:
          type: object
          additionalProperties:
            anyOf:
              - type: string
              - type: object
                properties:
                  kind:
                    type: string
                    enum:
                      - command
                      - discover
                      - inspect
                      - run
                      - getRun
                      - stop
                      - releaseResource
                      - topup
                  command:
                    type: string
                  query:
                    type: string
                  provider:
                    type: string
                  endpoint:
                    type: string
                  runId:
                    type: string
                  resourceId:
                    type: string
                  stripe:
                    type: string
                  dashboard:
                    type: string
                  docs:
                    type: string
                  comment:
                    type: string
                required:
                  - kind
          description: >-
            Optional next actions, rendered for the calling client like
            run-response hints (e.g. the paid TinyFish version on a free-quota
            429 — spending permission required).
        errorCode:
          type: string
          enum:
            - RATE_LIMITED
            - X402_WORKSPACE_RESOURCES
            - X402_WORKSPACE_ONLY
            - X402_ACCRUING_COST
            - X402_EXCEEDS_SETTLEMENT_WINDOW
            - X402_VALIDITY_WINDOW_TOO_SHORT
            - X402_UNBOUNDED_PRICE
            - X402_PROMOTION
            - INSUFFICIENT_SCOPE
            - WALLET_INSUFFICIENT_FUNDS
            - IDENTITY_PROVIDER_UNKNOWN
            - IDENTITY_LINK_REQUIRES_SESSION
            - IDENTITY_LINK_STATE_INVALID
            - IDENTITY_VERIFICATION_FAILED
            - IDENTITY_PROVIDER_UNAVAILABLE
            - IDENTITY_ALREADY_LINKED
            - IDENTITY_USER_ALREADY_LINKED
            - IDENTITY_LINK_RATE_LIMITED
            - IDENTITY_REQUIRED
            - PROMO_IDENTITY_REDEEMED
            - PROMO_REDEEM_REQUIRES_SESSION
            - PROMO_CODE_REDEEMED_BY_WORKSPACE
            - PROMO_CODE_REDEEMED_BY_USER
          description: >-
            OPTIONAL machine-readable discriminant from the documented
            `ApiErrorCode` registry. Absent on legacy errors; clients MUST treat
            unknown values as absent.
      required:
        - code
        - message
    RankingsHeadline:
      type: object
      properties:
        runs7d:
          type: number
        runsPrev7d:
          type: number
        paid7d:
          type: number
        runs30d:
          type: number
        paid30d:
          type: number
        endpoints7d:
          type: number
        endpoints30d:
          type: number
        providers7d:
          type: number
        providers30d:
          type: number
      required:
        - runs7d
        - runsPrev7d
        - paid7d
        - runs30d
        - paid30d
        - endpoints7d
        - endpoints30d
        - providers7d
        - providers30d
    RankingsCategory:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
      required:
        - id
        - name
    RankingsBoardInfo:
      type: object
      properties:
        id:
          type: string
          example: most-used-tools
        kind:
          type: string
          enum:
            - providers
            - endpoints
        title:
          type: string
        windows:
          type: array
          items:
            type: string
            enum:
              - 7d
              - 30d
          description: The `?window=` values the board takes; `7d` is the default.
      required:
        - id
        - kind
        - title
        - windows

````

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