---
title: "Return a precise reference interest rate — the exact figure an agent injects into a treasury, lending, valuation or trad"
method: POST
path: "/api/v1/call/interest_rate"
tags: ["data"]
---

# Return a precise reference interest rate — the exact figure an agent injects into a treasury, lending, valuation or trad

`POST /api/v1/call/interest_rate`

## Request

- Base URL: `https://mcp.gapup.io`
- URL: `https://mcp.gapup.io/api/v1/call/interest_rate`
- Auth: HTTP bearer

Return a precise reference interest rate — the exact figure an agent injects into a treasury, lending, valuation or trading model. Available rates: fed_funds, sofr, us_10y, us_2y, us_3m, ecb_main, euribor_3m. Source: FRED (Federal Reserve Bank of St. Louis). When to use: an agent's computation needs a current benchmark rate as a precise input.

## Request body

- object
  - `rate` 'fed_funds' | 'sofr' | 'us_10y' | 'us_2y' | 'us_3m' | 'ecb_main' | 'euribor_3m', required: Reference rate name
  - `async` boolean: If true, returns a job_id immediately (<200ms) instead of waiting for the result. Poll the result with job_result(job_id). Use for slow tools to avoid client timeouts.

## Response `200`

Tool result

- object
  - `tool` string
  - `result` object
    - `rate` string, required
    - `series_id` string
    - `value` unknown, required
    - `unit` string, required
    - `as_of` unknown, required
    - `source` string, required
    - `source_url` string
  - `request_id` string
  - `source` 'rest-api'
  - `ms` number

## Other responses

- `400`: Invalid arguments
- `401`: Unauthorized
- `402`: Payment Required — pay via x402 (USDC on Base) then retry with X-Payment header
- `404`: Tool not found
- `429`: Rate limited
- `500`: Internal error

---

[API](https://skmtc.dev/gapup/apis/gapup-mcp-rest-api.md) · [All operations](https://skmtc.dev/gapup/apis/gapup-mcp-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gapup/apis/gapup-mcp-rest-api/revisions/afb9da3b98f4?raw)