> ## Documentation Index > Fetch the complete documentation index at: https://docs.beliefsystems.xyz/llms.txt > Use this file to discover all available pages before exploring further. # List rating actions > The market's permanent rating-actions archive: every grade establishment, upgrade, downgrade, watch, suspension, and freeze, with its driver and timing. Not clamped to the free window: the archive is the citable record, and a truncated one would hide history. Rows are never edited; a correction is a new row that names what it corrects. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/grades/{venue}/{market_id}/actions openapi: 3.1.0 info: contact: name: Belief Systems url: https://beliefsystems.xyz/data description: >- Rules-based benchmark data for prediction markets: Belief index levels, Belief Volatility series, and Market Grades (beta), read over HTTPS with an API key. The API is read-only. Every endpoint is a `GET`, every successful response is `{ data, meta }`, and every failure is a single `error` object with a stable `code`. Keys are free and take about a minute to mint at https://beliefsystems.xyz/data. Attribution is required on anything you publish from this data: "Source: Belief Systems (beliefsystems.xyz)". Production, redistribution, and commercial use require a license (https://beliefsystems.xyz/license). license: name: Belief Systems Data License url: https://beliefsystems.xyz/license termsOfService: https://beliefsystems.xyz/terms title: Belief Systems Data API version: '1.0' servers: - description: Production. There is no separate test host; the API is read-only. url: https://api.beliefsystems.xyz security: - bearerAuth: [] - apiKeyAuth: [] tags: - description: >- Belief indices are rules-based benchmarks of how prediction markets price a defined set of events. Levels are exact decimal strings based at 100 on the index's inception date. name: Indices - description: >- Belief Volatility measures how much prediction-market probabilities are expected to move over a stated horizon, in probability points. Always name the tenor when quoting a value. name: Belief Volatility - description: >- Market Grades are letter grades for the quality of individual prediction markets (liquidity and integrity), not for the likelihood of any outcome. The family is in beta: the methodology and the validation roadmap are published, and results are reported as they arrive. Join on `venue` and `marketId` together, and reproduce `disclosureLines` wherever you show a letter. name: Market Grades - description: >- The service index, which reports your key's live quota, and pointers to the free point-in-time snapshot bundles. name: Service paths: /v1/grades/{venue}/{market_id}/actions: get: tags: - Market Grades summary: List rating actions description: >- The market's permanent rating-actions archive: every grade establishment, upgrade, downgrade, watch, suspension, and freeze, with its driver and timing. Not clamped to the free window: the archive is the citable record, and a truncated one would hide history. Rows are never edited; a correction is a new row that names what it corrects. operationId: listGradeActions parameters: - description: Venue slug. A market is identified by venue and market id together. example: polymarket in: path name: venue required: true schema: type: string - description: The venue's own market identifier. example: '0x42945ea5657d6f6e77969a06661b29d6f6295083d1ef3479b42efd90647c9dfc' in: path name: market_id required: true schema: type: string - description: Maximum actions to return. 1 to 1000. example: 100 in: query name: limit required: false schema: default: 500 maximum: 1000 minimum: 1 type: integer responses: '200': content: application/json: example: data: count: 1 marketId: >- 0x42945ea5657d6f6e77969a06661b29d6f6295083d1ef3479b42efd90647c9dfc rows: - actionId: >- polymarket:0x42945ea5657d6f6e77969a06661b29d6f6295083d1ef3479b42efd90647c9dfc:1:1 actionSeq: 1 actionType: grade_established asOf: '2026-10-23T00:00:00.000000Z' calibrationVersion: mg-cal-1.0 capsAtTime: - binding: true cap_letter: D lowered_letter: false source: weakest_link clockStartAsOf: null correctsActionId: null current: true disposition: confirmed driver: lifecycle effectiveAt: '2026-10-23T00:00:00.000000Z' evidenceCutoff: '2026-10-23T00:00:00.000000Z' gradeEpisodeId: >- polymarket:0x42945ea5657d6f6e77969a06661b29d6f6295083d1ef3479b42efd90647c9dfc:1 marketId: >- 0x42945ea5657d6f6e77969a06661b29d6f6295083d1ef3479b42efd90647c9dfc methodologyVersion: mg-1.2 newLetter: D preLaunch: false priorLetter: null publishedAt: '2026-10-23T01:39:00.519746Z' supersedesStateRevision: null venue: polymarket venue: polymarket meta: attribution: 'Source: Belief Systems (beliefsystems.xyz)' generatedAt: '2026-10-23T15:49:14.582224Z' license: https://beliefsystems.xyz/license termsUrl: https://beliefsystems.xyz/terms schema: $ref: '#/components/schemas/GradeActionsResponse' description: Success. '401': content: application/json: example: error: code: invalid_api_key docsUrl: >- https://docs.beliefsystems.xyz/api-reference/limits#invalid-api-key message: >- This endpoint requires a Data API key. Create one free at https://beliefsystems.xyz/data ; programmatic or commercial licensing is at https://beliefsystems.xyz/license. requestId: 9f2c1ad4e6b74c0f8a3d5e1b7c904a26 schema: $ref: '#/components/schemas/Error' description: Missing or unresolvable API key. '404': content: application/json: example: error: code: not_found docsUrl: >- https://docs.beliefsystems.xyz/api-reference/limits#not-found message: >- No Belief index 'NOPE'. GET /v1/indices lists the published catalog. requestId: 9f2c1ad4e6b74c0f8a3d5e1b7c904a26 schema: $ref: '#/components/schemas/Error' description: No index or volatility series matches that ticker on this surface. '422': content: application/json: example: error: code: invalid_interval docsUrl: >- https://docs.beliefsystems.xyz/api-reference/limits#invalid-interval message: >- interval must be '1h' or '1d'. Full granularity is part of the licensed feed. requestId: 9f2c1ad4e6b74c0f8a3d5e1b7c904a26 schema: $ref: '#/components/schemas/Error' description: A parameter failed validation. '429': content: application/json: example: error: code: rate_limited docsUrl: >- https://docs.beliefsystems.xyz/api-reference/limits#rate-limited message: 'Rate limit exceeded: 60 requests per minute per key.' requestId: 9f2c1ad4e6b74c0f8a3d5e1b7c904a26 schema: $ref: '#/components/schemas/Error' description: >- Rate limited. Sleep for `Retry-After` seconds, which is exact on both windows. default: content: application/json: schema: $ref: '#/components/schemas/Error' description: Error. Every /v1 failure uses this shape. x-codeSamples: - label: curl lang: curl source: >- curl -s "https://api.beliefsystems.xyz/v1/grades/polymarket/0x42945ea5657d6f6e77969a06661b29d6f6295083d1ef3479b42efd90647c9dfc/actions?limit=100" \ -H "Authorization: Bearer $BELIEF_API_KEY" - label: Python lang: python source: |- import os import requests resp = requests.get( "https://api.beliefsystems.xyz/v1/grades/polymarket/0x42945ea5657d6f6e77969a06661b29d6f6295083d1ef3479b42efd90647c9dfc/actions?limit=100", headers={"Authorization": f"Bearer {os.environ['BELIEF_API_KEY']}"}, timeout=10, ) resp.raise_for_status() payload = resp.json() print(payload["data"]) - label: JavaScript lang: javascript source: >- const res = await fetch("https://api.beliefsystems.xyz/v1/grades/polymarket/0x42945ea5657d6f6e77969a06661b29d6f6295083d1ef3479b42efd90647c9dfc/actions?limit=100", { headers: { Authorization: `Bearer ${process.env.BELIEF_API_KEY}` }, }); if (!res.ok) throw new Error(`Belief Systems API ${res.status}`); const { data, meta } = await res.json(); console.log(data); components: schemas: GradeActionsResponse: properties: data: properties: count: type: integer marketId: type: string rows: items: properties: actionId: description: '`venue:marketId:episode:sequence`. Permanent and citable.' type: string actionSeq: description: Sequence within the episode. type: integer actionType: description: >- For example `grade_established`, `upgrade`, `downgrade`, `watch_placed`, `suspension`, `restoration`, `terminal_freeze`, `resolved`. type: string asOf: description: Measurement day that produced the action. format: date-time type: string calibrationVersion: type: string capsAtTime: description: Caps in force at the action. Null when withheld. items: description: One cap applied to the letter. properties: binding: description: >- True when the cap is in force at or below the published letter. type: boolean cap_letter: description: >- The best letter the cap allows. Letter on the published scale, best to worst: `A+`, `A`, `A-`, `B+`, `B`, `B-`, `C+`, `C`, `C-`, `D`, `F`. type: string lowered_letter: description: >- True only when the cap actually lowered the letter it was applied to. type: boolean source: description: >- What imposed the cap: `evidence_tier` or `weakest_link`. type: string type: object type: - array - 'null' clockStartAsOf: description: When the confirmation clock started, if any. format: date-time type: - string - 'null' correctsActionId: description: >- Non-null on the action a published correction wrote: the `actionId` of the action it replaces. A letter-setting row (upgrade, downgrade, first grade, rebaseline) with `correctsActionId` is a correction (a revised grade), never an upgrade or downgrade; the `upgrade` and `downgrade` filters on the recent-actions feed leave it out. The replaced action stays in the archive. type: - string - 'null' current: description: >- True when the action belongs to the current version of its day. When a day is re-derived, its actions are archived again and the earlier version's actions stay in the archive with `current: false`. Read the day's record from its current actions. type: boolean disposition: description: >- For example `confirmed`, `pending`, `superseded`, `not_confirmed`. type: string driver: description: >- What drove the action, for example `score`, `lifecycle`, `coverage`. type: string effectiveAt: description: When the action took effect. format: date-time type: - string - 'null' evidenceCutoff: description: Last evidence the action considered. format: date-time type: - string - 'null' gradeEpisodeId: type: string marketId: type: string methodologyVersion: type: string newLetter: description: >- Letter after the action. Null when withheld or not applicable. type: - string - 'null' preLaunch: description: >- True for actions before the family's launch. Their letters are withheld permanently. type: boolean priorLetter: description: >- Letter before the action. Null when withheld or not applicable. type: - string - 'null' publishedAt: description: When the action was written to the archive. format: date-time type: - string - 'null' supersedesStateRevision: description: >- Set when the action was re-archived by a correction of that day's state. Null for the original archive. type: - integer - 'null' venue: example: polymarket type: string type: object type: array venue: type: string type: object meta: properties: attribution: description: >- The attribution line required on anything you publish from this data. Reproduce it verbatim. example: 'Source: Belief Systems (beliefsystems.xyz)' type: string generatedAt: description: >- When this response was generated. UTC timestamp with microsecond precision, `Z`-suffixed. format: date-time type: string license: description: Terms covering production, redistribution, and commercial use. format: uri type: string termsUrl: description: Terms of Service. format: uri type: string required: - attribution - license - termsUrl - generatedAt type: object required: - data - meta type: object Error: description: >- Every failure replaces `data` and `meta` with a single `error` object. Match on `code`, which is a stable contract. `message` is written for a person and may be reworded. properties: error: properties: code: description: Stable machine-readable error code. enum: - invalid_api_key - ip_rate_limited - rate_limited - daily_limit_reached - not_found - invalid_parameter - invalid_interval - invalid_window - method_not_allowed - internal_error - unavailable - error type: string docsUrl: description: Deep link to this code on the limits and errors page. format: uri type: string message: description: Human-readable explanation. Not a stable contract. type: string requestId: description: >- Correlation id, also returned as the X-Request-Id header. Quote it in support requests. type: string required: - code - message - docsUrl - requestId type: object required: - error title: Error type: object securitySchemes: bearerAuth: description: >- Your Data API key as a Bearer token: `Authorization: Bearer belief_live_...`. This is the canonical form. Keys belong on a server, never in a browser. scheme: bearer type: http apiKeyAuth: description: >- The same key sent as `X-API-Key` instead. Accepted everywhere the Bearer header is. Send one or the other, not both. in: header name: X-API-Key type: apiKey ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.