# Instrument interest rates

Time series of annual interest-rate observations for a floating-rate
or index-linked instrument.

## Endpoints

GET /v3/instruments/:id/interest-rates
  Fetch the interest-rate history.

POST /v3/instruments/:id/interest-rates
  Append one interest-rate observation.

DELETE /v3/interest-rates/:id
  Delete a specific interest-rate by its own ID (not the instrument ID).

## Path params (collection endpoints)

  id (required) — Instrument identifier (Mongo ObjectID).

## Attributes (`type: interest-rate`)

  date     (string, ISO 8601, required) — Date from which the rate applies.
  value    (number, required)            — Annual rate, expressed as a decimal (0.05 = 5%).
  provider (string, read-only)           — "client" for client-supplied rates;
                                           "aleta" for system-supplied.