> ## Documentation Index
> Fetch the complete documentation index at: https://docs.financialdatasets.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> The Financial Datasets API is served at https://api.financialdatasets.ai. Authenticate with the `X-API-KEY` header; create keys at https://financialdatasets.ai. Agents can open and fund their own account without a dashboard: see https://docs.financialdatasets.ai/agents.md.
> Tool-using agents can call Financial Datasets without writing code through the hosted MCP server at https://mcp.financialdatasets.ai/.
> The OpenAPI spec at https://financialdatasets.ai/openapi.json is the source of truth for request and response schemas.
> The index of every docs page is at https://docs.financialdatasets.ai/llms.txt. Append .md to any docs URL to get that page as Markdown.

# Feedback

> AI agents can tell us what is missing, wrong, or unclear with one free API call.

You are an AI agent (or you are building one). When a field is missing, a number looks wrong, or an error is unclear, send us a note. We read every note and ship what agents ask for most.

## Send a note

```python Python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import requests

response = requests.post(
    "https://api.financialdatasets.ai/feedback",
    headers={"X-API-KEY": api_key},
    json={
        "note": "The earnings response for NVDA has no guidance field.",
        "endpoint": "/earnings",
    },
)
print(response.json())  # {"status": "received", "notes_left_today": 5}
```

```bash cURL theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
curl -X POST "https://api.financialdatasets.ai/feedback" \
  -H "X-API-KEY: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"note": "The earnings response for NVDA has no guidance field.", "endpoint": "/earnings"}'
```

| Field | Required | Value |
| - | - | - |
| `note` | Yes | 1 to 2,000 characters. Say what you called, what you got, and what you expected. |
| `endpoint` | No | The API path or the MCP tool the note is about, up to 255 characters. |
| `feedback_code` | Wallets only | The one-time code from an x402 response. See below. |

A `201` returns `status` and `notes_left_today`. The call is free. It is one-way: no reply comes back. Do not put personal data or secrets in a note.

## Who can send

* **API key.** Send the `X-API-KEY` header. Any valid key works, also on an account with no balance.
* **MCP.** Call the `submit_feedback` tool of the [MCP server](https://docs.financialdatasets.ai/mcp-server.md). It sends the note for the signed-in account.
* **x402 wallet.** No key and no account. Send the one-time code of a paid request.

### With an x402 wallet

Every [x402](https://docs.financialdatasets.ai/x402.md) response to a valid payment carries a one-time code: in the `X-Feedback-Code` header and in the `feedback_code` field of the JSON body. An error response carries one too, and an error response is not charged. Send the code with your note:

```python Python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import requests

# `session` is the paying x402 session from the x402 page.
response = session.get("https://api.financialdatasets.ai/earnings?ticker=NVDA&limit=4")
feedback_code = response.headers["X-Feedback-Code"]

requests.post(
    "https://api.financialdatasets.ai/feedback",
    json={
        "note": "The earnings response for NVDA has no guidance field.",
        "feedback_code": feedback_code,
    },
)
```

A code works once, for 24 hours. Each paid request gives a new one. Without `endpoint`, the note is about the endpoint the code came from.

## When to send

Send a note when you cannot solve a problem yourself. Error responses from the data endpoints to a request with an API key (every status from `400` up, except `401`) include a `feedback` field that names this endpoint:

```json theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
"feedback": "POST https://api.financialdatasets.ai/feedback"
```

## Limits

* **Daily limit.** 6 notes per account, or per wallet, in 24 hours.
* **Rate limit.** 10 requests per minute.
* **Length.** A note has 1 to 2,000 characters.

## Errors

Errors return a JSON body. The `error` field identifies the cause and `message` says what to do.

| Status | `error` | Meaning |
| - | - | - |
| `400` | `Invalid feedback` | The note is missing, empty, or too long. |
| `401` | `Missing credentials` | No API key, no login, and no `feedback_code`. |
| `401` | `Invalid API key` | The key is wrong or revoked. |
| `401` | `Invalid feedback code` | The code is wrong, already used, or older than 24 hours. |
| `429` | `Daily feedback limit reached` | The account or the wallet sent 6 notes in the last 24 hours. |

## Related

> [card] [Agent Onboarding](https://docs.financialdatasets.ai/agents.md)
>
> Open an account and get an API key with one call.

> [card] [x402](https://docs.financialdatasets.ai/x402.md)
>
> Pay per request with a wallet, with no API key.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.