OQRO for AI agents

1. Read any page as Markdown

Add .md to the address of any public page. The answer is the page's own content as Markdown, without menus, scripts or styles. No account, no key, no header to set.

https://oqro.io/stocks/AAPL.md      # the Apple page
https://oqro.io/insiders.md         # latest insider trades
https://oqro.io/index.md            # the home page

A client that can set headers may ask the page's normal address with Accept: text/markdown instead; the result is the same. Limit: 60 pages a minute. A page that does not exist answers 404 with a Markdown body that says where to look.

The full list of pages is in llms.txt and the sitemap.

2. Call OQRO as tools (MCP server)

For a precise question (one ticker, one person, a date range), tools are better than reading pages. OQRO has a remote MCP server over Streamable HTTP with read-only tools. It is free: the client opens the OQRO sign-in by OAuth on first use, and a free account is enough.

MCP server:   https://oqro.io/api/mcp
Server card:  https://oqro.io/.well-known/mcp

Start with search_companies to turn a company name into a ticker, then call the tool that fits. Set-up steps for Claude, ChatGPT and other clients are on the MCP server page.

3. Call the REST API

The same data as read-only JSON at https://oqro.io/api/v1. It needs a personal key, which is free with a free account. Limits: 60 requests a minute and 5,000 a day per key. Every row carries source_url (the official filing) and oqro_url.

curl "https://oqro.io/api/v1/insider-trades?ticker=NVDA&side=sell&days=180&limit=5" \
  -H "Authorization: Bearer $OQRO_API_KEY"

Reference: API docs, openapi.json and the developer guide (errors, rate-limit headers, versioning).

Questions OQRO answers

Not a fit: live price quotes, investment recommendations, companies not listed in the US, and anything about why a person traded. The filings do not show motive.

Rules when you quote OQRO

• Cite the official filing (source_url, or the source link on the page) next to the OQRO page.
• Amounts filed as ranges stay ranges. A trade by a member of Congress is reported as "$1,001 to $15,000"; do not turn it into one figure.
• Keep the filing delay in mind: Form 4 within 2 business days, Congress trades within 45 days, 13F within 45 days of quarter end. A 13F is a quarter-end snapshot with no trade date.
• A contract ceiling is not revenue. The amount obligated is kept apart from the ceiling.
• Planned sales (Rule 10b5-1) are kept apart from unscheduled ones. Say which one a sale is.
• OQRO describes public filings. It is not investment advice, so do not present a row as a reason to buy or sell.

What needs an account

In a browser, a person without an account reads one page and is then asked to create a free account. That step does not apply to AI assistants, to search crawlers or to the .md addresses.

Machine-readable files

• llms.txt

  What OQRO covers, when to use it and the pages worth reading.

• llms-full.txt

  The whole text of every guide and article in one file.

• openapi.json

  The REST API as an OpenAPI 3.1 description.

• MCP server card

  The MCP server's address, sign-in and tools, as JSON.

• sitemap.xml

  Every public page.