Robotico API
Read published company, article, and timeline data over HTTPS. These routes return the same payloads as the hosted MCP tools. Agent setup stays on the MCP server guide.
Authentication
Send Authorization: Bearer <token> on every catalog request. The token is the same credential as https://robotico.market/mcp: an OAuth access token, or an existing developer token that starts with rbt_. The account must be enabled and email-verified. Review connected agents from account settings after signing in.
A missing or invalid token returns 401 with a WWW-Authenticate challenge. GET /api/search-index stays public. Article create, update, and the signed-in article list stay on session auth.
Free and Pro
Each account has an API plan, free or pro, stored separately from platform roles. Free accounts can make 10 authenticated requests per UTC day. That allowance is shared by every token on the account and by these catalog routes together with /api/mcp. Pro accounts have no daily cap. A superadmin can grant Pro to a specific account before billing is in place.
When a Free account reaches the daily allowance, the next authenticated call returns 429:
{ "error": "Daily request limit reached. Free accounts can make 10 requests per day." }The response includes Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset. The allowance starts again at the next UTC midnight. Authenticated calls count toward the allowance, including a lookup that returns 404. A 401 stays outside the allowance.
Hosted MCP tool calls through /api/mcp are also limited to 240 requests per 60 seconds for every account.
Get a company
- Method
- GET
- Path
/api/companies/{id}- Auth
- Bearer token
id is a published company id or public slug. The JSON body is the MCP get_company profile: identity, market fields, robots, investors, founding team, and valuation history. An unknown or unpublished company returns 404 with { "error": "Company not found" }.
curl -H "Authorization: Bearer $ROBOTICO_TOKEN" \
"https://robotico.market/api/companies/figure"List articles
- Method
- GET
- Path
/api/articles?company={id}- Auth
- Bearer token
Returns the MCP list_articles payload: count and articles. Optional type is article or signal. Optional limit defaults to 20 and cannot exceed 500. A company id with no published articles returns { "count": 0, "articles": [] }. Calling this path without company lists the signed-in user’s own articles and requires a session.
curl -H "Authorization: Bearer $ROBOTICO_TOKEN" \
"https://robotico.market/api/articles?company=figure&type=article&limit=20"List timeline events
- Method
- GET
- Path
/api/timeline- Auth
- Bearer token
Returns count and events. Optional filters are company_id (alias companyId), date_from, date_to, event_type, category, confidence_min (0 to 1), materiality_min (1 to 5), and limit (maximum 500). When limit is omitted, the list returns up to 100 events.company_id keeps only events linked to that company.
curl -H "Authorization: Bearer $ROBOTICO_TOKEN" \
"https://robotico.market/api/timeline?company_id=figure&limit=100"Get one timeline event
- Method
- GET
- Path
/api/timeline/{eventId}- Auth
- Public. Bearer token when sent
eventId is the event UUID. The body is { "event": { ... } } with evidence claims, sources, and structured changes. A request with noAuthorization header is a public read and is not counted. A request that sends Authorization must carry a valid Bearer token, and a Free account’s call counts toward the daily allowance. An unknown id returns 404.
Machine-readable spec
The OpenAPI 3.1 document for these routes is at https://robotico.market/openapi.json. Unpublished companies, evidence uploads, and writes stay on the hosted MCP server. See the MCP server guide for that surface.