Centaur API

Checks and payment terms on this page refer to the first endpoint's example. Other endpoints have not been checked individually.

Base URLhttps://api.centaur.io/v1/x402

• GET/feed$0.50Posts from the last seven days in which traders announce trades, newest first. Each result is one post (text, attachments, link, trader) with the trade actions it announces: asset, long or short, action, time and price.
  6 parameters and an example

  • limitqueryRequested feed items per page, 1 to 100. Default 10. Each item is one billable unit, even if it contains several events. The quote charges for this limit, even if fewer items are returned.
  • assetsqueryOnly results for these assets, by name, ticker (for example BTC), slug or numeric ID, comma-separated, up to 20. Matching ignores case. A value that matches no asset, or several, returns 422 and is not charged; several matches list candidates to retry with.
  • cursorqueryPaste data.meta.nextCursor from the previous response to get the next, older page with the same filters. Omit for the first page. Each page is a separate paid request.
  • endTimequeryInclude posts published at or before this time (ISO 8601). Defaults to now.
  • tradersqueryOnly results for these traders, by name, slug, X or Telegram handle, profile URL or numeric ID, comma-separated, up to 20. Matching ignores case. A value that matches no trader, or several, returns 422 and is not charged; several matches list candidates to retry with.
  • startTimequeryInclude posts published at or after this time (ISO 8601). The feed covers the last seven days; an earlier value starts seven days ago.

  curl -i 'https://api.centaur.io/v1/x402/feed'

• GET/messages$0.02Posts by traders on X and Telegram, newest first: text, attachments, publication time, link and author account. Filter by trader, platform, time or post ID. Covers roughly the last 90 days.
  7 parameters and an example

  • idsqueryFetch specific posts by ID, comma-separated. Use id from a /messages or /feed result. Unknown IDs return no result. Other filters still apply.
  • limitqueryResults per page, 1 to 200. Default 50. An empty page is also paid.
  • cursorqueryPaste data.meta.nextCursor from the previous response to get the next page with the same filters. Omit for the first page. Each page is a separate paid request.
  • endTimequeryInclude posts published at or before this time (ISO 8601).
  • tradersqueryOnly results for these traders, by name, slug, X or Telegram handle, profile URL or numeric ID, comma-separated, up to 20. Matching ignores case. A value that matches no trader, or several, returns 422 and is not charged; several matches list candidates to retry with.
  • startTimequeryInclude posts published at or after this time (ISO 8601), for example 2026-09-01T00:00:00Z.
  • sourcePlatformsqueryOnly posts from X or TELEGRAM. Use X,TELEGRAM or omit for both.

  curl -i 'https://api.centaur.io/v1/x402/messages'

• GET/positions$0.50Positions traders have opened, newest first: asset, long or short, entry time and price, and the return 1, 7 and 30 days after entry. Returns measure the price move after entry, not realized profit; a status explains any missing return. Covers roughly the last 90 days.
  7 parameters and an example

  • limitqueryRequested results per page, 1 to 200. Default 10. The quote charges for this limit, even if fewer results are returned.
  • assetsqueryOnly results for these assets, by name, ticker (for example BTC), slug or numeric ID, comma-separated, up to 20. Matching ignores case. A value that matches no asset, or several, returns 422 and is not charged; several matches list candidates to retry with.
  • cursorqueryPaste data.meta.nextCursor from the previous response to get the next page with the same filters. Omit for the first page. Each page is a separate paid request.
  • endTimequeryInclude positions opened at or before this time (ISO 8601). Returns are measured after each entry.
  • tradersqueryOnly results for these traders, by name, slug, X or Telegram handle, profile URL or numeric ID, comma-separated, up to 20. Matching ignores case. A value that matches no trader, or several, returns 422 and is not charged; several matches list candidates to retry with.
  • startTimequeryInclude positions opened at or after this time (ISO 8601), for example 2026-09-01T00:00:00Z. Filters the entry time, not the closing time.
  • directionsqueryFilter by direction: long expects the price to rise, short expects it to fall. Use long, short or long,short. Omit for both.

  curl -i 'https://api.centaur.io/v1/x402/positions'

• GET/traders/rankings$0.20Traders ranked by trading activity, win rate, average or median return, or Sharpe ratio. Each result gives the trader, rank, metric value, activity counts and, for performance rankings, the figures behind it. Ranks by activity by default; choose a performance metric and window to rank by returns.
  8 parameters and an example

  • limitqueryTraders to return, 1 to 50. Default 10.
  • assetsqueryOnly results for these assets, by name, ticker (for example BTC), slug or numeric ID, comma-separated, up to 20. Matching ignores case. A value that matches no asset, or several, returns 422 and is not charged; several matches list candidates to retry with.
  • metricqueryWhat to rank by: event_count counts trade actions (default); position_count counts positions; win_rate is the percent of positions with a positive return; avg_return and median_return are percent returns; sharpe_ratio is return relative to its variability. Highest values rank first. Activity counts say nothing about profitability.
  • endTimequeryInclude positions opened at or before this time (ISO 8601). Defaults to now.
  • directionqueryOnly long positions (expecting a rise) or only short positions (expecting a fall). Omit for both.
  • startTimequeryInclude positions opened at or after this time (ISO 8601). Defaults to 1 January (UTC) of the endTime year.
  • minPositionsqueryMinimum positions with a return for the chosen window. Defaults to 3; 0 includes every trader, so check positionsCount. Ignored for activity metrics.
  • timeBasedPerformanceWindowqueryMeasure returns 1D, 7D or 30D after each entry. Defaults to 30D for performance metrics; ignored for event_count and position_count. If the time range is too recent for the window, 422 lists valid alternatives and is not charged.

  curl -i 'https://api.centaur.io/v1/x402/traders/rankings'

• GET/traders/stats$0.10Track record of the traders you choose: average and median return, win rate and Sharpe ratio 1, 7 and 30 days after entry, with sample size, most-traded assets, long/short split and topic tags. Figures come from the positions traders announce, not from verified account returns.
  6 parameters and an example

  • assetsqueryOnly results for these assets, by name, ticker (for example BTC), slug or numeric ID, comma-separated, up to 20. Matching ignores case. A value that matches no asset, or several, returns 422 and is not charged; several matches list candidates to retry with.
  • endTimequeryInclude positions opened at or before this time (ISO 8601). Returns are measured after each entry.
  • tradersquery, requiredexample-traderRequired. The traders to report on, by name, slug, X or Telegram handle, profile URL or numeric ID, comma-separated, up to 20. Matching ignores case. Values that match no trader are listed in meta.missingTraders; a value that matches several returns 422 with candidates and is not charged.
  • directionqueryOnly long positions (expecting a rise) or only short positions (expecting a fall). Omit for both.
  • startTimequeryInclude positions opened at or after this time (ISO 8601), for example 2026-09-01T00:00:00Z. Filters the entry time, not the closing time.
  • sourcePlatformsqueryOnly traders who post on X or TELEGRAM. Use X,TELEGRAM or omit for both.

  curl -i 'https://api.centaur.io/v1/x402/traders/stats?traders=example-trader'

A dash means the listing gives no price or method. {Braces} mark a value you fill in. Copy buttons copy an example URL.