> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oneshotagent.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Interest Rates
> Look up US overnight reference interest rates by date, as published by the Federal Reserve Bank of New York.
Daily US overnight reference rates published by the Federal Reserve Bank of New York, in percent per year: SOFR, EFFR (with the FOMC target range), OBFR, TGCR, BGCR and the SOFR averages and index. Returns observations newest first for a date range or the most recent published days.
OneShot is not affiliated with the New York Fed. The New York Fed does not sanction, endorse, or recommend any products or services offered by OneShot. The rate data is subject to the Terms of Use posted at newyorkfed.org; every answer carries the notice those terms require with any republication, in notice, and it must stay with the data when the answer is shown or passed on.
## Authentication
Requires x402 payment in the `payment-signature` header.
## Request Body
**rate** `string` *required*
Rate code: sofr, effr, obfr, tgcr, bgcr or sofr\_averages. One of `sofr`, `effr`, `obfr`, `tgcr`, `bgcr`, `sofr_averages`.
**start\_date** `string`
First date, YYYY-MM-DD; give both start\_date and end\_date or neither. YYYY-MM-DD.
**end\_date** `string`
Last date, YYYY-MM-DD, inclusive; at most 366 days after start\_date and not in the future. YYYY-MM-DD.
**last** `integer`
Number of most recent published days, 1 to 30, used when no dates are given. From 1 to 30. Defaults to `5`.
## Response (200 OK)
Top-level envelope: `success` (boolean) and `data` (object). All fields below are nested under `data`.
**data.request\_id** `string`
Durable job ID for audit and lookup
**data.status** `string`
Job status: `completed`
**data.tool** `string`
Always `market_interest_rates`
**data.result** `object`
The answer, described under Result below
**data.evidence** `object`
Where the answer came from and when
**data.evidence.source** `string`
The public body the data comes from. Always `Federal Reserve Bank of New York`.
**data.evidence.source\_kind** `string`
`public` when the data comes from a public body, `commercial` otherwise
**data.evidence.retrieved\_at** `string`
When the lookup was made, as an ISO 8601 UTC time
**data.evidence.as\_of** `string | null`
When the source says the fact was last updated, or `null` when the source gives no date
## Result
Nested under `data.result`.
**data.result.rate** `string`
Rate code asked for, upper-case.
**data.result.notice** `string`
The notice and disclaimer the New York Fed requires with any presentation of its reference rate data; keep it with the data.
**data.result.observations** `object[]`
One observation per business day, newest first.
**data.result.observations\[].date** `string`
Business day the rate applies to, YYYY-MM-DD; for sofr\_averages, the publication day.
**data.result.observations\[].percent** `number | null`
Rate in percent per year; null for sofr\_averages.
**data.result.observations\[].percentile\_1** `number | null`
1st percentile of underlying transaction rates, percent per year. `null` when the source gives no value.
**data.result.observations\[].percentile\_25** `number | null`
25th percentile, percent per year. `null` when the source gives no value.
**data.result.observations\[].percentile\_75** `number | null`
75th percentile, percent per year. `null` when the source gives no value.
**data.result.observations\[].percentile\_99** `number | null`
99th percentile, percent per year. `null` when the source gives no value.
**data.result.observations\[].volume\_billions\_usd** `number | null`
Volume of underlying transactions, billions of US dollars. `null` when the source gives no value.
**data.result.observations\[].target\_from** `number | null`
Lower bound of the FOMC federal funds target range, percent per year; effr only. `null` when the source gives no value.
**data.result.observations\[].target\_to** `number | null`
Upper bound of the FOMC federal funds target range, percent per year; effr only. `null` when the source gives no value.
**data.result.observations\[].average\_30\_day** `number | null`
30-day compounded SOFR average, percent per year; sofr\_averages only. `null` when the source gives no value.
**data.result.observations\[].average\_90\_day** `number | null`
90-day compounded SOFR average, percent per year; sofr\_averages only. `null` when the source gives no value.
**data.result.observations\[].average\_180\_day** `number | null`
180-day compounded SOFR average, percent per year; sofr\_averages only. `null` when the source gives no value.
**data.result.observations\[].index** `number | null`
SOFR index, compounded from 1.0 on 2018-04-02; sofr\_averages only. `null` when the source gives no value.
**data.result.observations\[].revised** `boolean`
True when the source marks this day as revised.
```bash cURL theme={null}
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/market-interest-rates \
-H "Content-Type: application/json" \
-H "payment-signature: " \
-d '{
"rate": "sofr",
"start_date": "2026-10-15",
"end_date": "2026-10-16"
}'
```
```javascript JavaScript theme={null}
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/market-interest-rates", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"rate": "sofr",
"start_date": "2026-10-15",
"end_date": "2026-10-16"
}),
});
```
```typescript SDK theme={null}
const result = await agent.tool('lookup/market-interest-rates', {
rate: 'sofr',
start_date: '2026-10-15',
end_date: '2026-10-16'
});
console.log(result.result);
console.log(result.evidence);
```
```json Response (200) theme={null}
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "market_interest_rates",
"result": {
"rate": "SOFR",
"notice": "The SOFR data is subject to the Terms of Use posted at newyorkfed.org. The New York Fed is not responsible for publication of the SOFR data by OneShot, does not sanction or endorse any particular republication, and has no liability for your use. OneShot is not affiliated with the New York Fed. The New York Fed does not sanction, endorse, or recommend any products or services offered by OneShot. The Secured Overnight Financing Rate (SOFR) Data and Broad General Collateral Rate (BGCR) Data are calculated using data provided under a license granted to the New York Fed by DTCC Solutions LLC (\"Solutions\"), an affiliate of The Depository Trust & Clearing Corporation. Solutions, its affiliates, and third parties from which they obtained data have no liability for the content of this material.",
"observations": [
{
"date": "2026-10-16",
"percent": 3.88,
"percentile_1": 3.84,
"percentile_25": 3.85,
"percentile_75": 3.93,
"percentile_99": 3.95,
"volume_billions_usd": 2925,
"target_from": null,
"target_to": null,
"average_30_day": null,
"average_90_day": null,
"average_180_day": null,
"index": null,
"revised": false
},
{
"date": "2026-10-15",
"percent": 3.89,
"percentile_1": 3.85,
"percentile_25": 3.87,
"percentile_75": 3.94,
"percentile_99": 3.97,
"volume_billions_usd": 3025,
"target_from": null,
"target_to": null,
"average_30_day": null,
"average_90_day": null,
"average_180_day": null,
"index": null,
"revised": false
}
]
},
"evidence": {
"source": "Federal Reserve Bank of New York",
"source_kind": "public",
"retrieved_at": "2026-10-24T00:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-10-24T00:00:00.000Z"
}
],
"as_of": "2026-10-16"
}
}
}
```
> [!NOTE]
>
> See [Pricing](https://docs.oneshotagent.com/pricing.md) for this tool's price. A wallet (x402) call receives it in the 402 quote before anything is charged; a call paid from prepaid credits is charged when the API accepts the request and answers `200`.
## Notes
* Available rates are the secured overnight financing rate (sofr), the effective federal funds rate (effr, with the FOMC target range), the overnight bank funding rate (obfr), the tri-party general collateral rate (tgcr), the broad general collateral rate (bgcr) and the 30-, 90- and 180-day SOFR averages with the SOFR index (sofr\_averages).
* Returns one observation per business day, newest first, either for a date range (at most 366 days, not in the future) or the last 1 to 30 published days. Each observation carries the rate, its 1st, 25th, 75th and 99th percentiles and the underlying volume in billions of US dollars where the source publishes them; fields that do not apply to a rate are null. revised is true when the source marks the day as revised. A range with no business days returns an empty list.
* Overnight rates (sofr, effr, obfr, tgcr, bgcr) are dated the business day they apply to and published the next US business day; sofr\_averages is dated the day it is published and compounds SOFR through the previous business day. Source: Federal Reserve Bank of New York.
* Results return inline. The finished job stays available at `/v1/requests/{request_id}`
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.