Skip to main content
GET
List trader identities

Authorizations

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

API key issued by Centaur.

Query Parameters

Case-insensitive match against trader name, slug, source display name, handle, or profile URL.

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"

sourcePlatforms

Filter to traders whose source platform is TELEGRAM or X.

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 trader identities

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

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