CoinRebate Ai Stats API

openapi: 3.2.0
info:
  title: CoinRebate Fee Optimization Ai Stats API
  description: 'Free, open API for querying crypto exchange fee data and compliance-filtered recommendations. No authentication is required. Breaking changes follow the published 90-day deprecation policy: https://www.coinrebate.vip/en/developers#deprecation'
  version: 4.1.0
  contact:
    name: CoinRebate
    url: https://www.coinrebate.vip/en/contact
    email: support@coinrebate.vip
  license:
    name: Free to use
    url: https://www.coinrebate.vip/for-agents
servers:
- url: https://www.coinrebate.vip
  description: Production
tags:
- name: Ai Stats
paths:
  /api/v4/ai-stats:
    get:
      operationId: getAiStats
      summary: Get public AI ecosystem telemetry
      description: Returns current registry listings, tool calls, channel calls, and verified or observed AI visits.
      responses:
        '200':
          description: AI ecosystem telemetry
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AiStatsResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
      tags:
      - Ai Stats
components:
  responses:
    BadRequest:
      description: Invalid request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          examples:
            invalidCountry:
              summary: Unassigned country code
              value:
                error: Invalid country. Expected an assigned ISO 3166-1 alpha-2 code.
                code: invalid_country
                docs: https://www.coinrebate.vip/openapi.json
            invalidPurpose:
              summary: Unsupported trading purpose
              value:
                error: Invalid purpose. Expected 'spot' or 'futures'.
                code: invalid_purpose
                docs: https://www.coinrebate.vip/openapi.json
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    InternalError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    RateLimited:
      description: Rate limit exceeded
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    CountBreakdown:
      type: object
      required:
      - since
      - total
      properties:
        since:
          type:
          - string
          - 'null'
        total:
          type:
          - integer
          - 'null'
        by_tool:
          type:
          - object
          - 'null'
          additionalProperties:
            type: integer
        by_channel:
          type:
          - object
          - 'null'
          additionalProperties:
            type: integer
    DailyCountSeries:
      type:
      - object
      - 'null'
      required:
      - day_boundary
      - counts
      properties:
        day_boundary:
          type: string
          enum:
          - UTC
          - UTC+08:00
        counts:
          type: array
          items:
            type:
            - integer
            - 'null'
    AiStatsResponse:
      type: object
      required:
      - updated_at
      - listings
      - tool_calls
      - all_channel_calls
      - verified_ai_visits
      properties:
        updated_at:
          type:
          - string
          - 'null'
          format: date-time
        listings:
          type: object
          required:
          - mcp_registry
          - npm
          properties:
            mcp_registry:
              $ref: '#/components/schemas/McpRegistryListing'
            npm:
              $ref: '#/components/schemas/NpmListing'
        tool_calls:
          $ref: '#/components/schemas/CountBreakdown'
        all_channel_calls:
          $ref: '#/components/schemas/CountBreakdown'
        verified_ai_visits:
          type: object
          required:
          - window_days
          - bots
          - unverifiable_note
          - observed_bots
          properties:
            window_days:
              type: integer
            bots:
              $ref: '#/components/schemas/NullableVisitList'
            unverifiable_note:
              type: string
            observed_bots:
              $ref: '#/components/schemas/NullableVisitList'
        daily:
          type:
          - object
          - 'null'
          description: 'Added 2026-11-04. One point per calendar day from since to through (today''s date in UTC+08:00); counts[i] belongs to days[i]. Tool calls use UTC days: a started day without calls is 0, a day that has not started yet is null. Bot requests use UTC+08:00 days and the same bots and states as verified_ai_visits; a day without a record is null (no data, not zero). All tool-call days add up to tool_calls.total; the 30 bot days ending on through add up to the visits in verified_ai_visits.bots (verified) and observed_bots (observed). A series is null when its telemetry cannot be read; daily is null when nothing could be aggregated.'
          required:
          - since
          - through
          - days
          - tool_calls
          - verified_bot_requests
          - observed_bot_requests
          properties:
            since:
              type: string
              format: date
            through:
              type: string
              format: date
            days:
              type: array
              items:
                type: string
                format: date
            tool_calls:
              $ref: '#/components/schemas/DailyCountSeries'
            verified_bot_requests:
              $ref: '#/components/schemas/DailyCountSeries'
            observed_bot_requests:
              $ref: '#/components/schemas/DailyCountSeries'
    McpRegistryListing:
      type: object
      required:
      - name
      - version
      - checked_at
      - is_latest
      - url
      properties:
        name:
          type: string
        version:
          type:
          - string
          - 'null'
        checked_at:
          type:
          - string
          - 'null'
          format: date-time
        is_latest:
          type:
          - boolean
          - 'null'
        url:
          type: string
          format: uri
    NpmListing:
      type: object
      required:
      - package
      - version
      - checked_at
      - url
      properties:
        package:
          type: string
        version:
          type:
          - string
          - 'null'
        checked_at:
          type:
          - string
          - 'null'
          format: date-time
        url:
          type: string
          format: uri
    NullableVisitList:
      type:
      - array
      - 'null'
      items:
        type: object
        required:
        - bot
        - visits
        properties:
          bot:
            type: string
          visits:
            type: integer
    Error:
      type: object
      required:
      - error
      - code
      properties:
        error:
          type: string
        code:
          type: string
        docs:
          type: string
          format: uri