> For the complete documentation index, see [llms.txt](https://ottodata.gitbook.io/ottodata-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ottodata.gitbook.io/ottodata-docs/resources/faq.md).

# FAQ

## FAQ

### Is the API really free?

Yes, during beta — no key, no account, no rate card. Paid tiers for heavy/commercial usage are on the roadmap; `/v1/` will stay stable either way.

### Where does the data come from?

Everything is collected deterministically:

* **On-chain**: Chainlink feed reads, `uiMultiplier()` / `oraclePaused()` contract reads, Uniswap `slot0`/`getReserves`, ERC-20 `Transfer` logs, deployment traces — via Robinhood Chain RPC.
* **Reference**: live NASDAQ prices from Polygon.
* **News**: Tree News and Marketaux, keyword-classified.
* **Social**: Reddit alpha signals from an upstream signal engine, served read-through.

No LLM touches the data path. Otto AI (the chat endpoint) consumes the data; it never produces it.

### Why does the on-chain price differ from the stock price even during market hours?

Chainlink's Hood stock feeds are **total-return** prices: share price × the token's `uiMultiplier()`, with dividends reinvested. Otto adjusts for this via `implied_mult` when computing `basis_bps`.

### Why is `chainlink_updated_at` hours old?

By design — the feeds freeze outside NASDAQ hours (no heartbeat). That freeze vs 24/7 token trading is exactly the dataset Otto exists to measure. See [Basis](https://ottodata.gitbook.io/ottodata-docs/concepts/basis-on-chain-vs-nasdaq).

### How fresh is each dataset?

| Dataset                  | Cadence                                      |
| ------------------------ | -------------------------------------------- |
| Basis ticks              | every minute                                 |
| Pools / oracle deviation | \~every 5 minutes                            |
| Flows                    | scanned continuously with the collector loop |
| News events              | \~every 5 minutes                            |
| Deployments              | continuous tail scan                         |
| Reddit intel             | read-through, \~60s cache                    |

### Can I get historical data?

Yes — history endpoints (`/v1/basis/{ticker}`, `/v1/gaps/{ticker}`, `/v1/pools/{ticker}`) serve everything collected since the feed went live. Deployments go back to chain genesis.

### Is there a rate limit?

Only Otto AI chat is rate-limited (10 req/min/IP). Data endpoints are unmetered during beta; please be reasonable — if you need sustained high-volume pulls, get in touch.

### How do I report a problem or request a dataset?

Use the contact page on the terminal, or open an issue on [GitHub](https://github.com/Degergokalp/otto-data).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ottodata.gitbook.io/ottodata-docs/resources/faq.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.