Markets

Search markets

Search prediction markets by keyword. Returns representative market matches with status, category, and platform metadata. Cursor pagination advances over grouped market results rather than raw sub-market rows.

get/api/v1/markets/search

Query parameters

qstring required

Search query. Must be 1-512 characters before whitespace trimming and non-empty after trimming.

limitinteger

Maximum number of matching markets to return.

cursorstring

Pagination cursor from previous response's next_cursor.

status'active' | 'closed' | 'all'

Filter by market status.

categorystring

Filter by category.

Response

Search results

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 8 of the 31 revisions of this API.186152

    • 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

  • 422bd4dc1611631See 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 search_markets removed and replaced with searchMarkets

      api-operation-id-removed

  • 2907497f4ca3112See the full diff
    • for the query request parameter q, the minLength was increased from 0 to 1

      request-parameter-min-length-increased

    • for the query request parameter q, the maxLength was set to 512

      request-parameter-max-length-set

    • added the non-success response with the status 408

      response-non-success-status-added

    • added the non-success response with the status 503

      response-non-success-status-added

    • added the new closed enum value to the data/items/status response property for the response status 200

      response-property-enum-value-added

    • added the new optional query request parameter cursor

      new-optional-request-parameter

    • added the non-success response with the status 403

      response-non-success-status-added

    • added the non-success response with the status 423

      response-non-success-status-added

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

      response-optional-property-added

    • removed the resolved enum value from the data/items/status response property for the response status 200

      response-property-enum-value-removed

    • endpoint added

      endpoint-added

    This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog