Export full history

curl --request GET \
  --url https://api.forum.market/v1/indices/{name}/history/export \
  --header 'FORUM-ACCESS-KEY: <api-key>' \
  --header 'FORUM-ACCESS-SIGN: <api-key>' \
  --header 'FORUM-ACCESS-TIMESTAMP: <api-key>'

import requests

url = "https://api.forum.market/v1/indices/{name}/history/export"

headers = {
    "FORUM-ACCESS-KEY": "<api-key>",
    "FORUM-ACCESS-TIMESTAMP": "<api-key>",
    "FORUM-ACCESS-SIGN": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {
    'FORUM-ACCESS-KEY': '<api-key>',
    'FORUM-ACCESS-TIMESTAMP': '<api-key>',
    'FORUM-ACCESS-SIGN': '<api-key>'
  }
};

fetch('https://api.forum.market/v1/indices/{name}/history/export', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "history": [
    {
      "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
    }
  ],
  "throughId": 512840,
  "nextAfterId": 505595
}

Source Data

Export full history

Returns every value an Attention Index has published, with its raw value and source scores, in pages of up to 2,500 ordered by id.

Start with afterId=0. The first page fixes throughId, the last id the export covers. Request the next page with the returned nextAfterId and throughId until nextAfterId is null. Values published after the export started are left out, so pages stay consistent.

IDs increase over time but are shared across indices, so they are not consecutive. Backfilled values can have higher IDs than live values with earlier timestamps; sort by timestamp if you need time order. An unknown index name returns an empty page.

Requires an API key whose owner belongs to an approved institution. See Authentication.

GET

indices

{name}

history

export

Export full history

curl --request GET \
  --url https://api.forum.market/v1/indices/{name}/history/export \
  --header 'FORUM-ACCESS-KEY: <api-key>' \
  --header 'FORUM-ACCESS-SIGN: <api-key>' \
  --header 'FORUM-ACCESS-TIMESTAMP: <api-key>'

import requests

url = "https://api.forum.market/v1/indices/{name}/history/export"

headers = {
    "FORUM-ACCESS-KEY": "<api-key>",
    "FORUM-ACCESS-TIMESTAMP": "<api-key>",
    "FORUM-ACCESS-SIGN": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {
    'FORUM-ACCESS-KEY': '<api-key>',
    'FORUM-ACCESS-TIMESTAMP': '<api-key>',
    'FORUM-ACCESS-SIGN': '<api-key>'
  }
};

fetch('https://api.forum.market/v1/indices/{name}/history/export', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "history": [
    {
      "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
    }
  ],
  "throughId": 512840,
  "nextAfterId": 505595
}

Authorizations

FORUM-ACCESS-KEY

string

header

required

Your API key ID, starting with fk_.

FORUM-ACCESS-TIMESTAMP

string

header

required

The current Unix time in seconds. Must be within 30 seconds of the server's time.

FORUM-ACCESS-SIGN

string

header

required

Base64-encoded HMAC-SHA256 of the timestamp, method, path and body, keyed with your API secret. See Authentication.

Path Parameters

name

string

required

The index name, which is the index’s ticker followed by -IDX. GET /indices returns every name.

Query Parameters

afterId

integer

default:0

Return values with an id greater than this. Use 0 for the first page, then the previous page's nextAfterId.

Required range: x >= 0

throughId

integer

Return values with an id up to and including this. Omit on the first page, then pass the throughId it returned.

Required range: x >= 0

Response

A page of index values, ordered by id.

history

object[]

required

Up to 2,500 values, ordered by id.

Show child attributes

throughId

integer

required

The last id this export covers. Pass it back with every following page.

Example:

512840

nextAfterId

integer | null

required

The afterId for the next page, or null when this is the last page.

Example:

505595