Positions

List current positions (positions-board feed)

Returns the current positions-board feed backed by the wallet_positions mirror. Ordered by current_value_usd DESC with deterministic (wallet, condition_id, outcome_index) tiebreakers. Pre-reconcile rows (current_value_usd IS NULL) are excluded. Cursor-paginated. Every filter pushes into SQL.

get/api/v1/positions

Query parameters

limitinteger

Maximum number of current positions to return.

cursorstring

Pagination cursor from previous response's next_cursor.

min_sizenumber

Minimum current position value in USD.

categorystring

Exact match against provider-backed market_canonical.category.

min_grade'S' | 'A' | 'B' | 'C' | 'D' | 'F'

Minimum trader grade allowlist. A matches S and A; B matches S, A, B; etc.

side'yes' | 'no'

Filter by the binary outcome side. yes maps to outcome_index=0, no to outcome_index=1.

Headers

If-None-Matchstring

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

Response

Page of positions

object'list' required
has_moreboolean required
next_cursorstring nullable
totalinteger nullable

Total matching rows when the read model exposes a count; absent (or null) when it does not.

Changes

Changed in 7 of the 31 revisions of this API.84148

    • 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 503

      response-property-enum-value-added

    • 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 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 503 status

      response-optional-property-added

  • 19193b1771541488See 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 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 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 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 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 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 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 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 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 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 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 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 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 503 status

      response-optional-property-added

    • added the optional property error/reason to the response with the 400 status

      response-optional-property-added

    • added the optional property error/reason to the response with the 401 status

      response-optional-property-added

    • added the optional property error/reason to the response with the 402 status

      response-optional-property-added

    • added the optional property error/reason to the response with the 403 status

      response-optional-property-added

    • added the optional property error/reason to the response with the 423 status

      response-optional-property-added

    • added the optional property error/reason to the response with the 429 status

      response-optional-property-added

    • added the optional property error/reason to the response with the 503 status

      response-optional-property-added

    • added the optional property error/retry_at to the response with the 400 status

      response-optional-property-added

    • added the optional property error/retry_at to the response with the 401 status

      response-optional-property-added

    • added the optional property error/retry_at to the response with the 402 status

      response-optional-property-added

    • added the optional property error/retry_at to the response with the 403 status

      response-optional-property-added

    • added the optional property error/retry_at to the response with the 423 status

      response-optional-property-added

    • added the optional property error/retry_at to the response with the 429 status

      response-optional-property-added

    • added the optional property error/retry_at to the response with the 503 status

      response-optional-property-added

    • added the optional property meta/directional_source to the response with the 200 status

      response-optional-property-added

    • added the optional property meta/directional_source to the response with the 400 status

      response-optional-property-added

    • added the optional property meta/directional_source to the response with the 401 status

      response-optional-property-added

    • added the optional property meta/directional_source to the response with the 402 status

      response-optional-property-added

    • added the optional property meta/directional_source to the response with the 403 status

      response-optional-property-added

    • added the optional property meta/directional_source to the response with the 423 status

      response-optional-property-added

    • added the optional property meta/directional_source to the response with the 429 status

      response-optional-property-added

    • added the optional property meta/directional_source to the response with the 503 status

      response-optional-property-added

    • added the optional property meta/ranking_source to the response with the 200 status

      response-optional-property-added

    • added the optional property meta/ranking_source to the response with the 400 status

      response-optional-property-added

    • added the optional property meta/ranking_source to the response with the 401 status

      response-optional-property-added

    • added the optional property meta/ranking_source to the response with the 402 status

      response-optional-property-added

    • added the optional property meta/ranking_source to the response with the 403 status

      response-optional-property-added

    • added the optional property meta/ranking_source to the response with the 423 status

      response-optional-property-added

    • added the optional property meta/ranking_source to the response with the 429 status

      response-optional-property-added

    • added the optional property meta/ranking_source to the response with the 503 status

      response-optional-property-added

    • added the optional property total to the response with the 200 status

      response-optional-property-added

    • added the required property meta/cost to the response with the 200 status

      response-required-property-added

    • added the required property meta/cost to the response with the 400 status

      response-required-property-added

    • added the required property meta/cost to the response with the 401 status

      response-required-property-added

    • added the required property meta/cost to the response with the 402 status

      response-required-property-added

    • added the required property meta/cost to the response with the 403 status

      response-required-property-added

    • added the required property meta/cost to the response with the 423 status

      response-required-property-added

    • added the required property meta/cost to the response with the 429 status

      response-required-property-added

    • added the required property meta/cost to the response with the 503 status

      response-required-property-added

    • added the optional property data/items/token_id to the response with the 200 status

      response-optional-property-added

  • 422bd4dc1611633See the full diff
    • added the new account_locked enum value to the error/code response property for the response status 400

      response-property-enum-value-added

    • added the new account_locked enum value to the error/code response property for the response status 401

      response-property-enum-value-added

    • added the new account_locked enum value to the error/code response property for the response status 402

      response-property-enum-value-added

    • added the new account_locked enum value to the error/code response property for the response status 403

      response-property-enum-value-added

    • added the new account_locked enum value to the error/code response property for the response status 423

      response-property-enum-value-added

    • added the new account_locked enum value to the error/code response property for the response status 429

      response-property-enum-value-added

    • added the new account_locked enum value to the error/code response property for the response status 503

      response-property-enum-value-added

    • added the new bad_request enum value to the error/code response property for the response status 400

      response-property-enum-value-added

    • added the new bad_request enum value to the error/code response property for the response status 401

      response-property-enum-value-added

    • added the new bad_request enum value to the error/code response property for the response status 402

      response-property-enum-value-added

    • added the new bad_request enum value to the error/code response property for the response status 403

      response-property-enum-value-added

    • added the new bad_request enum value to the error/code response property for the response status 423

      response-property-enum-value-added

    • added the new bad_request enum value to the error/code response property for the response status 429

      response-property-enum-value-added

    • added the new bad_request enum value to the error/code response property for the response status 503

      response-property-enum-value-added

    • added the new forbidden enum value to the error/code response property for the response status 400

      response-property-enum-value-added

    • added the new forbidden enum value to the error/code response property for the response status 401

      response-property-enum-value-added

    • added the new forbidden enum value to the error/code response property for the response status 402

      response-property-enum-value-added

    • added the new forbidden enum value to the error/code response property for the response status 403

      response-property-enum-value-added

    • added the new forbidden enum value to the error/code response property for the response status 423

      response-property-enum-value-added

    • added the new forbidden enum value to the error/code response property for the response status 429

      response-property-enum-value-added

    • added the new forbidden enum value to the error/code response property for the response status 503

      response-property-enum-value-added

    • added the new internal_error enum value to the error/code response property for the response status 400

      response-property-enum-value-added

    • added the new internal_error enum value to the error/code response property for the response status 401

      response-property-enum-value-added

    • added the new internal_error enum value to the error/code response property for the response status 402

      response-property-enum-value-added

    • added the new internal_error enum value to the error/code response property for the response status 403

      response-property-enum-value-added

    • added the new internal_error enum value to the error/code response property for the response status 423

      response-property-enum-value-added

    • added the new internal_error enum value to the error/code response property for the response status 429

      response-property-enum-value-added

    • added the new internal_error enum value to the error/code response property for the response status 503

      response-property-enum-value-added

    • added the new invalid_api_key enum value to the error/code response property for the response status 400

      response-property-enum-value-added

    • added the new invalid_api_key enum value to the error/code response property for the response status 401

      response-property-enum-value-added

    • added the new invalid_api_key enum value to the error/code response property for the response status 402

      response-property-enum-value-added

    • added the new invalid_api_key enum value to the error/code response property for the response status 403

      response-property-enum-value-added

    • added the new invalid_api_key enum value to the error/code response property for the response status 423

      response-property-enum-value-added

    • added the new invalid_api_key enum value to the error/code response property for the response status 429

      response-property-enum-value-added

    • added the new invalid_api_key enum value to the error/code response property for the response status 503

      response-property-enum-value-added

    • added the new not_found enum value to the error/code response property for the response status 400

      response-property-enum-value-added

    • added the new not_found enum value to the error/code response property for the response status 401

      response-property-enum-value-added

    • added the new not_found enum value to the error/code response property for the response status 402

      response-property-enum-value-added

    • added the new not_found enum value to the error/code response property for the response status 403

      response-property-enum-value-added

    • added the new not_found enum value to the error/code response property for the response status 423

      response-property-enum-value-added

    • added the new not_found enum value to the error/code response property for the response status 429

      response-property-enum-value-added

    • added the new not_found enum value to the error/code response property for the response status 503

      response-property-enum-value-added

    • added the new rate_limit_unavailable enum value to the error/code response property for the response status 400

      response-property-enum-value-added

    • added the new rate_limit_unavailable enum value to the error/code response property for the response status 401

      response-property-enum-value-added

    • added the new rate_limit_unavailable enum value to the error/code response property for the response status 402

      response-property-enum-value-added

    • added the new rate_limit_unavailable enum value to the error/code response property for the response status 403

      response-property-enum-value-added

    • added the new rate_limit_unavailable enum value to the error/code response property for the response status 423

      response-property-enum-value-added

    • added the new rate_limit_unavailable enum value to the error/code response property for the response status 429

      response-property-enum-value-added

    • added the new rate_limit_unavailable enum value to the error/code response property for the response status 503

      response-property-enum-value-added

    • added the new rate_limited enum value to the error/code response property for the response status 400

      response-property-enum-value-added

    • added the new rate_limited enum value to the error/code response property for the response status 401

      response-property-enum-value-added

    • added the new rate_limited enum value to the error/code response property for the response status 402

      response-property-enum-value-added

    • added the new rate_limited enum value to the error/code response property for the response status 403

      response-property-enum-value-added

    • added the new rate_limited enum value to the error/code response property for the response status 423

      response-property-enum-value-added

    • added the new rate_limited enum value to the error/code response property for the response status 429

      response-property-enum-value-added

    • added the new rate_limited enum value to the error/code response property for the response status 503

      response-property-enum-value-added

    • added the new subscription_required enum value to the error/code response property for the response status 400

      response-property-enum-value-added

    • added the new subscription_required enum value to the error/code response property for the response status 401

      response-property-enum-value-added

    • added the new subscription_required enum value to the error/code response property for the response status 402

      response-property-enum-value-added

    • added the new subscription_required enum value to the error/code response property for the response status 403

      response-property-enum-value-added

    • added the new subscription_required enum value to the error/code response property for the response status 423

      response-property-enum-value-added

    • added the new subscription_required enum value to the error/code response property for the response status 429

      response-property-enum-value-added

    • added the new subscription_required enum value to the error/code response property for the response status 503

      response-property-enum-value-added

    • api operation id get_positions removed and replaced with listPositions

      api-operation-id-removed

    • added the new optional header request parameter If-None-Match

      new-optional-request-parameter

    • added the non-success response with the status 304

      response-non-success-status-added

    • endpoint added

      endpoint-added