AgenticTrade Admin API

The admin API from AgenticTrade — 19 operation(s) for admin.

Operations 19

GET /api/v1/admin/stats Platform Stats #
GET /api/v1/admin/usage/daily Daily Usage #
GET /api/v1/admin/providers/ranking Provider Ranking #
GET /api/v1/admin/services/health Services Health #
GET /api/v1/admin/payments/summary Payments Summary #
GET /api/v1/admin/analytics/top-services Top Services #
GET /api/v1/admin/analytics/buyers Buyer Metrics #
POST /api/v1/admin/health-check/run Run Health Checks #
GET /api/v1/admin/health-check/scores Health Scores #
GET /api/v1/admin/health-check/provider/{provider_id} Provider Health #
GET /api/v1/admin/providers/{provider_id}/commission Provider Commission #
GET /api/v1/admin/providers/{provider_id}/milestones Provider Milestones #
GET /api/v1/admin/platform-consumption Platform Consumption Stats #
GET /api/v1/admin/webhooks/dead-letters List Dead Letters #
POST /api/v1/admin/webhooks/dead-letters/{dead_letter_id}/retry Retry Dead Letter #
GET /api/v1/admin/audit List Audit Events #
GET /api/v1/admin/audit/summary Audit Summary #
GET /api/v1/admin/financial-export Financial Export #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/agentictrade-io:agentictrade-io-admin-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

agentictrade-io-admin-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Agentictrade Io Admin API
  version: 0.7.1
  description: 'Operations tagged admin across 2 of this provider''s published API definitions: agentictrade-io-openapi.json, agentictrade-io.json. Each path carries the servers of the definition it was published in.'
