> ## 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. # Get a series by id or ticker > Returns one series. Requires MARKET_DATA permission. ## OpenAPI ````yaml /api-reference/derivatives-predictions-api/rest-api/cpm-spec.json get /api/v1/series/{id_or_ticker} 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/series/{id_or_ticker}: get: tags: - Reference summary: Get a series by id or ticker description: Returns one series. Requires MARKET_DATA permission. operationId: getSeries parameters: - name: id_or_ticker in: path description: >- Series ID or exact ticker. An all-digit value is read as an ID; anything else as a ticker. required: true deprecated: false allowEmptyValue: false schema: type: string responses: '200': description: Series content: application/json: schema: $ref: '#/components/schemas/SeriesReferenceResponse' '400': description: Invalid parameter content: application/json: schema: $ref: '#/components/schemas/ReferenceDataErrorResponse' '404': description: Series not found content: application/json: schema: $ref: '#/components/schemas/ReferenceDataErrorResponse' deprecated: false security: [] components: schemas: SeriesReferenceResponse: type: object additionalProperties: false properties: id: type: string description: Series id, as a canonical decimal string. example: '398471892345' ticker: type: string description: Unique series ticker. Treat it as an opaque identifier. example: NFL-GAMEWINNER title: type: string description: Human-readable name. example: NFL Game Winner description: type: string description: Series description, or null when there is none. example: Predict which team will win an NFL game. category: type: string description: >- Market category of the series: SPORTS, ECONOMICS, POLITICS, CRYPTO, or WEATHER. example: SPORTS mutually_exclusive: type: boolean description: >- Whether each group of instruments under this series represents mutually exclusive outcomes. example: true created_at: type: integer format: int64 description: Creation time in Unix epoch milliseconds. example: 1782498528000 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 series metadata as a JSON object, or null. The fields vary by market. required: - mutually_exclusive - 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 ````