---
title: "IHB Interest Allocation"
method: POST
path: "/v1/tools/allocate_ihb_interest"
tags: ["TODO_TAGS_REVIEW", "TODO_AP2_EXPORT_REVIEW"]
---

# IHB Interest Allocation

`POST /v1/tools/allocate_ihb_interest`

## Request

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

Allocates overnight in-house-bank (IHB) interest across notional pool or ZBA sweep members. OECD Transfer Pricing Guidelines 2022 Chapter X arm's-length rate. Supports ACT/360, ACT/365, and 30/360 day-count conventions. Per-member withholding tax deduction. Returns per-member gross_interest, withholding_amount, net_interest, and total_interest_allocated. ZERO PII: member IDs are entity references only, no personal account-holder data.

**Tool URL:** https://ainumbers.co/chaingraph/art-260-allocate-ihb-interest.html

## Request body

- object
  - `arm_length_rate` unknown, required
  - `base_currency` unknown, required
  - `day_count_convention` unknown, required
  - `days` unknown, required
  - `pool_members` unknown[], required
    - unknown
  - `pool_type` unknown, required

## Response `200`

Successful tool execution result

- object
  - `allocations` object[]
    - `allocation_basis` string
    - `balance` integer
    - `entity_id` string
    - `gross_interest` integer
    - `net_interest` integer
    - `withholding_amount` integer
    - `withholding_rate` integer
  - `arm_length_rate` number
  - `base_currency` string
  - `day_count_convention` string
  - `day_count_fraction` number
  - `days` integer
  - `entity_count` integer
  - `net_interest_payable` integer
  - `not_legal_advice` string
  - `oecd_tp_compliant` boolean
  - `pii_note` string
  - `pool_net_balance` integer
  - `pool_type` string
  - `regulatory_basis` string
  - `table_source` string
  - `table_version` string
  - `total_interest_allocated` integer

---

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