Fourteen endpoints, a read-only MCP server, and what you can actually put in front of a user or an agent with them.
Centaur · Research
August 24, 2026 · 7 min read
Centaur is the social signal layer for trading intelligence: it reads every trade the best traders post across X and Telegram and turns it into a signal you can build on, the moment it happens rather than three days late. This API is that layer's raw form.
A pipeline reads what a trader posts, keeps only the messages that describe an actual position rather than commentary, and turns each signal into a timestamped trade event linked back to its source. It is read-only, it does not execute anything, and it measures the signal a trader chose to share publicly, not their complete trading record.
Centaur's own docs already cover the schema well, and developers name technical documentation their single most-used learning resource for exactly this reason. What the docs don't answer is the question a builder actually starts with: is this worth the integration. That's what the rest of this is for.
Five things, roughly in order of how often we hear them.
A discovery feed. A chronological stream of what tracked traders are opening, closing and resizing, each item linking back to the post it came from. This is the one that answers "what should I even look at" for a user who just landed with no thesis, and it is the difference between a product that shows several hundred markets and one that shows a reason to pick one.
Trader positioning, on an asset page you already have. Alongside price and depth, show who is currently long or short a given asset, and who moved recently. No new page, just a module on the one you have.
An auditable leaderboard. Ranked by win rate, median return and Sharpe ratio, with a minimum number of tracked positions before a trader is even eligible, so three lucky calls cannot outrank three hundred.
That floor exists specifically because a leaderboard ranked on raw returns or follower count is easy to game and, on the evidence, actively misleading. Rank on the corrected version instead.
Grounded input for a trading agent. Sentiment tools measure the mood, what people are talking about, and how loudly. Centaur measures the move, the actual position a specific trader took, when they took it, and what happened next.
A discrete, timestamped, source-linked signal gives an agent something it can cite: this trader, this asset, this direction, at this time, here is the post. That is a meaningfully different kind of input, and it is the shape most agent frameworks actually want.
A research pull for backtesting. Full position history with fixed 1D, 7D and 30D returns, ready to export and test a hypothesis against, rather than something you have to reconstruct from raw social posts yourself.
None of these require you to touch execution. Everything above is a read, sitting in front of whatever already handles trading in your product.
Auth is one header, and the first call is one request:
curl 'https://partners.centaur.io/api/v1/events?limit=10' -H 'x-api-key: <key>'
Behind it, a pipeline reads what a trader posts, keeps only messages that describe an actual position, and turns each one into a timestamped signal linked back to its source.
Every signal carries one of three flags, posted live, described after the fact, or inferred by the system, and the docs say which of those to hide by default. That's a trust argument you can check yourself, not an accuracy number you have to take on faith.
The surface behind all of it is fourteen REST endpoints and a twelve-tool MCP server, one tool per data family, documented for Claude, Claude Code, ChatGPT, Cursor and Codex. Being OAuth-native is a genuine, checkable difference in this category, not a marketing line: it's why Centaur can be added through Claude's connector UI in a couple of clicks, where at least one comparable social-data MCP server cannot, because it authenticates with a static token instead.
Being read-only matters again here, for a distribution reason, not a trust one: Anthropic's directory policy bars anything that can execute a financial transaction, which is why the exchange servers that let an agent place an order are absent from that 950-plus server directory, and why a read-only server is eligible.
Rate limits, pagination caps, and a specific list of questions the API deliberately will not answer in one call are all published rather than discovered by trial and error. The exact numbers, the full endpoint reference, and a working quickstart are at partners.centaur.io/docs, that's the page to have open while you build, not this one.
No execution, no custody, no on-chain verification behind any of it, and no advice in the regulatory sense: a ranked list built on published, mechanical criteria is information, not a recommendation. It is a discovery and context layer, not a replacement for whatever already handles trading in your product.
Get a key from your account, no call required, and make the first request yourself. If you already work inside Claude, Cursor, Codex or ChatGPT, install the public skill instead (npx skills add https://github.com/centaur-io/centaur-partners-skill). If what you're actually looking at is a deeper integration, talk to the partnerships team instead of the docs.
The schema is not the interesting part. What is interesting is what it lets you skip: the extraction pipeline, the deduplication, the evaluation windows, all the unglamorous work that sits between a public post and something you can rank, show or feed to an agent. A discovery feed, a positioning module, an auditable leaderboard, and grounded input for an agent are all one documented call away.
The point of building any of it is the same one Centaur is built on: making the world's best trading activity readable at human speed, whether the reader on the other end is a person or an agent.
If any of those five things is missing from your product, the fastest way to know if this fits is to make the first call yourself.
__________________________________________________________________________________
See why your users don't know what to trade, or get a key and make the first call yourself.
Nothing in this article is investment advice. Centaur measures trades disclosed publicly by traders and does not verify broker or on-chain activity.
