Sign in
Traders

Get trader context (JSON)

Returns a single structured context object for one trader: the full trader profile (same shape as GET /api/v1/trader/{address}) plus a position_summary (sync coverage and realized/unrealized P&L rollups, with an as_of open-position freshness clock), the data_as_of freshness timestamp (the open-position data's latest /positions snapshot, else last completed sync; the snapshot advances only open positions, so resolved/closed aggregates still date to the last full sync), and a freshness_note describing the point-in-time snapshot semantics. The path accepts an Ethereum wallet address (0x...), a known trader username, or a trd_-prefixed trader ID emitted by this API. position_summary is omitted when the trader is not in the local database; unknown lookups return 200 with sync_status 'unknown' on the nested trader (no 404). Append .md to the path for the Markdown rendering.

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

Path parameters

addressstring required

Ethereum wallet address (0x...), known trader username, or trd_-prefixed trader ID emitted by this API.

Headers

If-None-Matchstring

Conditional GET validator from a previous ETag. Matching values return 304 Not Modified with an empty body.

Response

Trader context

object'trader_context' required

Changes

Changed in 4 of the 31 revisions of this API.24118

  • 7c0c7cdd41ee8See the full diff
    • ●

      added the new database_unavailable enum value to the error/reason response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new database_unavailable enum value to the error/reason response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new database_unavailable enum value to the error/reason response property for the response status 402

      response-property-enum-value-added

    • ●

      added the new database_unavailable enum value to the error/reason response property for the response status 403

      response-property-enum-value-added

    • ●

      added the new database_unavailable enum value to the error/reason response property for the response status 423

      response-property-enum-value-added

    • ●

      added the new database_unavailable enum value to the error/reason response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new database_unavailable enum value to the error/reason response property for the response status 500

      response-property-enum-value-added

    • ●

      added the new database_unavailable enum value to the error/reason response property for the response status 503

      response-property-enum-value-added

  • 8582a359fa0718See the full diff
    • ○

      added the optional property meta/ranking_as_of to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_as_of to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_as_of to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_as_of to the response with the 402 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_as_of to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_as_of to the response with the 423 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_as_of to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_as_of to the response with the 500 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_as_of to the response with the 503 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_generation to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_generation to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_generation to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_generation to the response with the 402 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_generation to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_generation to the response with the 423 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_generation to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_generation to the response with the 500 status

      response-optional-property-added

    • ○

      added the optional property meta/ranking_generation to the response with the 503 status

      response-optional-property-added

  • 19193b1771541699See the full diff
    • ●

      added the new idempotency_in_progress enum value to the error/reason response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new idempotency_in_progress enum value to the error/reason response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new idempotency_in_progress enum value to the error/reason response property for the response status 402

      response-property-enum-value-added

    • ●

      added the new idempotency_in_progress enum value to the error/reason response property for the response status 403

      response-property-enum-value-added

    • ●

      added the new idempotency_in_progress enum value to the error/reason response property for the response status 423

      response-property-enum-value-added

    • ●

      added the new idempotency_in_progress enum value to the error/reason response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new idempotency_in_progress enum value to the error/reason response property for the response status 500

      response-property-enum-value-added

    • ●

      added the new idempotency_in_progress enum value to the error/reason response property for the response status 503

      response-property-enum-value-added

    • ●

      added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 402

      response-property-enum-value-added

    • ●

      added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 403

      response-property-enum-value-added

    • ●

      added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 423

      response-property-enum-value-added

    • ●

      added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 500

      response-property-enum-value-added

    • ●

      added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 503

      response-property-enum-value-added

    • ○

      added the optional property meta/category_skill_base_payload_hash to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_base_payload_hash to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_base_payload_hash to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_base_payload_hash to the response with the 402 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_base_payload_hash to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_base_payload_hash to the response with the 423 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_base_payload_hash to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_base_payload_hash to the response with the 500 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_base_payload_hash to the response with the 503 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 402 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 423 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 500 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 503 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_operationally_degraded to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_operationally_degraded to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_operationally_degraded to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_operationally_degraded to the response with the 402 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_operationally_degraded to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_operationally_degraded to the response with the 423 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_operationally_degraded to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_operationally_degraded to the response with the 500 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_operationally_degraded to the response with the 503 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_version to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_version to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_version to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_version to the response with the 402 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_version to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_version to the response with the 423 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_version to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_version to the response with the 500 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_model_version to the response with the 503 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_observation_started_at to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_observation_started_at to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_observation_started_at to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_observation_started_at to the response with the 402 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_observation_started_at to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_observation_started_at to the response with the 423 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_observation_started_at to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_observation_started_at to the response with the 500 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_observation_started_at to the response with the 503 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_platform to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_platform to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_platform to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_platform to the response with the 402 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_platform to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_platform to the response with the 423 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_platform to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_platform to the response with the 500 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_platform to the response with the 503 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_scope to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_scope to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_scope to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_scope to the response with the 402 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_scope to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_scope to the response with the 423 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_scope to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_scope to the response with the 500 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_scope to the response with the 503 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source to the response with the 402 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source to the response with the 423 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source to the response with the 500 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source to the response with the 503 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source_coverage to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source_coverage to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source_coverage to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source_coverage to the response with the 402 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source_coverage to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source_coverage to the response with the 423 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source_coverage to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source_coverage to the response with the 500 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_source_coverage to the response with the 503 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_status_counts to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_status_counts to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_status_counts to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_status_counts to the response with the 402 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_status_counts to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_status_counts to the response with the 423 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_status_counts to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_status_counts to the response with the 500 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_status_counts to the response with the 503 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_taxonomy_version to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_taxonomy_version to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_taxonomy_version to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_taxonomy_version to the response with the 402 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_taxonomy_version to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_taxonomy_version to the response with the 423 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_taxonomy_version to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_taxonomy_version to the response with the 500 status

      response-optional-property-added

    • ○

      added the optional property meta/category_skill_taxonomy_version to the response with the 503 status

      response-optional-property-added

  • 22ab6cfbf3001See the full diff
    • ○

      endpoint added

      endpoint-added