# Centaur Docs

> Public documentation for Centaur's read-only data API and MCP surface.

## Docs

- [Overview](https://partners.centaur.io/docs/centaur/overview.md): Structured trading intelligence from high-signal public trader activity.
- [Coverage](https://partners.centaur.io/docs/centaur/coverage.md): Centaur's current data sources, trader universe, and asset coverage.
- [How It Works](https://partners.centaur.io/docs/centaur/how-it-works.md): How Centaur turns trader activity into source-backed market intelligence.
- [Product Surfaces](https://partners.centaur.io/docs/platform/product-surfaces.md): How the Centaur app maps to the underlying trading data concepts.
- [Feed](https://partners.centaur.io/docs/platform/feed.md): Monitor recent trade activity across all tracked traders or only followed traders.
- [Following](https://partners.centaur.io/docs/platform/following.md): Follow traders and assets, then use that set across Feed and discovery workflows.
- [Trader Discovery](https://partners.centaur.io/docs/platform/trader-discovery.md): Find and evaluate traders from Centaur's tracked universe.
- [Trader Profile](https://partners.centaur.io/docs/platform/trader-profile.md): A source-backed track record and live position view for each tracked trader.
- [Asset Discovery](https://partners.centaur.io/docs/platform/asset-discovery.md): Find assets with active trader involvement and current open-position skew.
- [Asset Profile](https://partners.centaur.io/docs/platform/asset-profile.md): All tracked trader activity on a single asset, in one view.
- [Assistant](https://partners.centaur.io/docs/platform/assistant.md): How the in-app Centaur assistant uses tool-backed data.
- [Source Transparency](https://partners.centaur.io/docs/platform/source-transparency.md): How Centaur connects structured data back to the source material that produced it.
- [Trade Events](https://partners.centaur.io/docs/methodology/trade-events.md): What qualifies as a trade event, how events are structured, and how they connect to messages and positions.
- [Trade Classification](https://partners.centaur.io/docs/methodology/trade-classification.md): How Centaur classifies live, retrospective, assumed, and auto-generated events.
- [Trading Metrics](https://partners.centaur.io/docs/methodology/trader-metrics.md): How Centaur computes time-based performance, win rate, bias, and related trader metrics.
- [Positioning vs Performance](https://partners.centaur.io/docs/methodology/positioning-vs-performance.md): The difference between current open-position skew and historical time-based performance.
- [Profile Trades](https://partners.centaur.io/docs/methodology/profile-trades.md): How messages, events, and positions relate on trader and asset profiles.
- [Glossary](https://partners.centaur.io/docs/methodology/glossary.md): Definitions for key terms used across Centaur.
- [Centaur API](https://partners.centaur.io/docs/guides/quickstart.md): Quickstart for read-only access to Centaur's data over REST and OAuth-enabled MCP.
- [Authentication](https://partners.centaur.io/docs/guides/overview/authentication.md): REST uses Centaur API keys; MCP uses OAuth in supported clients.
- [API Keys and Connected Apps](https://partners.centaur.io/docs/guides/overview/api-keys-connected-apps.md): Manage REST API keys, MCP OAuth apps, and Telegram bot setup from the Centaur app.
- [Agent and Client Contract Limits](https://partners.centaur.io/docs/guides/agent-client-contract-limits.md): Important limits and unsupported inferences for REST, MCP, and agent clients.
- [REST Overview](https://partners.centaur.io/docs/guides/rest/overview.md): Make your first call against the Centaur REST API.
- [Available Data Reads](https://partners.centaur.io/docs/guides/rest/data-reads.md): Pick the right REST endpoint or MCP tool for the partner feed, events, messages, summaries, positions, discovery, and stats.
- [Partner Feed](https://partners.centaur.io/docs/guides/rest/feed.md): Read presentation-ready source-message groups and poll for curated event changes.
- [Events Usage Guide](https://partners.centaur.io/docs/guides/rest/events.md): Filter, sort, and paginate the public events feed.
- [MCP Overview](https://partners.centaur.io/docs/guides/mcp-agents/overview.md): Connect agent-native clients to the Centaur MCP surface with OAuth.
- [Client Setup](https://partners.centaur.io/docs/guides/mcp-agents/client-setup.md): Choose a supported client and follow the matching setup guide for the Centaur MCP server.
- [Claude](https://partners.centaur.io/docs/guides/mcp-agents/clients/claude.md): Set up Centaur in Claude through a hosted remote MCP connector using the plain MCP URL and OAuth-first auth.
- [ChatGPT](https://partners.centaur.io/docs/guides/mcp-agents/clients/chatgpt.md): Set up Centaur in ChatGPT through a hosted connector or GPT action flow with OAuth-first auth.
- [Cursor](https://partners.centaur.io/docs/guides/mcp-agents/clients/cursor.md): Set up Centaur in Cursor through a local MCP configuration with OAuth-first auth.
- [Codex](https://partners.centaur.io/docs/guides/mcp-agents/clients/codex.md): Set up Centaur in Codex through the Codex CLI or config file with OAuth-first auth.
- [Claude Code](https://partners.centaur.io/docs/guides/mcp-agents/clients/claude-code.md): Set up Centaur in Claude Code through Anthropic's remote HTTP MCP flow with OAuth-first auth.
- [Prompts to Get Started](https://partners.centaur.io/docs/guides/mcp-agents/prompts-to-get-started.md): Starter prompts that steer MCP clients toward supported Centaur reads.
- [Public Skill](https://partners.centaur.io/docs/guides/mcp-agents/public-skill.md): Install and use the public Centaur API skill from GitHub as a workflow layer on top of the full Centaur surface.
- [API Reference Overview](https://partners.centaur.io/docs/api-reference/overview.md): OpenAPI-backed reference plus the core conventions used across the full Centaur REST and MCP surface.
- [Request and Response Envelopes](https://partners.centaur.io/docs/api-reference/conventions/request-response-envelopes.md): Understand the normalized REST envelope and how MCP structured content maps to historical lists, open positions, and stats.
- [Query Semantics](https://partners.centaur.io/docs/api-reference/conventions/query-semantics.md): Filter rules, cursor behavior, and applied time-range behavior across the full Centaur read surface.
- [Errors](https://partners.centaur.io/docs/api-reference/conventions/errors.md): Error expectations for REST requests and MCP tool calls.
- [Get service health](https://partners.centaur.io/docs/api-reference/system/get-service-health.md): Returns the current service health status.
- [List trading events](https://partners.centaur.io/docs/api-reference/events/list-trading-events.md): Returns source-backed and classified trading events. Event rows can include assumed, retrospective, and auto-generated flags; user-facing clients should usually hide assumed and auto-generated system events.
- [List the curated partner feed](https://partners.centaur.io/docs/api-reference/feed/list-the-curated-partner-feed.md): Returns presentation-ready source-message groups ordered by message post time. Use cursor for scroll-back pagination or since for ingestion-watermark change polling with whole-group upsert semantics.
- [List source message feed](https://partners.centaur.io/docs/api-reference/messages/list-source-message-feed.md): Returns eligible source messages by source platform, message timestamp, or direct Source Message ID hydration. Messages do not support trader, asset, direction, or event-type filters.
- [List generated channel narrative summaries](https://partners.centaur.io/docs/api-reference/channel-summaries/list-generated-channel-narrative-summaries.md): Returns generated channel narrative summaries selected by Source Window overlap. Results expose traderId for continuity but not channel identity or raw source material.
- [List generated aggregate narrative summaries](https://partners.centaur.io/docs/api-reference/aggregate-summaries/list-generated-aggregate-narrative-summaries.md): Returns generated aggregate narrative summaries selected by Aggregate Window overlap. Results expose coverage counts rather than source trader or channel identities.
- [List positions](https://partners.centaur.io/docs/api-reference/positions/list-positions.md): Returns open and closed position history by position open time, including 1D, 7D, and 30D time-based performance where available.
- [List open positions](https://partners.centaur.io/docs/api-reference/positions/list-open-positions.md): Returns currently open positions with best-effort current marks and live mark-to-market return when pricing is available.
- [List traders](https://partners.centaur.io/docs/api-reference/discovery/list-traders.md)
- [List assets](https://partners.centaur.io/docs/api-reference/discovery/list-assets.md)
- [List trader stats](https://partners.centaur.io/docs/api-reference/stats/list-trader-stats.md): Returns aggregate trader stats for explicit trader IDs, including 1D, 7D, and 30D time-based performance, editorial trader tags, and missing/inaccessible IDs in metadata.
- [List asset stats](https://partners.centaur.io/docs/api-reference/stats/list-asset-stats.md): Returns aggregate asset stats for explicit asset IDs, including market positioning and top trader ID references with missing/inaccessible IDs in metadata.
- [Rank traders](https://partners.centaur.io/docs/api-reference/rankings/rank-traders.md): Ranks traders across the platform by activity or performance over an explicit UTC time window, without requiring trader IDs. Returns a small bounded result ordered by the applied metric. Use this instead of paging raw events or messages for "most active" or "best performing" questions.
- [Summarize message and event activity](https://partners.centaur.io/docs/api-reference/rankings/summarize-message-and-event-activity.md): Returns deterministic message and event counts over an explicit UTC time window, grouped by trader or overall and bucketed by a fixed interval. An Activity Summary is evidence-grade for counts, volumes, and trends; it is not a generated narrative summary. Use this instead of paging raw messages or e…
- [Changelog](https://partners.centaur.io/docs/changelog.md): Public changelog for API and documentation updates.
- [Partner API Terms of Service](https://partners.centaur.io/docs/legal/partner-api-terms-of-service.md): Terms governing access to and use of the Centaur Partner Platform.
- [Partner Privacy Policy](https://partners.centaur.io/docs/legal/partner-privacy-policy.md): How Centaur handles personal data in connection with the Partner Platform.

## OpenAPI Specs

- [openapi](https://partners.centaur.io/docs/openapi.json)