Agentic Keychain Capabilities API

openapi: 3.2.0
info:
  description: 'Agentic Keychain: Autonomous Trading Agents, Signed Results. This API is its skill registry (Agent Skill ROI Registry & Benchmarking); Keychain Trading''s results are read-only static files at https://agentickeychain.com/trading/results.json. This is a commercial registry. It sells some of the skills listed here, through Polar as merchant of record, and its operator earns money when one is bought. The evaluate answer can be "do not buy": it says so when the measured evidence does not cover your task, when the price is not recovered, or when a free alternative is enough. Every purchase ends in a checkout that a human completes. The same operations are MCP tools at /mcp. Fields this API version does not define can appear and have no meaning for a client that does not know them. A kind, delivery or pricing.model value that a client does not know means the capability is not supported by that client; it is never purchasable by inference.'
  title: Agentic Keychain Capabilities API
  version: 0.2.0
servers:
- url: https://agentickeychain.com
tags:
- name: Capabilities
paths:
  /v1/capabilities/search:
    get:
      description: 'Search capability names, summaries, tasks and use-when conditions by keywords, ranked by lexical relevance only, never by payment. Use when: you want to see which capabilities exist for a topic, or you know part of a name. Not for: deciding whether one fits your task (resolve_task, or evaluate_capability for the full arithmetic) or reading a capability you can already name (get_capability). Input: search words, at most 500 characters; no earlier call is needed. Output: ak.search.v1 with id, name, summary, relevance, state, price and the strongest evidence label of each result, and no decision.'
      operationId: search_capabilities
      parameters:
      - in: query
        name: q
        required: true
        schema:
          type: string
      - in: query
        name: limit
        required: false
        schema:
          type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Error (ak.error.v1)
      summary: Search capabilities
      tags:
      - Capabilities
  /v1/capabilities/{capability}:
    get:
      description: 'The capability''s card: purpose, use-when and do-not-use-when conditions, permissions, price, evidence summary, trust checks, links and a task-independent ak.offer.v1 offer. Use when: you can name a capability and want its facts, or want to check the conditions an evaluation asked about. Not for: an answer for your task (evaluate_capability) or the full benchmark records (get_benchmark). Input: a capability id, ak:// URI or slug, from a search, an evaluation or a page. Output: ak.capability.v1 with the card fields, parameters, versions, terms, evidence, trust and links.'
      operationId: get_capability
      parameters:
      - in: path
        name: capability
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Error (ak.error.v1)
      summary: Get a capability card
      tags:
      - Capabilities
  /v1/capabilities/{capability}/benchmark:
    get:
      description: 'Registry-run benchmark summaries (labelled), publisher claims (labelled PUBLISHER CLAIMED) and the signed attestations of one capability. Use when: you want the measurements behind an answer (paired runs, model, fixtures, method) or want to check them yourself. Not for: an answer for your task (evaluate_capability) or artifact hashes and the log proof (get_provenance). Input: a capability id, ak:// URI or slug. Output: ak.benchmark.v1 with the evidence, the publisher claims, the attestations, the method and the limitations; publisher claims never decide anything.'
      operationId: get_benchmark
      parameters:
      - in: path
        name: capability
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Error (ak.error.v1)
      summary: Get benchmark evidence
      tags:
      - Capabilities
  /v1/capabilities/{capability}/provenance:
    get:
      description: 'Artifact hash, manifest hash, signed publisher and registry attestations and a transparency-log inclusion proof for one capability. Use when: you want to check that a package is the one the registry published and signed. Not for: benchmark results (get_benchmark) or the card (get_capability). Input: a capability id, ak:// URI or slug. Output: ak.provenance.v1 with the hashes, the attestations, an RFC 9162 inclusion proof against the signed tree head, the trust checks and the keys URL.'
      operationId: get_provenance
      parameters:
      - in: path
        name: capability
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
          description: Success
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Error (ak.error.v1)
      summary: Get provenance
      tags:
      - Capabilities
components:
  schemas:
    Error:
      properties:
        error:
          properties:
            code:
              type: string
            message:
              type: string
            retryable:
              type: boolean
          required:
          - code
          - message
          - retryable
          type: object
        schema:
          const: ak.error.v1
      required:
      - schema
      - error
      type: object