Traders

Get trader P&L time series

Returns a trader's daily P&L time series and pre-derived stats from the precomputed daily_pnl read model: entries (daily cumulative P&L), period stats (all/90d/30d/7d), monthly aggregation, per-year totals, and the drawdown series. Reads the refreshed read model, not a per-request equity replay. A resolved trader with no daily P&L returns an empty structured object (HTTP 200); an unknown address returns 404. Optional from/to and sections bound what comes back: from/to clip the two daily series (entries, drawdown) to an inclusive UTC date window, and sections names which of the five sections the body carries. A request that sends none of the three receives the whole object exactly as before, down to the ETag. A body built with any of them carries data.view, which names the bounds, the sections applied, the size of the full series and the last daily point before the window; a section the request excluded is absent from data, not null or empty. stats, monthly and year_totals keep their full-period definitions whatever the window says, so an economic value never changes meaning because a chart asked for seven days.

get/api/v1/trader/{address}/pnl

Path parameters

addressstring required

Wallet address (0x...), username, or trd_-prefixed trader id.

Query parameters

fromstring

Inclusive UTC calendar-date lower bound in YYYY-MM-DD form for the daily series (entries and drawdown). Omit for the whole stored history. A value that is not a calendar date, or a from later than to, returns 400 bad_request with error.param from. Does not change stats, monthly or year_totals, which stay defined over the full history.

tostring

Inclusive UTC calendar-date upper bound in YYYY-MM-DD form for the daily series (entries and drawdown). Omit for the whole stored history. A value that is not a calendar date returns 400 bad_request with error.param to. Does not change stats, monthly or year_totals.

sectionsstring[]

Which sections of the object to return. Repeatable and comma-separated: entries, stats, monthly, year_totals, drawdown. Omit it, or send it empty, for all five. A section left out is absent from data. An unrecognized name returns 400 bad_request with error.param sections rather than being ignored, so a typo cannot look like a successful request that silently dropped the section you came for.

sections[]string[]

Backward-compatible bracket alias for sections, for clients that emit array keys. Repeatable and comma-separated: entries, stats, monthly, year_totals, drawdown.

Headers

X-Query-Validation'strict'

Opt into strict query-name validation. The default is compatible: unknown names are ignored and reported in X-Query-Ignored. With strict, an unknown name returns 400 bad_request with error.reason unknown_query_parameter before the handler runs, including when its percent escape is incomplete.

Response

Trader P&L object

object'trader_pnl' required

Changes

Changed in 15 of the 89 revisions of this API.14209179

Sep 23, 2026ece7a25b7a4499See the full diff
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
Sep 23, 20268462acf80f8c595See the full diff
- ▲
  the response property / became optional for the status
  response-property-became-optional
- ▲
  the response property / became optional for the status
  response-property-became-optional
- ▲
  the response property / became optional for the status
  response-property-became-optional
- ▲
  the response property / became optional for the status
  response-property-became-optional
- ▲
  the response property / became optional for the status
  response-property-became-optional
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  added the new optional query request parameter from
  new-optional-request-parameter
- ○
  added the new optional query request parameter sections
  new-optional-request-parameter
- ○
  added the new optional query request parameter sections[]
  new-optional-request-parameter
- ○
  added the new optional query request parameter to
  new-optional-request-parameter
- ○
  added the optional property / to the response with the status
  response-optional-property-added
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 22, 202619386d595e051See the full diff
- ○
  the response property / became required for the status
  response-property-became-required
Sep 22, 20261c5e270b412491See the full diff
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  added the new optional header request parameter X-Query-Validation
  new-optional-request-parameter
Sep 22, 20269958c95371de18See the full diff
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
Sep 22, 20264bade829e22818See the full diff
- ●
  added the new ip_rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_throttled enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_throttled enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_throttled enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_throttled enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_throttled enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_throttled enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_throttled enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_throttled enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new ip_throttled enum value to the / response property for the response status
  response-property-enum-value-added
