Agentic Keychain Compare 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 Compare API
  version: 0.2.0
servers:
- url: https://agentickeychain.com
tags:
- name: Compare
paths:
  /v1/compare:
    post:
      description: 'Assess two to five named capabilities side by side for the same inputs, with the same method and ak.offer.v1 offer shape as evaluate_capability. Use when: you already hold a shortlist of capability ids and want each one''s decision, reasons and offer in one answer. Not for: finding candidates (search_capabilities) or a single capability (evaluate_capability). Input: the capability ids, plus the optional task, model, expected_runs, baseline_cost_estimate_usd, context and constraints that evaluate_capability reads. Output: ak.comparison.v1 with the results ranked by decision, lower-bound net saving, relevance and capability id, each with its reasons and an ak.offer.v1 offer.'
      operationId: compare_capabilities
      requestBody:
        content:
          application/json:
            schema:
              properties:
                baseline_cost_estimate_usd:
                  description: What one run of this task costs you today without the capability, in USD.
                  exclusiveMinimum: 0
                  type: number
                capabilities:
                  description: Two to five capabilities to compare, each as an id, ak:// URI or slug.
                  items:
                    description: Capability id (ak:publisher:name or ak:publisher:name:x.y.z), ak:// URI or slug.
                    type: string
                  maxItems: 5
                  minItems: 2
                  type: array
                constraints:
                  description: Limits you set for the answer; a capability outside them is reported as blocked, with the reason code.
                  properties:
                    max_cost_usd:
                      description: The highest price in USD you accept; a capability priced above it is blocked (over_max_cost).
                      minimum: 0
                      type: number
                    minimum_confidence:
                      description: The lowest confidence in the measured saving you accept, from 0.5 to 0.999 (default 0.9); below it the answer is blocked (below_minimum_confidence).
                      maximum: 0.999
                      minimum: 0.5
                      type: number
                  type: object
                context:
                  additionalProperties:
                    type:
                    - string
                    - number
                    - integer
                    - boolean
                  description: Facts about your situation, keyed by the capability's parameter names (e.g. log_lines).
                  type: object
                expected_runs:
                  description: How many times you expect to perform this kind of task.
                  minimum: 1
                  type: integer
                model:
                  description: The model you run on, e.g. claude-sonnet-5. Savings are reported only for measured models.
                  type: string
                task:
                  description: Plain description of the task you are about to do (at most 4000 characters).
                  type: string
              required:
              - capabilities
              type: object
        required: true
      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: Compare capabilities
      tags:
      - Compare
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