> ## Documentation Index > Fetch the complete documentation index at: https://docs.forum.market/llms.txt > Use this file to discover all available pages before exploring further. # Get source history > Returns published values of an Attention Index within a time range, oldest first, with the raw index value and each source's score. `start`, `end`, `interval` and `limit` work as in `GET /indices/{name}/history`. An unknown index name returns an empty array. Requires an API key whose owner belongs to an approved institution. See [Authentication](/api-reference/authentication). ## OpenAPI ````yaml /openapi.yaml get /indices/{name}/history/sources openapi: 3.1.0 info: title: Forum API version: '1.0' description: Public, read-only access to Attention Index data. contact: name: Forum Support email: contact@forum.market url: https://forum.market servers: - url: https://api.forum.market/v1 description: Production security: [] tags: - name: Indices description: Attention Index data. - name: Source Data description: >- Raw and per-source index values, for approved institutions. Requests are signed with an API key. paths: /indices/{name}/history/sources: get: tags: - Source Data summary: Get source history description: > Returns published values of an Attention Index within a time range, oldest first, with the raw index value and each source's score. `start`, `end`, `interval` and `limit` work as in `GET /indices/{name}/history`. An unknown index name returns an empty array. Requires an API key whose owner belongs to an approved institution. See [Authentication](/api-reference/authentication). operationId: getIndexSourceHistory parameters: - $ref: '#/components/parameters/IndexName' - name: start in: query required: true schema: type: string format: date-time description: Start of the time range (ISO 8601, inclusive). example: '2026-10-12T00:00:00.000Z' - name: end in: query schema: type: string format: date-time description: >- End of the time range (ISO 8601, inclusive). Defaults to the current time. - name: interval in: query schema: type: string pattern: ^(raw|8h|[1-9][0-9]*d)$ default: raw description: >- Resolution of the returned values. Use `raw` for every published value, `8h`, or a whole number of days such as `1d` or `7d`. - name: limit in: query schema: type: integer minimum: 1 maximum: 2500 default: 2500 description: >- Maximum number of values to return. When more values match, the most recent ones are returned. responses: '200': description: Index values with their sources, oldest first. headers: X-RateLimit-Limit: $ref: '#/components/headers/X-RateLimit-Limit-Account' X-RateLimit-Remaining: $ref: '#/components/headers/X-RateLimit-Remaining' X-RateLimit-Reset: $ref: '#/components/headers/X-RateLimit-Reset' content: application/json: schema: type: array items: $ref: '#/components/schemas/IndexSourceHistoryRecord' example: - id: 505595 name: FORTNITE-IDX value: 56.576344892425176 raw: 56.21093815276502 timestamp: '2026-10-22T20:03:00.047Z' scheduledAt: '2026-10-22T20:03:00.000Z' sourceValues: youtube: 6.012477350238114 reddit: 4.871903257091735 x: 5.103388224510987 google_trends: 5.794126107344519 backfillVersion: null '400': $ref: '#/components/responses/InvalidParameter' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/AccountRateLimited' '503': $ref: '#/components/responses/AccessCheckUnavailable' security: - AccessKey: [] AccessTimestamp: [] AccessSign: [] components: parameters: IndexName: name: name in: path required: true schema: type: string description: >- The index name, which is the index’s ticker followed by `-IDX`. `GET /indices` returns every name. example: FORTNITE-IDX headers: X-RateLimit-Limit-Account: description: Requests allowed per minute for this key's account. schema: type: integer X-RateLimit-Remaining: description: Requests remaining in the current window. schema: type: integer X-RateLimit-Reset: description: Unix time (seconds) when the oldest request in the window expires. schema: type: integer schemas: IndexSourceHistoryRecord: type: object required: - id - name - value - raw - timestamp - scheduledAt - sourceValues - backfillVersion properties: id: type: integer description: Unique ID of the published value. example: 505595 name: type: string description: The index name. example: FORTNITE-IDX value: type: number description: The published Attention Index value (after EMA smoothing). example: 56.576344892425176 raw: type: number description: The Raw Index value before EMA smoothing. example: 56.21093815276502 timestamp: type: string format: date-time description: When the value was published (ISO 8601, UTC). example: '2026-10-22T20:03:00.047Z' scheduledAt: type: - string - 'null' format: date-time description: >- The publication slot the value was produced for (ISO 8601, UTC), or null if none was recorded. example: '2026-10-22T20:03:00.000Z' sourceValues: type: object description: >- Each source's score at this publication, before weighting, keyed by source identifier such as `youtube`, `reddit`, `x` or `google_trends`. additionalProperties: type: number backfillVersion: type: - string - 'null' description: >- Null for a value recorded live. Otherwise the value was reconstructed after the fact, and this names the method that produced it. example: null Error: type: object required: - error properties: error: type: object required: - code - message properties: code: type: string example: INVALID_PARAMETER message: type: string details: type: object additionalProperties: true responses: InvalidParameter: description: A query parameter is missing or invalid. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: INVALID_PARAMETER message: Request validation failed details: fields: - field: start message: 'Invalid input: expected string, received undefined' Unauthorized: description: >- The authentication headers are missing, the key is unknown or revoked, the timestamp is outside the 30-second window, or the signature does not match. content: application/json: schema: $ref: '#/components/schemas/Error' examples: missingHeaders: summary: Missing headers value: error: code: UNAUTHORIZED message: Missing HMAC authentication headers timestampExpired: summary: Timestamp outside the window value: error: code: TIMESTAMP_EXPIRED message: Request timestamp is outside the allowed window invalidSignature: summary: Signature does not match value: error: code: INVALID_SIGNATURE message: Signature verification failed Forbidden: description: The key's owner does not belong to an approved institution. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: INSUFFICIENT_PERMISSIONS message: Source data requires membership of an approved institution AccountRateLimited: description: >- Too many requests from this key's account. Source data endpoints allow 300 requests per minute per account unless we have agreed a different limit with you. headers: Retry-After: description: Seconds to wait before retrying. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: RATE_LIMIT_EXCEEDED message: Rate limit exceeded. Retry after 12 seconds details: retryAfter: 12 AccessCheckUnavailable: description: Institution approval could not be checked. Retry shortly. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: IDENTITY_VERIFICATION_UNAVAILABLE message: Institution access check is unavailable securitySchemes: AccessKey: type: apiKey in: header name: FORUM-ACCESS-KEY description: Your API key ID, starting with `fk_`. AccessTimestamp: type: apiKey in: header name: FORUM-ACCESS-TIMESTAMP description: >- The current Unix time in seconds. Must be within 30 seconds of the server's time. AccessSign: type: apiKey in: header name: FORUM-ACCESS-SIGN description: >- Base64-encoded HMAC-SHA256 of the timestamp, method, path and body, keyed with your API secret. See [Authentication](/api-reference/authentication). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.