List traders
Returns a paginated list of traders. Only available for broker/forex platforms.
Pagination metadata is returned in response headers (X-Pagination-*).
Advanced filtering is available via a filter object in the request body
(requires Content-Type: application/json). Filter operators: =, !=, >,
>=, <, <=, IN, NOT IN, LIKE, and conjunctions AND, OR, NOT.
Authorizations
Preferred authentication method. Pass the API key in the X-API-Key HTTP request header. The user account must have api_status enabled.
Query Parameters
Page number.
Items per page.
Field to sort by.
registration_date, ftd_date, qualification_date Sort direction.
asc, desc Free-text search — matches trader_id, click_id, promo_code.
Comma-separated offer IDs to filter by.
Comma-separated affiliate IDs to filter by.
Comma-separated commission plan IDs to filter by.
Comma-separated traffic source IDs to filter by.
Trader status filter.
active, restricted Filter by whether the trader has made a first deposit.
Filter by whether the trader is qualified (has a qualification date).
Filter by verification status.
Comma-separated field keys to include in each trader object.
Body
Advanced filter conditions.
Filter conditions keyed by attribute name. Each attribute value is an
operator map, e.g. {">=": "2025-01-01"} or {"IN": [1, 2]}.
Supported attributes:
registration_date,ftd_date,qualification_date— date comparisons (user timezone)countries— array of country IDsaffiliates,offers,commission_plans,traffic_source_ids— array of IDsstatus—activeorrestrictedstatus_details— string arrayverified,deposited,qualified,is_frozen— boolean