API ReferenceTrader Intelligence
List public outcome holders for one venue market.
const url = 'https://data.predictefy.com/v1/traders/polymarket/markets/example/holders?limit=20';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://data.predictefy.com/v1/traders/polymarket/markets/example/holders?limit=20' \ --header 'Authorization: Bearer <token>'Returns only venue-published holder data. Venues without a public holder or outcome-holder concept return TRADERS_UNSUPPORTED; Predictefy never reconstructs a holder table.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”A venue with a capability-qualified Trader Intelligence adapter.
A Predictefy market id or a venue-native alias resolvable through the catalog.
Query Parameters
Section titled “Query Parameters”Responses
Section titled “Responses”Public holder rows for the resolved market.
object
object
object
Newest observation in the returned page, or null when the page is empty.
object
Predictefy-store — Trader Intelligence rows served from Predictefy's own store. venue-rest — live Trader Intelligence rows fetched per request through the venue adapter.
Example
{ "success": true, "meta": { "provenance": { "source": "predictefy-store" }, "window": "day" }}VALIDATION_ERROR / TRADERS_UNSUPPORTED
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Headers
Section titled “Headers”Net credits charged for this metered response after any error refund.
Post-charge account balance. Present only when the existing debit/refund operation made it available; the service never adds a database read solely for this header.
The API key is missing, unknown, or revoked. A venue-authenticated read also answers 401 when the venue itself rejects the credential. Not retryable.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}The account's credit balance cannot cover this endpoint's weight. Not retryable.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}The API key lacks the scope this route requires, or the account's plan does not include the feature. Not retryable.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}MARKET_NOT_FOUND / dark lane
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Rate limit exceeded. The response carries Retry-After in whole seconds, always rounded up so a sub-second remainder never points back inside the live window.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Unexpected internal error. Retryable; error.requestId identifies the failure.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}A dependency is temporarily unavailable — the catalog, history, matching, feeds, an upstream venue, or the platform store. Retryable.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}