> ## Documentation Index > Fetch the complete documentation index at: https://docs.cdp.coinbase.com/llms.txt > Use this file to discover all available pages before exploring further. # List events > Returns a page of events. Requires MARKET_DATA permission. ## OpenAPI ````yaml /api-reference/derivatives-predictions-api/rest-api/cpm-spec.json get /api/v1/events openapi: 3.0.3 info: title: CPM Public REST API version: 0.1.0 servers: - url: https://api.example.com variables: {} security: - auth_api_key: [] - auth_timestamp: [] - auth_passphrase: [] - auth_signature: [] paths: /api/v1/events: get: tags: - Reference summary: List events description: Returns a page of events. Requires MARKET_DATA permission. operationId: listEventsV1 parameters: - name: id in: query description: Filter by event ID. Repeatable. required: false deprecated: false allowEmptyValue: false schema: type: string - name: ticker in: query description: Case-insensitive substring of the ticker. required: false deprecated: false allowEmptyValue: false schema: type: string - name: title in: query description: Case-insensitive substring of the title. required: false deprecated: false allowEmptyValue: false schema: type: string - name: category in: query description: Filter by category. Repeatable. required: false deprecated: false allowEmptyValue: false schema: type: string - name: status in: query description: Filter by lifecycle status. Repeatable. DRAFT returns 400. required: false deprecated: false allowEmptyValue: false schema: type: string - name: sort in: query description: >- Sort field. Only updated_time is accepted. Without sort, results are ordered newest first by ID. required: false deprecated: false allowEmptyValue: false schema: type: string - name: order in: query description: >- Sort direction: asc or desc. Default desc. Used only with sort=updated_time. required: false deprecated: false allowEmptyValue: false schema: type: string - name: limit in: query description: Page size. Default 100, maximum 1000. required: false deprecated: false allowEmptyValue: false schema: type: string - name: cursor in: query description: >- Opaque cursor from the previous page's cursor field. Omit on the first request. required: false deprecated: false allowEmptyValue: false schema: type: string responses: '200': description: Events page content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/EventReferenceResponse' cursor: type: string '400': description: Invalid parameter content: application/json: schema: $ref: '#/components/schemas/ReferenceDataErrorResponse' deprecated: false security: [] components: schemas: EventReferenceResponse: type: object additionalProperties: false properties: id: type: string description: Event id, as a canonical decimal string. example: '498471892346' ticker: type: string description: Unique event ticker. Treat it as an opaque identifier. example: 26NOV28LARSF category: type: string description: >- Market category of the event: SPORTS, ECONOMICS, POLITICS, CRYPTO, or WEATHER. example: SPORTS title: type: string description: Human-readable display title. example: Rams at 49ers — Nov 28, 2026 description: type: string description: Extended description of the event, or null when there is none. example: Los Angeles Rams at San Francisco 49ers, NFL regular season. created_at: type: integer format: int64 description: Creation time in Unix epoch milliseconds. example: 1794787200000 updated_at: type: integer format: int64 description: Last update time in Unix epoch milliseconds. example: 1795730000000 additional_metadata: $ref: '#/components/schemas/JsonElement' description: >- Market-specific event metadata as a JSON object, or null. The fields vary by market. required: - created_at - updated_at ReferenceDataErrorResponse: type: object additionalProperties: false properties: error: $ref: '#/components/schemas/Error' description: Error details. JsonElement: type: object additionalProperties: false properties: jsonArray: type: boolean jsonObject: type: boolean jsonPrimitive: type: boolean jsonNull: type: boolean asJsonObject: $ref: '#/components/schemas/JsonObject' asJsonArray: $ref: '#/components/schemas/JsonArray' asJsonPrimitive: $ref: '#/components/schemas/JsonPrimitive' asJsonNull: $ref: '#/components/schemas/JsonNull' asBoolean: type: boolean asNumber: $ref: '#/components/schemas/Number' asString: type: string asDouble: type: number format: double asFloat: type: number format: float asLong: type: integer format: int64 asInt: type: integer format: int32 asByte: type: integer format: int32 asCharacter: type: string asBigDecimal: type: string asBigInteger: $ref: '#/components/schemas/BigInteger' asShort: type: integer format: int32 required: - jsonArray - jsonObject - jsonPrimitive - jsonNull - asBoolean - asDouble - asFloat - asLong - asInt - asByte - asCharacter - asShort Error: type: object additionalProperties: false properties: code: type: string description: >- Machine-readable error code, for example INVALID_PARAMETER, NOT_FOUND, or INTERNAL_ERROR. example: INVALID_PARAMETER message: type: string description: Human-readable description of the error. example: cursor is invalid or belongs to another resource type field: type: string description: >- Name of the request parameter that caused the error, or null when the error is not tied to one parameter. example: cursor JsonObject: type: object additionalProperties: false properties: jsonArray: type: boolean jsonObject: type: boolean jsonPrimitive: type: boolean jsonNull: type: boolean asJsonObject: $ref: '#/components/schemas/JsonObject' asJsonArray: $ref: '#/components/schemas/JsonArray' asJsonPrimitive: $ref: '#/components/schemas/JsonPrimitive' asJsonNull: $ref: '#/components/schemas/JsonNull' asBoolean: type: boolean asNumber: $ref: '#/components/schemas/Number' asString: type: string asDouble: type: number format: double asFloat: type: number format: float asLong: type: integer format: int64 asInt: type: integer format: int32 asByte: type: integer format: int32 asCharacter: type: string asBigDecimal: type: string asBigInteger: $ref: '#/components/schemas/BigInteger' asShort: type: integer format: int32 empty: type: boolean '': $ref: '#/components/schemas/JsonElement' required: - jsonArray - jsonObject - jsonPrimitive - jsonNull - asBoolean - asDouble - asFloat - asLong - asInt - asByte - asCharacter - asShort - empty JsonArray: type: object additionalProperties: false properties: jsonArray: type: boolean jsonObject: type: boolean jsonPrimitive: type: boolean jsonNull: type: boolean asJsonObject: $ref: '#/components/schemas/JsonObject' asJsonArray: $ref: '#/components/schemas/JsonArray' asJsonPrimitive: $ref: '#/components/schemas/JsonPrimitive' asJsonNull: $ref: '#/components/schemas/JsonNull' empty: type: boolean '': $ref: '#/components/schemas/JsonElement' asSingleElement: $ref: '#/components/schemas/JsonElement' asNumber: $ref: '#/components/schemas/Number' asString: type: string asDouble: type: number format: double asBigDecimal: type: string asBigInteger: $ref: '#/components/schemas/BigInteger' asFloat: type: number format: float asLong: type: integer format: int64 asInt: type: integer format: int32 asByte: type: integer format: int32 asCharacter: type: string asShort: type: integer format: int32 asBoolean: type: boolean required: - jsonArray - jsonObject - jsonPrimitive - jsonNull - empty - asDouble - asFloat - asLong - asInt - asByte - asCharacter - asShort - asBoolean JsonPrimitive: type: object additionalProperties: false properties: jsonArray: type: boolean jsonObject: type: boolean jsonPrimitive: type: boolean jsonNull: type: boolean asJsonObject: $ref: '#/components/schemas/JsonObject' asJsonArray: $ref: '#/components/schemas/JsonArray' asJsonPrimitive: $ref: '#/components/schemas/JsonPrimitive' asJsonNull: $ref: '#/components/schemas/JsonNull' boolean: type: boolean asBoolean: type: boolean number: type: boolean asNumber: $ref: '#/components/schemas/Number' string: type: boolean asString: type: string asDouble: type: number format: double asBigDecimal: type: string asBigInteger: $ref: '#/components/schemas/BigInteger' asFloat: type: number format: float asLong: type: integer format: int64 asShort: type: integer format: int32 asInt: type: integer format: int32 asByte: type: integer format: int32 asCharacter: type: string required: - jsonArray - jsonObject - jsonPrimitive - jsonNull - boolean - asBoolean - number - string - asDouble - asFloat - asLong - asShort - asInt - asByte - asCharacter JsonNull: type: object additionalProperties: false properties: jsonArray: type: boolean jsonObject: type: boolean jsonPrimitive: type: boolean jsonNull: type: boolean asJsonObject: $ref: '#/components/schemas/JsonObject' asJsonArray: $ref: '#/components/schemas/JsonArray' asJsonPrimitive: $ref: '#/components/schemas/JsonPrimitive' asJsonNull: $ref: '#/components/schemas/JsonNull' asBoolean: type: boolean asNumber: $ref: '#/components/schemas/Number' asString: type: string asDouble: type: number format: double asFloat: type: number format: float asLong: type: integer format: int64 asInt: type: integer format: int32 asByte: type: integer format: int32 asCharacter: type: string asBigDecimal: type: string asBigInteger: $ref: '#/components/schemas/BigInteger' asShort: type: integer format: int32 required: - jsonArray - jsonObject - jsonPrimitive - jsonNull - asBoolean - asDouble - asFloat - asLong - asInt - asByte - asCharacter - asShort Number: type: object additionalProperties: false properties: {} BigInteger: type: object additionalProperties: false properties: toomSlice: $ref: '#/components/schemas/BigInteger' lower: $ref: '#/components/schemas/BigInteger' upper: $ref: '#/components/schemas/BigInteger' lowestSetBit: type: integer format: int32 probablePrime: type: boolean int: type: integer format: int32 required: - lowestSetBit - probablePrime - int securitySchemes: auth_api_key: name: CB-ACCESS-KEY description: The API key string for the request in: header type: apiKey auth_timestamp: name: CB-ACCESS-TIMESTAMP description: The request timestamp (epoch seconds) in: header type: apiKey auth_passphrase: name: CB-ACCESS-PASSPHRASE description: The passphrase for the API key in: header type: apiKey auth_signature: name: CB-ACCESS-SIGN description: HMAC SHA-256 signature over TIMESTAMP + METHOD + REQUEST_PATH + BODY in: header type: apiKey ````