> ## 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. # One rankings board > The rows of one board listed by `GET /public/v1/rankings`, best first, 50 per page by default (at most 100). ## OpenAPI ````yaml https://monid.ai/openapi.json get /public/v1/rankings/{board} 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/{board}: get: tags: - Rankings summary: One rankings board description: >- The rows of one board listed by `GET /public/v1/rankings`, best first, 50 per page by default (at most 100). parameters: - schema: type: string example: most-used-tools required: true name: board in: path - schema: type: integer exclusiveMinimum: 0 description: Max items per page (server-side cap applies). example: 20 required: false description: Max items per page (server-side cap applies). name: limit in: query - schema: type: string description: Cursor returned by the previous page. required: false description: Cursor returned by the previous page. name: cursor in: query - schema: type: string enum: - 7d - 30d description: >- One of the board's `windows` in `GET /public/v1/rankings`; `7d` by default. example: 30d required: false description: >- One of the board's `windows` in `GET /public/v1/rankings`; `7d` by default. name: window in: query - schema: type: string description: >- Endpoint boards only: a category id from `GET /public/v1/rankings`. An unknown id matches nothing. example: social-media required: false description: >- Endpoint boards only: a category id from `GET /public/v1/rankings`. An unknown id matches nothing. name: category in: query responses: '200': description: One page of the board content: application/json: schema: $ref: '#/components/schemas/RankingsBoardPage' '400': description: >- A window the board does not have, a category on a provider board, or a cursor from another day content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: No such board content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: Rankings are not available yet, or internal server error content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: RankingsBoardPage: oneOf: - type: object properties: items: type: array items: $ref: '#/components/schemas/RankingsProviderRow' cursor: type: string description: Opaque cursor for the next page. Absent on the last page. asOf: type: string description: The last full UTC day counted. kind: type: string enum: - providers required: - items - asOf - kind - type: object properties: items: type: array items: $ref: '#/components/schemas/RankingsEndpointRow' cursor: type: string description: Opaque cursor for the next page. Absent on the last page. asOf: type: string description: The last full UTC day counted. kind: type: string enum: - endpoints required: - items - asOf - kind 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 RankingsProviderRow: type: object properties: rank: type: integer description: Position on the board (within the category when filtered), from 1. provider: type: string name: type: string blurb: type: string example: type: string description: One thing to ask an agent to do with this provider. runs: type: number description: Weighted calls in the window. previousRuns: type: number description: Weighted calls in the window before, of the same length. wow: type: - number - 'null' description: Change against the window before; null when it had no calls. endpoints: type: number description: Endpoints with calls in the window. topEndpoint: type: string description: Catalog path of its most called endpoint. weekly: type: array items: type: number description: Weighted calls per complete Mon–Sun week, oldest first. required: - rank - provider - name - runs - previousRuns - wow - endpoints - topEndpoint - weekly RankingsEndpointRow: type: object properties: rank: type: integer description: Position on the board (within the category when filtered), from 1. provider: type: string providerName: type: string endpoint: type: string description: The catalog endpoint path. name: type: string category: type: string description: Catalog top category id, as in GET /public/v1/categories. example: type: string description: One thing to ask an agent to do with this endpoint. runs: type: number description: Weighted calls in the window. previousRuns: type: number description: Weighted calls in the window before, of the same length. wow: type: - number - 'null' description: Change against the window before; null when it had no calls. calls: type: number description: Completed calls in the window, unweighted. providerErrors: type: number description: Of those, calls reported with HTTP 400 or above. callers: type: number description: Distinct workspaces calling it in the window. weekly: type: - array - 'null' items: type: number description: >- Weighted calls per complete Mon–Sun week, oldest first; null without any. required: - rank - provider - providerName - endpoint - name - runs - previousRuns - wow - calls - providerErrors - callers - weekly ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.