suggestions

Get suggestions

List market suggestions. Users see their own; admins see all.

get/suggestions

Request

  • Base URL: https://gamma-api.polymarket.com (the document declares no server; this is the origin it was published from)
  • URL: https://gamma-api.polymarket.com/suggestions
  • Auth: one of:
    • API key in cookie polymarketsession
    • HTTP bearer

Query parameters

idinteger[] nullable

Suggestion IDs to return

addressstring[] nullable

Filter by creator address

statusstring[] nullable

Filter by suggestion status

limitinteger

Max results returned

offsetinteger

Number of results to skip

orderstring

Comma-separated field names to sort by

ascendingboolean

Sort ascending when true

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

additionalDetailsstring
createdAtstring date-time
descriptionstring
endDatestring date-time
idstring required
outcomesstring
rejectReasonstring
resolutionSourcestring
statusstring required
titlestring
updatedAtstring date-time

Example response

[
  {
    "$schema": "https://example.com/schemas/EnrichedSuggestion.json",
    "events": [
      {
        "$schema": "https://example.com/schemas/Event.json",
        "eventCreators": [
          {
            "$schema": "https://example.com/schemas/EventCreator.json"
          }
        ],
        "externalPartners": [
          {
            "$schema": "https://example.com/schemas/EventExternalPartnerMapping.json",
            "partner": {
              "$schema": "https://example.com/schemas/Partner.json"
            }
          }
        ],
        "markets": [
          {
            "$schema": "https://example.com/schemas/Market.json",
            "cryptoMarketConfig": {
              "$schema": "https://example.com/schemas/CryptoMarketConfig.json"
            },
            "tags": [
              {
                "$schema": "https://example.com/schemas/Tag.json"
              }
            ]
          }
        ],
        "series": [
          {
            "$schema": "https://example.com/schemas/Series.json"
          }
        ],
        "sport": {
          "$schema": "https://example.com/schemas/SportsMetadata.json",
          "externalPartners": [
            {
              "$schema": "https://example.com/schemas/SportExternalPartnerMapping.json",
              "partner": {
                "$schema": "https://example.com/schemas/Partner.json"
              }
            }
          ]
        },
        "tags": [
          {
            "$schema": "https://example.com/schemas/Tag.json"
          }
        ],
        "teams": [
          {
            "$schema": "https://example.com/schemas/Team.json",
            "externalPartners": [
              {
                "$schema": "https://example.com/schemas/TeamExternalPartnerMapping.json",
                "partner": {
                  "$schema": "https://example.com/schemas/Partner.json"
                }
              }
            ]
          }
        ]
      }
    ]
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.