Agentic Keychain Roi 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 Roi API
  version: 0.2.0
servers:
- url: https://agentickeychain.com
tags:
- name: Roi
paths:
  /v1/roi:
    post:
      description: 'Per measured model: expected saving per run, break-even runs and net saving over expected_runs, with intervals, for one capability and no task. Use when: you know the capability and want its economics on each model the registry measured. Not for: a use-or-not answer for a task (evaluate_capability) or several candidates (compare_capabilities). Input: a capability id; add model to keep one model, and expected_runs with baseline_cost_estimate_usd for an estimate at your scale. Output: ak.roi.v1 with one economics entry per measured model; break-even runs is null when the interval does not show a saving, and your estimate is left out where success is not accepted or your baseline lies outside the measured range.'
      operationId: estimate_roi
      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
                capability:
                  description: Capability id (ak:publisher:name or ak:publisher:name:x.y.z), ak:// URI or slug.
                  type: string
                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
              required:
              - capability
              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: Estimate return on a capability
      tags:
      - Roi
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