Annalist AI API

The ai API from Annalist — 3 operation(s) for ai.

Operations 3

GET /v1/ai/retirements When will this AI model be shut down on each platform, and what replaces it? #
GET /v1/ai/prices What does this AI model cost per million tokens, on which providers, and which… #
GET /v1/ai/changes Which AI model prices changed recently, and which models were added or retired? #

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/annalist-dev:annalist-dev-ai-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

annalist-dev-ai-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Annalist Dev AI API
  version: 0.9.0
  x-guidance: 'Annalist sells signed data for agents, priced per call over x402 (USDC on Base or Solana). Start with the free GET /v1/catalog: every paid route with the question it answers, its price and an example. Hyperliquid in one call: GET /v1/perp/full?coin=BTC (crowd state, smart-money positioning, liquidation levels). Before paying an x402 service: GET /v1/checks/service?host=, or the free GET /v1/verify/attestation?host=. Before connecting an MCP server: GET /v1/mcp/server?url=, or the free GET /v1/verify/mcp?url=. Before an agent shops on a site: the free GET /v1/verify/store?domain=, or GET /v1/web/readiness?domain=. Every answer is Ed25519-signed; the key is at /.well-known/annalist-key.json. Not investment advice.'
  description: 'Operations tagged ai across 2 of this provider''s published API definitions: annalist-dev-openapi.json, openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.annalist.dev
tags:
- name: AI
paths:
  /v1/ai/retirements:
    get:
      operationId: ai_retirements
      tags:
      - AI
      summary: When will this AI model be shut down on each platform, and what replaces it?
      description: 'Retirement calendar for AI models across platforms: shutdown dates, ''not sooner than'' floors, states and recommended replacements from the official Anthropic, OpenAI and Amazon Bedrock deprecation pages, plus Azure, Vertex, Gemini and others, recorded daily so moved dates show. The same model often retires on different dates on different platforms. One model with model=, or upcoming shutdowns. Signed.'
      x-price: $0.005
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.005000'
        protocols:
        - x402: {}
      parameters:
      - name: model
        in: query
        required: false
        schema:
          type: string
          description: 'optional: part of a model id, for example gpt-4o or claude-sonnet-4-5'
      - name: platform
        in: query
        required: false
        schema:
          type: string
          description: 'optional: anthropic, openai, bedrock, azure, vertex_ai, gemini...'
      - name: days
        in: query
        required: false
        schema:
          type: string
          description: upcoming shutdowns within this many days, 1 to 365 (default 90)
      responses:
        '200':
          description: Signed data
          content:
            application/json:
              schema:
                type: object
                required:
                - as_of
                - data
                - signature
                properties:
                  as_of:
                    type: string
                    format: date-time
                  data:
                    type: object
                  method:
                    type: object
                  request_id:
                    type: string
                  stale:
                    type: boolean
                  sources:
                    type: array
                    items:
                      type: string
                  notice:
                    type: string
                  key_id:
                    type: string
                  signature:
                    type: string
                    description: Ed25519 over RFC 8785 canonical JSON of {as_of, data, method, request_id}
                  signature_info:
                    type: string
              example:
                data:
                  model: gpt-4o
                  entries:
                  - platform: openai
                    model: gpt-4o-2024-08-06
                    state: deprecated
                    shutdown: '2027-01-14'
                    replacement: gpt-6-luna
        '402':
          description: Payment required (x402 v2, USDC on Base or Solana)
    servers:
    - url: https://api.annalist.dev
  /v1/ai/prices:
    get:
      operationId: ai_prices
      tags:
      - AI
      summary: What does this AI model cost per million tokens, on which providers, and which…
      description: 'AI model prices per million tokens (input, output, cache, batch) with context window, for about 4,000 models across providers. With model=: its price history and the same model on other providers. Without: a list filtered by provider, mode, min_context and max_input price, sorted by input, output or context. History from January 2026. Source: LiteLLM''s open price file (MIT). Signed.'
      x-price: $0.01
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.010000'
        protocols:
        - x402: {}
      parameters:
      - name: model
        in: query
        required: false
        schema:
          type: string
      - name: provider
        in: query
        required: false
        schema:
          type: string
      - name: mode
        in: query
        required: false
        schema:
          type: string
          description: chat, embedding, image_generation...
      - name: min_context
        in: query
        required: false
        schema:
          type: string
      - name: max_input
        in: query
        required: false
        schema:
          type: string
          description: max input price, USD per million tokens
      - name: sort
        in: query
        required: false
        schema:
          type: string
          enum:
          - input
          - output
          - context
      - name: limit
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Signed data
          content:
            application/json:
              schema:
                type: object
                required:
                - as_of
                - data
                - signature
                properties:
                  as_of:
                    type: string
                    format: date-time
                  data:
                    type: object
                  method:
                    type: object
                  request_id:
                    type: string
                  stale:
                    type: boolean
                  sources:
                    type: array
                    items:
                      type: string
                  notice:
                    type: string
                  key_id:
                    type: string
                  signature:
                    type: string
                    description: Ed25519 over RFC 8785 canonical JSON of {as_of, data, method, request_id}
                  signature_info:
                    type: string
              example:
                data:
                  model:
                    model: claude-sonnet-4-5
                    input_per_mtok: 3
                    output_per_mtok: 15
                    max_input_tokens: 200000
                    history: []
                  also_listed_as:
                  - model: bedrock/anthropic.claude-sonnet-4-5
                    input_per_mtok: 3.3
        '402':
          description: Payment required (x402 v2, USDC on Base or Solana)
    servers:
    - url: https://api.annalist.dev
  /v1/ai/changes:
    get:
      operationId: ai_changes
      tags:
      - AI
      summary: Which AI model prices changed recently, and which models were added or retired?
      description: 'Recent changes to AI model prices and availability across providers, newest first: price cuts and raises per field (with the change), models added and removed, context-window changes and deprecation dates, for the last 1 to 90 days, optionally by provider or model name. Source: LiteLLM''s open price file (MIT), recorded daily. Signed.'
      x-price: $0.01
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.010000'
        protocols:
        - x402: {}
      parameters:
      - name: days
        in: query
        required: false
        schema:
          type: string
      - name: provider
        in: query
        required: false
        schema:
          type: string
      - name: model
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Signed data
          content:
            application/json:
              schema:
                type: object
                required:
                - as_of
                - data
                - signature
                properties:
                  as_of:
                    type: string
                    format: date-time
                  data:
                    type: object
                  method:
                    type: object
                  request_id:
                    type: string
                  stale:
                    type: boolean
                  sources:
                    type: array
                    items:
                      type: string
                  notice:
                    type: string
                  key_id:
                    type: string
                  signature:
                    type: string
                    description: Ed25519 over RFC 8785 canonical JSON of {as_of, data, method, request_id}
                  signature_info:
                    type: string
              example:
                data:
                  days: 30
                  counts:
                    price_changed: 120
                    model_added: 40
                  events:
                  - date: '2026-10-13'
                    model: gpt-x
                    type: price_changed
                    field: input_cost_per_token
                    from: 2.5e-06
                    to: 1.25e-06
                    change: -0.5
        '402':
          description: Payment required (x402 v2, USDC on Base or Solana)
    servers:
    - url: https://api.annalist.dev
x-refined-from:
- annalist-dev-openapi.json
- openapi.json