Snapshot downloads

curl -s "https://api.beliefsystems.xyz/v1/downloads" \
  -H "Authorization: Bearer $BELIEF_API_KEY"

import os
import requests

resp = requests.get(
    "https://api.beliefsystems.xyz/v1/downloads",
    headers={"Authorization": f"Bearer {os.environ['BELIEF_API_KEY']}"},
    timeout=10,
)
resp.raise_for_status()

payload = resp.json()
print(payload["data"])

const res = await fetch("https://api.beliefsystems.xyz/v1/downloads", {
  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);

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.beliefsystems.xyz/v1/downloads",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.beliefsystems.xyz/v1/downloads"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.beliefsystems.xyz/v1/downloads")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.beliefsystems.xyz/v1/downloads")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": {
    "downloadsUrl": "https://beliefsystems.xyz/data",
    "latestManifestUrl": "https://beliefsystems.xyz/data/latest/manifest.json",
    "license": "CC BY-NC 4.0 with editorial-use grant; see LICENSE.md in each bundle",
    "notes": "Full aggregate history since inception, composition membership and target weights, and reconstitution chain-link arithmetic are published as monthly point-in-time CSV snapshots. This API serves the trailing 90-day window."
  },
  "meta": {
    "attribution": "Source: Belief Systems (beliefsystems.xyz)",
    "generatedAt": "2026-08-31T14:01:22.277647Z",
    "license": "https://beliefsystems.xyz/license",
    "termsUrl": "https://beliefsystems.xyz/terms"
  }
}

{
  "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"
  }
}

{
  "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"
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "docsUrl": "<string>",
    "message": "<string>",
    "requestId": "<string>"
  }
}