Skip to main content
GET
List the curated partner feed

Authorizations

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

API key issued by Centaur.

Query Parameters

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

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

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"

assetClass

Comma-separated values or an array. Match any selected asset class: crypto, stocks, indices, commodities, or fx. Combines with asset and trader filters. Omit for all classes. Empty or invalid values are rejected.

startTime
string<date-time>

Inclusive ISO-8601 lower time bound on source-message post time, clamped to the rolling seven-day feed window.

endTime
string<date-time>

Inclusive ISO-8601 upper time bound on source-message post time. Defaults to the request time.

limit
integer

Maximum number of source-message groups to return. Defaults to 20, maximum 100.

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

Scroll-back cursor from meta.nextCursor; mutually exclusive with since.

Minimum string length: 1
since
string

Change-feed token from meta.nextCursor; returns groups changed after its ingestion watermark and is mutually exclusive with cursor. Source enrichment alone does not advance it; re-read the bounded feed window to refresh source context.

Minimum string length: 1

Response

Paginated source-message groups with curated trading events

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

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