tags:
- name: Admin
paths:
  /api/v1/admin/stats:
    get:
      tags:
      - Admin
      summary: Platform Stats
      description: Platform overview statistics.
      operationId: platform_stats_api_v1_admin_stats_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /api/v1/admin/usage/daily:
    get:
      tags:
      - Admin
      summary: Daily Usage
      description: Daily usage aggregation for the last N days.
      operationId: daily_usage_api_v1_admin_usage_daily_get
      parameters:
      - name: days
        in: query
        required: false
        schema:
          type: integer
          maximum: 90
          minimum: 1
          default: 30
          title: Days
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/admin/providers/ranking:
    get:
      tags:
      - Admin
      summary: Provider Ranking
      description: Rank providers by usage volume and revenue.
      operationId: provider_ranking_api_v1_admin_providers_ranking_get
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          default: 20
          title: Limit
      - name: period
        in: query
        required: false
        schema:
          type: string
          pattern: ^(all-time|7|14|30|60|90|180|365)$
          default: all-time
          title: Period
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/admin/services/health:
    get:
      tags:
      - Admin
      summary: Services Health
      description: Health overview of all active services.
      operationId: services_health_api_v1_admin_services_health_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /api/v1/admin/payments/summary:
    get:
      tags:
      - Admin
      summary: Payments Summary
      description: Breakdown of usage by payment method.
      operationId: payments_summary_api_v1_admin_payments_summary_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /api/v1/admin/analytics/trends:
    get:
      tags:
      - Admin
      summary: Analytics Trends
      description: Revenue and call trends by day/week/month.
      operationId: analytics_trends_api_v1_admin_analytics_trends_get
      parameters:
      - name: granularity
        in: query
        required: false
        schema:
          type: string
          pattern: ^(daily|weekly|monthly)$
          default: weekly
          title: Granularity
      - name: periods
        in: query
        required: false
        schema:
          type: integer
          maximum: 52
          minimum: 1
          default: 12
          title: Periods
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/admin/analytics/top-services:
    get:
      tags:
      - Admin
      summary: Top Services
      description: Top services ranked by revenue, calls, or latency.
      operationId: top_services_api_v1_admin_analytics_top_services_get
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 50
          minimum: 1
          default: 10
          title: Limit
      - name: sort_by
        in: query
        required: false
        schema:
          type: string
          pattern: ^(revenue|calls|latency)$
          default: revenue
          title: Sort By
      - name: days
        in: query
        required: false
        schema:
          type: integer
          maximum: 365
          minimum: 1
          default: 30
          title: Days
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/admin/analytics/buyers:
    get:
      tags:
      - Admin
      summary: Buyer Metrics
      description: 'Buyer engagement metrics: new, active, repeat, top spenders.'
      operationId: buyer_metrics_api_v1_admin_analytics_buyers_get
      parameters:
      - name: days
        in: query
        required: false
        schema:
          type: integer
          maximum: 365
          minimum: 1
          default: 30
          title: Days
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/admin/health-check/run:
    post:
      tags:
      - Admin
      summary: Run Health Checks
      description: Trigger health checks for all active services (admin only).
      operationId: run_health_checks_api_v1_admin_health_check_run_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /api/v1/admin/health-check/scores:
    get:
      tags:
      - Admin
      summary: Health Scores
      description: Get health quality scores for all services (admin only).
      operationId: health_scores_api_v1_admin_health_check_scores_get
      parameters:
      - name: days
        in: query
        required: false
        schema:
          type: integer
          maximum: 90
          minimum: 1
          default: 30
          title: Days
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/admin/health-check/provider/{provider_id}:
    get:
      tags:
      - Admin
      summary: Provider Health
      description: Get health summary for a specific provider (admin only).
      operationId: provider_health_api_v1_admin_health_check_provider__provider_id__get
      parameters:
      - name: provider_id
        in: path
        required: true
        schema:
          type: string
          title: Provider Id
      - name: days
        in: query
        required: false
        schema:
          type: integer
          maximum: 90
          minimum: 1
          default: 30
          title: Days
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/admin/providers/{provider_id}/commission:
    get:
      tags:
      - Admin
      summary: Provider Commission
      description: Get commission info for a specific provider (Growth Program status).
      operationId: provider_commission_api_v1_admin_providers__provider_id__commission_get
      parameters:
      - name: provider_id
        in: path
        required: true
        schema:
          type: string
          title: Provider Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/admin/providers/{provider_id}/milestones:
    get:
      tags:
      - Admin
      summary: Provider Milestones
      description: Get milestone progress for a specific provider (admin view).
      operationId: provider_milestones_api_v1_admin_providers__provider_id__milestones_get
      parameters:
      - name: provider_id
        in: path
        required: true
        schema:
          type: string
          title: Provider Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/admin/platform-consumption:
    get:
      tags:
      - Admin
      summary: Platform Consumption Stats
      description: Get platform agent consumption statistics (admin only).
      operationId: platform_consumption_stats_api_v1_admin_platform_consumption_get
      parameters:
      - name: days
        in: query
        required: false
        schema:
          type: integer
          maximum: 90
          minimum: 1
          default: 30
          title: Days
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/admin/webhooks/dead-letters:
    get:
      tags:
      - Admin
      summary: List Dead Letters
      description: List all dead letter entries for ops review (R17-DLQ admin).
      operationId: list_dead_letters_api_v1_admin_webhooks_dead_letters_get
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 500
          minimum: 1
          default: 100
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          default: 0
          title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response List Dead Letters Api V1 Admin Webhooks Dead Letters Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/admin/webhooks/dead-letters/{dead_letter_id}/retry:
    post:
      tags:
      - Admin
      summary: Retry Dead Letter
      description: Retry a dead letter entry by re-submitting the webhook (R17-DLQ ops).
      operationId: retry_dead_letter_api_v1_admin_webhooks_dead_letters__dead_letter_id__retry_post
      parameters:
      - name: dead_letter_id
        in: path
        required: true
        schema:
          type: string
          title: Dead Letter Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Retry Dead Letter Api V1 Admin Webhooks Dead Letters  Dead Letter Id  Retry Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/admin/audit:
    get:
      tags:
      - Admin
      summary: List Audit Events
      description: 'List audit log events with optional filters (admin only).


        When no ``since``/``until`` range is provided, defaults to the last

        30 days to prevent full-table scans.'
      operationId: list_audit_events_api_v1_admin_audit_get
      parameters:
      - name: event_type
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Event Type
      - name: actor
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Actor
      - name: since
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: ISO-8601 lower bound for timestamp (defaults to 30 days ago)
          title: Since
        description: ISO-8601 lower bound for timestamp (defaults to 30 days ago)
      - name: until
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: ISO-8601 upper bound for timestamp
          title: Until
        description: ISO-8601 upper bound for timestamp
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 1000
          minimum: 1
          default: 100
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          default: 0
          title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/admin/audit/summary:
    get:
      tags:
      - Admin
      summary: Audit Summary
      description: Event counts by type for the last N hours (admin only).
      operationId: audit_summary_api_v1_admin_audit_summary_get
      parameters:
      - name: hours
        in: query
        required: false
        schema:
          type: integer
          maximum: 720
          minimum: 1
          default: 24
          title: Hours
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/admin/financial-export:
    get:
      tags:
      - Admin
      summary: Financial Export
      description: 'Export financial data for reconciliation.


        Returns settlements, deposits (escrow), and usage records as JSON.

        Admin-only. Supports date range filtering.'
      operationId: financial_export_api_v1_admin_financial_export_get
      parameters:
      - name: date_from
        in: query
        required: false
        schema:
          type: string
          description: Start date (YYYY-MM-DD)
          default: ''
          title: Date From
        description: Start date (YYYY-MM-DD)
      - name: date_to
        in: query
        required: false
        schema:
          type: string
          description: End date (YYYY-MM-DD)
          default: ''
          title: Date To
        description: End date (YYYY-MM-DD)
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 10000
          minimum: 1
          description: Max records per category
          default: 1000
          title: Limit
        description: Max records per category
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
x-refined-from:
- agentictrade-io-openapi.json
- agentictrade-io.json