AINumbers.co apy earned API

openapi: 3.2.0
info:
  title: AINumbers.co Fintech Intelligence Suite apy earned API
  version: 1.0.0
  description: '**1255 fintech intelligence tools** covering ISO 20022, A2A payments, CFPB §1033, EU AI Act, DORA, MiCA, AML/KYC, BaaS, DLT/tokenization, ESG/climate finance, agentic payments (AP2, ACP, x402, Visa TAP, Mastercard Agent Pay), PQC migration, sanctions screening, and OpenChainGraph v0.4 computation chains.


    ## Transport


    > **The live transport is MCP JSON-RPC 2.0 at `https://mcp.ainumbers.co/mcp` — not REST.**

    >

    > This OpenAPI file is a **descriptive data-room artifact** — a machine-readable index of all tools and their input/output schemas. The REST paths (`POST /v1/tools/{name}`) described here are a projection; they become functional only if the optional REST shim (Area 2 Path B) is deployed.

    >

    > To call tools today, connect via the official MCP client SDKs. TypeScript: `@modelcontextprotocol/sdk`. Python: `mcp`.


    ## Architecture


    All tools run **entirely client-side** (browser JavaScript). Zero PII. Zero server calls after page load. Deterministic, reproducible outputs. Licensed CC BY 4.0.


    OpenChainGraph v0.4 compute-binding nodes additionally run **server-side on the MCP Worker** and emit verifiable artifacts with `execution_hash` (WebCrypto SHA-256 over RFC 8785 canonical JSON).'
  contact:
    name: Post Oak Labs
    url: https://postoaklabs.com
    email: tim@postoaklabs.com
  license:
    name: CC BY 4.0
    url: https://creativecommons.org/licenses/by/4.0/
servers:
- url: https://ainumbers.co
  description: Static browser-based tool host (DreamHost). Tools run client-side — no REST gateway is active on this origin. See x-mcp for the live MCP endpoint.
tags:
- name: apy earned
paths:
  /v1/tools/compute_apy_earned_recompute:
    post:
      operationId: compute_apy_earned_recompute
      summary: APY-Earned Recompute
      description: 'Recomputes the annual percentage yield earned for a periodic statement from caller-declared inputs: interest actually earned for the period, the average daily balance (supplied directly or derived as the days-weighted mean of caller-declared balance spans), and the actual days in the period, using the compound general formula of the cited rule text (100*((1+I/B)^(365/D)-1)), then diffs the recomputed yield against the disclosed figure within a declared accuracy band whose 0.05pp default is the rule text own accuracy statement. Returns MATCHES, DIVERGES with the exact difference, or INDETERMINATE when inputs are outside the declared domain or no disclosed figure exists to diff against. The statement-more-often-than-compounding special formula is declared unsupported and refused, never approximated. An independent recompute-and-receipt over caller-declared contract inputs, not an audit of or substitution for any core platform, and not a claim about what any institution should have disclosed.


        **Tool URL:** https://ainumbers.co/tools/663-apy-earned-recompute.html

        **AP2/Policy Mandate export:** yes'
      tags:
      - apy earned
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - interest_earned
              - days_in_period
              properties:
                interest_earned:
                  type: number
                days_in_period:
                  type: integer
                average_daily_balance:
                  type: number
                balance_segments:
                  type: array
                disclosed_apy_earned:
                  type: number
                accuracy_band_pp:
                  type: number
                special_formula_declared:
                  type: boolean
      responses:
        '200':
          description: Successful tool execution result
          content:
            application/json:
              schema:
                type: object
                properties:
                  verdict:
                    type: string
                    enum:
                    - MATCHES
                    - DIVERGES
                    - INDETERMINATE
                  apy_earned_computed:
                    type:
                    - number
                    - 'null'
                    description: Unrounded recomputed yield, percentage points.
                  apy_earned_computed_rounded:
                    type:
                    - number
                    - 'null'
                    description: Recomputed yield at two decimals (display only; never feeds the verdict).
                  abs_difference_pp:
                    type:
                    - number
                    - 'null'
                    description: Absolute difference between computed and disclosed, percentage points.
                  accuracy_band_pp:
                    type: number
                  within_accuracy_band:
                    type:
                    - boolean
                    - 'null'
                  average_daily_balance:
                    type:
                    - number
                    - 'null'
                  manual_review_required:
                    type: boolean
      x-mcp-tool-name: compute_apy_earned_recompute
      x-tool-url: https://ainumbers.co/tools/663-apy-earned-recompute.html
      x-source: manifest
      x-ap2-export: true
x-mcp:
  transport: MCP JSON-RPC 2.0 (streamable HTTP)
  endpoint: https://mcp.ainumbers.co/mcp
  protocol_version: '2025-11-25'
  authentication: none
  registry: co.ainumbers/tools (official MCP registry)
  note: Connect any MCP-compatible client (Claude, ChatGPT, custom agent) directly to this endpoint. The REST paths in this file are descriptive only — they do not exist on the live server unless the REST shim is deployed.