Skip to main content
GET
List traders

Authorizations

x-api-key
string
header
default:<api-key>
required

API key issued by Centaur.

Query Parameters

Case-insensitive partial match against trader name or slug.

Minimum string length: 1
traderIds

Positive integer trader IDs only. REST accepts comma-separated values or repeated parameters. MCP accepts an array. Numeric strings become IDs. Maximum 200 non-empty supplied entries per field, including duplicates. Use traderRefs for slugs. Do not supply traderIds and traderRefs together, even if one is empty.

Example:

"7,12"

traderRefs

Trader slugs as strings only. REST accepts comma-separated values or repeated parameters. MCP accepts a string array, e.g. ["alpha-trades", "700"]. Values are trimmed and matched case-insensitively. Numeric text such as "700" is a literal slug, never an ID. Maximum 200 non-empty supplied entries per field, including duplicates. Do not supply traderIds and traderRefs together, even if one is empty. Unknown references match nothing. Retry ambiguous references with a returned numeric ID in traderIds, omitting traderRefs. Find names or handles with trader directory search.

Example:

"alpha-trades"

assetIds

Filter to traders with eligible positions on these assets. Positive integer asset IDs only. REST accepts comma-separated values or repeated parameters. MCP accepts an array. Numeric strings become IDs. Maximum 200 non-empty supplied entries per field, including duplicates. Use assetRefs for slugs, tickers, or legacy symbols. Do not supply assetIds and assetRefs together, even if one is empty.

Example:

"1,34"

assetRefs

Filter to traders with eligible positions on these assets. Asset slugs, tickers, or legacy symbols as strings only. REST accepts comma-separated values or repeated parameters. MCP accepts a string array, e.g. ["AAPL", "crypto-btc", "700"]. Values are trimmed and matched case-insensitively, in order: slug, ticker, then legacy symbol. Numeric text such as "700" is a literal reference, never an ID. Maximum 200 non-empty supplied entries per field, including duplicates. Do not supply assetIds and assetRefs together, even if one is empty. Unknown references match nothing. Retry ambiguous references with a returned numeric ID in assetIds, omitting assetRefs. Find names with asset discovery search.

Example:

"AAPL,crypto-btc,700"

sourcePlatforms

Filter to traders whose source platform is TELEGRAM or X.

minTrades
integer | null
default:3

Minimum tradeCount required for a trader to appear in discovery. tradeCount is the eligible visible position count after asset and position-open time filters. Defaults to 3; pass 0 to include zero-position signal-visible traders. Use /v2/traders for identity lookup.

Required range: x >= 0
startTime
string<date-time>

Inclusive ISO-8601 lower bound on position open time for trader discovery tradeCount and minTrades. This does not compute performance metrics; use trader stats for performance.

endTime
string<date-time>

Inclusive ISO-8601 upper bound on position open time for trader discovery tradeCount and minTrades. This does not compute performance metrics; use trader stats for performance.

limit
integer

Maximum number of rows to return.

Required range: 1 <= x <= 200
cursor
string

Forward pagination cursor from meta.nextCursor.

Minimum string length: 1

Response

Paginated list of traders

success
enum<boolean>
required
Available options:
true
data
object
required
requestId
string
required
Example:

"c8e2c6e4-80dd-4ffc-9d66-4e31bf64c6b8"