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-agents-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.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  title: Agentictrade Io Agents API
  version: 0.7.1
  description: 'Operations tagged agents 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: Agents
paths:
  /api/v1/agents:
    post:
      tags:
      - Agents
      summary: Register Agent
      description: Register a new agent identity. Requires API key.
      operationId: register_agent_api_v1_agents_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RegisterAgentRequest'
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - Agents
      summary: List Agents
      description: List agents. No auth required.
      operationId: list_agents_api_v1_agents_get
      parameters:
      - name: status
        in: query
        required: false
        schema:
          type: string
          default: active
          title: Status
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 50
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          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/agents/search:
    get:
      tags:
      - Agents
      summary: Search Agents
      description: Search agents by name or ID.
      operationId: search_agents_api_v1_agents_search_get
      parameters:
      - name: q
        in: query
        required: false
        schema:
          type: string
          default: ''
          title: Q
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 20
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/agents/{agent_id}:
    get:
      tags:
      - Agents
      summary: Get Agent
      description: Get agent details. No auth required.
      operationId: get_agent_api_v1_agents__agent_id__get
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    patch:
      tags:
      - Agents
      summary: Update Agent
      description: Update an agent (owner only). Requires API key.
      operationId: update_agent_api_v1_agents__agent_id__patch
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateAgentRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    delete:
      tags:
      - Agents
      summary: Deactivate Agent
      description: Deactivate an agent (soft delete, owner only). Requires API key.
      operationId: deactivate_agent_api_v1_agents__agent_id__delete
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/agents/{agent_id}/verify:
    post:
      tags:
      - Agents
      summary: Verify Agent
      description: Mark an agent as verified (admin only). Requires admin API key.
      operationId: verify_agent_api_v1_agents__agent_id__verify_post
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/agent-playbook:
    get:
      tags:
      - Agents
      summary: Agent Playbook
      description: 'Agent Playbook — machine-readable guide for AI agents.


        Returns structured instructions for agents on how to:

        1. Guide their human owner through setup

        2. Register and list services

        3. Discover and consume services from other agents

        No authentication required — this is a public knowledge endpoint.'
      operationId: agent_playbook_api_v1_agent_playbook_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /api/v1/agents/onboard:
    post:
      tags:
      - Agents
      summary: Onboard Agent
      description: 'One-step agent self-registration.


        Creates agent identity + provider API key + service listing in a single call.

        No authentication required — this is the entry point for new agents.


        If owner_email is provided, a verification email is sent. The owner binding

        remains ``pending_verification`` until the human clicks the verification link.


        Returns the API key secret (shown once only), agent ID, and service ID.'
      operationId: onboard_agent_api_v1_agents_onboard_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OnboardRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/agents/{agent_id}/verify-owner:
    get:
      tags:
      - Agents
      summary: Verify Owner Email
      description: 'Verify the owner email binding for an agent.


        The human clicks the link in the verification email which hits this

        endpoint. On success the agent''s metadata is updated to mark the

        owner_email as verified.'
      operationId: verify_owner_email_api_v1_agents__agent_id__verify_owner_get
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      - name: token
        in: query
        required: true
        schema:
          type: string
          title: Token
      responses:
        '200':
          description: Successful Response
          content:
            text/html:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/agents/{agent_id}/resend-verification:
    post:
      tags:
      - Agents
      summary: Resend Owner Verification
      description: 'Resend the owner email verification link for an agent.


        Auth: requires the agent''s own API key (owner) or admin.


        Cooldown: 5 minutes between resend requests to prevent spam.

        If the owner email is already verified, returns 400 (no action needed).'
      operationId: resend_owner_verification_api_v1_agents__agent_id__resend_verification_post
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/_ResendResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/agents/{agent_id}/verification-status:
    get:
      tags:
      - Agents
      summary: Get Verification Status
      description: 'Get the current owner email verification status for an agent.


        Auth: requires the agent''s own API key (owner) or admin.

        Useful for debugging: has the token been sent? Has it been clicked?'
      operationId: get_verification_status_api_v1_agents__agent_id__verification_status_get
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/_StatusResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/agents/{agent_id}/dashboard:
    get:
      tags:
      - Agents
      summary: Get Agent Dashboard
      description: 'Get agent dashboard with earnings, usage, and health metrics.


        Requires agent''s API key for authentication.'
      operationId: get_agent_dashboard_api_v1_agents__agent_id__dashboard_get
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    UpdateAgentRequest:
      properties:
        display_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Display Name
        capabilities:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Capabilities
        wallet_address:
          anyOf:
          - type: string
          - type: 'null'
          title: Wallet Address
        status:
          anyOf:
          - type: string
          - type: 'null'
          title: Status
        metadata:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Metadata
      type: object
      title: UpdateAgentRequest
    _StatusResponse:
      properties:
        agent_id:
          type: string
          title: Agent Id
        owner_email:
          type: string
          title: Owner Email
        verified:
          type: boolean
          title: Verified
        latest_token_status:
          anyOf:
          - type: string
          - type: 'null'
          title: Latest Token Status
        expires_at:
          anyOf:
          - type: string
          - type: 'null'
          title: Expires At
        created_at:
          anyOf:
          - type: string
          - type: 'null'
          title: Created At
        resend_cooldown_remaining_seconds:
          anyOf:
          - type: integer
          - type: 'null'
          title: Resend Cooldown Remaining Seconds
        message:
          type: string
          title: Message
      type: object
      required:
      - agent_id
      - owner_email
      - verified
      - latest_token_status
      - expires_at
      - created_at
      - resend_cooldown_remaining_seconds
      - message
      title: _StatusResponse
    _ResendResponse:
      properties:
        status:
          type: string
          title: Status
        owner_email:
          type: string
          title: Owner Email
        verify_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Verify Url
        cooldown_remaining_seconds:
          anyOf:
          - type: integer
          - type: 'null'
          title: Cooldown Remaining Seconds
        message:
          type: string
          title: Message
      type: object
      required:
      - status
      - owner_email
      - message
      title: _ResendResponse
    RegisterAgentRequest:
      properties:
        display_name:
          type: string
          title: Display Name
        identity_type:
          type: string
          title: Identity Type
          default: api_key_only
        capabilities:
          items:
            type: string
          type: array
          title: Capabilities
          default: []
        wallet_address:
          anyOf:
          - type: string
          - type: 'null'
          title: Wallet Address
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
          default: {}
      type: object
      required:
      - display_name
      title: RegisterAgentRequest
    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
    OnboardRequest:
      properties:
        agent_name:
          type: string
          title: Agent Name
        description:
          type: string
          title: Description
          default: ''
        endpoint:
          type: string
          title: Endpoint
          default: ''
        price_per_call:
          type: string
          title: Price Per Call
          default: '0.01'
        category:
          type: string
          title: Category
          default: ''
        tags:
          items:
            type: string
          type: array
          title: Tags
          default: []
        owner_email:
          type: string
          title: Owner Email
          default: ''
        payment_method:
          type: string
          title: Payment Method
          default: x402
        free_tier_calls:
          type: integer
          title: Free Tier Calls
          default: 0
        wallet_address:
          type: string
          title: Wallet Address
          default: ''
        role:
          type: string
          title: Role
          default: provider
        budget_limit_usdc:
          type: string
          title: Budget Limit Usdc
          default: ''
      type: object
      required:
      - agent_name
      title: OnboardRequest
      description: One-step agent self-registration request.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
x-refined-from:
- agentictrade-io-openapi.json
- agentictrade-io.json