---
title: "APY-Earned Recompute"
method: POST
path: "/v1/tools/compute_apy_earned_recompute"
tags: ["apy earned", "periodic statement", "yield recompute", "core verification", "recompute", "disclosure", "accuracy band"]
---

# APY-Earned Recompute

`POST /v1/tools/compute_apy_earned_recompute`

## Request

- Base URL: `https://ainumbers.co`
- URL: `https://ainumbers.co/v1/tools/compute_apy_earned_recompute`
- Auth: none declared

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

## Request body

- object
  - `interest_earned` number, required
  - `days_in_period` integer, required
  - `average_daily_balance` number
  - `balance_segments` unknown[]
    - unknown
  - `disclosed_apy_earned` number
  - `accuracy_band_pp` number
  - `special_formula_declared` boolean

## Response `200`

Successful tool execution result

- object
  - `verdict` 'MATCHES' | 'DIVERGES' | 'INDETERMINATE'
  - `apy_earned_computed` number, nullable: Unrounded recomputed yield, percentage points.
  - `apy_earned_computed_rounded` number, nullable: Recomputed yield at two decimals (display only; never feeds the verdict).
  - `abs_difference_pp` number, nullable: Absolute difference between computed and disclosed, percentage points.
  - `accuracy_band_pp` number
  - `within_accuracy_band` boolean, nullable
  - `average_daily_balance` number, nullable
  - `manual_review_required` boolean

---

[API](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite.md) · [All operations](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/llms.txt) · [OpenAPI document](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/revisions/b462e4f5bb28?raw)