Sep 22, 20267b5489c2cd3e561See the full diff
- ●
  added the new invalid_body enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_body enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_body enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_body enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_body enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_body enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_body enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_body enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_path enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_path enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_path enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_path enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_path enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_path enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_path enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_path enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new method_not_allowed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new method_not_allowed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new method_not_allowed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new method_not_allowed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new method_not_allowed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new method_not_allowed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new method_not_allowed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new method_not_allowed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new payload_too_large enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new payload_too_large enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new payload_too_large enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new payload_too_large enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new payload_too_large enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new payload_too_large enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new payload_too_large enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new payload_too_large enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new request_timeout enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new request_timeout enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new request_timeout enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new request_timeout enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new request_timeout enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new request_timeout enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new request_timeout enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new request_timeout enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unsupported_media_type enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unsupported_media_type enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unsupported_media_type enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unsupported_media_type enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unsupported_media_type enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unsupported_media_type enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unsupported_media_type enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unsupported_media_type enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  added the media type application/json for the response with the status
  response-media-type-added
Sep 21, 20264b70e1891f6116See the full diff
- ●
  added the new insufficient_scope enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new insufficient_scope enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new insufficient_scope enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new insufficient_scope enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new insufficient_scope enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new insufficient_scope enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new insufficient_scope enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new insufficient_scope enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new monthly_quota_exceeded enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new monthly_quota_exceeded enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new monthly_quota_exceeded enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new monthly_quota_exceeded enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new monthly_quota_exceeded enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new monthly_quota_exceeded enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new monthly_quota_exceeded enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new monthly_quota_exceeded enum value to the / response property for the response status
  response-property-enum-value-added
Sep 17, 202605ff312f4bbc8See the full diff
- ●
  added the new api_key_in_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new api_key_in_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new api_key_in_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new api_key_in_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new api_key_in_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new api_key_in_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new api_key_in_query enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new api_key_in_query enum value to the / response property for the response status
  response-property-enum-value-added
Sep 16, 20261b8c2226ee7b942See the full diff
- ▲
  the response property const value partial_whale_threshold_fills was removed for the status
  response-property-const-removed
- ▲
  the response property const value partial_whale_threshold_fills was removed for the status
  response-property-const-removed
- ▲
  the response property const value partial_whale_threshold_fills was removed for the status
  response-property-const-removed
- ▲
  the response property const value partial_whale_threshold_fills was removed for the status
  response-property-const-removed
- ▲
  the response property const value partial_whale_threshold_fills was removed for the status
  response-property-const-removed
- ▲
  the response property const value partial_whale_threshold_fills was removed for the status
  response-property-const-removed
- ▲
  the response property const value partial_whale_threshold_fills was removed for the status
  response-property-const-removed
- ▲
  the response property const value partial_whale_threshold_fills was removed for the status
  response-property-const-removed
- ▲
  the response property const value partial_whale_threshold_fills was removed for the status
  response-property-const-removed
- ●
  added the new graded_wallet_fills enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new graded_wallet_fills enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new graded_wallet_fills enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new graded_wallet_fills enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new graded_wallet_fills enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new graded_wallet_fills enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new graded_wallet_fills enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new graded_wallet_fills enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new graded_wallet_fills enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new partial_whale_threshold_fills enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new partial_whale_threshold_fills enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new partial_whale_threshold_fills enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new partial_whale_threshold_fills enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new partial_whale_threshold_fills enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new partial_whale_threshold_fills enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new partial_whale_threshold_fills enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new partial_whale_threshold_fills enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new partial_whale_threshold_fills enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new request_accounting_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new request_accounting_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new request_accounting_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new request_accounting_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new request_accounting_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new request_accounting_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new request_accounting_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new request_accounting_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new sandbox_api_key enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new sandbox_api_key enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new sandbox_api_key enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new sandbox_api_key enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new sandbox_api_key enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new sandbox_api_key enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new sandbox_api_key enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new sandbox_api_key enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new subscription_inactive enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new subscription_inactive enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new subscription_inactive enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new subscription_inactive enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new subscription_inactive enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new subscription_inactive enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new subscription_inactive enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new subscription_inactive enum value to the / response property for the response status
  response-property-enum-value-added
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history (15 revisions)