---
title: "XIRR (Irregular Dated Cash Flows)"
method: POST
path: "/v1/tools/compute_xirr"
tags: ["TODO_TAGS_REVIEW"]
---

# XIRR (Irregular Dated Cash Flows)

`POST /v1/tools/compute_xirr`

## Request

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

Annualized rate of return for irregular-interval dated cash flows, matching Excel XIRR semantics exactly: fixed actual/365 day count, anchored to the first cash flow date, solved by deterministic bisection over a declared rate bracket. Companion to compute_irr for cash flows that do not fall on equal periods.

**Tool URL:** https://ainumbers.co/chaingraph/art-326-tvm-xirr.html
**AP2/Policy Mandate export:** yes

## Request body

- object
  - `bracket_hi` number
  - `bracket_lo` number
  - `cash_flows` unknown[], required
    - unknown
  - `max_iterations` number
  - `tolerance` number, required

## Response `200`

Successful tool execution result

- object
  - `anchor_date` string
  - `bracket_hi_pct` integer
  - `bracket_lo_pct` number
  - `converged` boolean
  - `day_count_convention` string
  - `iterations` integer
  - `method` string
  - `note` string
  - `num_cash_flows` integer
  - `regulatory_basis` string
  - `tolerance` number
  - `xirr_pct` number

---

[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)