API DOCUMENTATION

Public endpoints for accessing African sovereignty intelligence data. All endpoints are free, require no authentication, and return JSON (except RSS and OG image).

CORS ENABLEDNO AUTH REQUIREDRATE LIMITED

BASE URLhttps://axis-mocha.vercel.app

GET/api/public/trust-health

Sanitized aggregate trust and freshness state for public scores, intelligence, blogs, and commodities.

EXAMPLE REQUEST

curl -s https://axis-mocha.vercel.app/api/public/trust-health | jq .

EXAMPLE RESPONSE

{
  "status": "degraded",
  "generatedAt": "2026-07-18T00:00:00.000Z",
  "datasets": {
    "countryScores": { "state": "static-fallback" },
    "intelligence": { "state": "legacy-live-ingested" },
    "blogs": { "state": "legacy-live-ingested" },
    "commodities": {
      "state": "static-fallback",
      "trustedCoverage": { "records": 0, "total": 5 }
    }
  }
}

GET/api/public/scores

Returns sovereignty scores for all 54 African nations. Includes axisScore, status, key resources, and sub-indices.

EXAMPLE REQUEST

curl -s https://axis-mocha.vercel.app/api/public/scores | jq .

EXAMPLE RESPONSE

{
  "success": true,
  "count": 54,
  "generatedAt": "2026-07-16T19:15:09.411Z",
  "sourceUpdatedAt": "2026-04-12T00:00:00.000Z",
  "asOf": "2026-04-12T00:00:00.000Z",
  "dataMode": "fallback",
  "trustState": "static-fallback",
  "data": [
    {
      "country": "NGA",
      "name": "Nigeria",
      "axisScore": 68,
      "status": "IMPROVING",
      "infrastructureControl": 55,
      "policyIndependence": 60,
      "currencyStability": 45,
      "resourceWealth": 92,
      "keyResources": ["Oil", "Gas", "Tin"],
      "dataMode": "fallback",
      "trustState": "static-fallback",
      "sourceUpdatedAt": "2026-04-12T00:00:00.000Z"
    }
  ]
}

GET/api/public/trust-health

Aggregate, sanitized production trust-health snapshot across country scores, intelligence, blogs, and commodities. Reports the exact shared displayState for each dataset — trusted-current, trusted-stale, legacy-live-ingested, cached, static-fallback, or unavailable — plus coverage and reason codes. Missing publication times include counts for every dataset, but identities only for stable public ISO-3 country and commodity keys. The strict allowlisted contract excludes internal feed identifiers, secrets, raw errors, source URLs or excerpts, storage details, and internal diagnostics.

EXAMPLE REQUEST

curl -s https://axis-mocha.vercel.app/api/public/trust-health | jq .

EXAMPLE RESPONSE

{
  "version": "1",
  "status": "stale",
  "generatedAt": "2026-07-18T00:00:00.000Z",
  "trustedPublicationsEnabled": false,
  "datasets": {
    "countryScores": {
      "publicationTier": "legacy",
      "status": "stale",
      "displayState": "static-fallback",
      "coverage": { "availableRecords": 54, "expectedRecords": 54, "trustedRecords": 0, "trustedExpectedRecords": 54, "missingIdentities": [], "missingTrustedIdentities": [], "missingPublicationTimeRecords": 0, "missingPublicationTimeIdentities": [] },
      "freshness": { "sourcePublishedAt": "2024-12-31T00:00:00.000Z", "sourceObservedAt": "2024-12-31T00:00:00.000Z" },
      "fallback": { "used": true, "state": "static" },
      "reasonCodes": ["legacy-publication", "source-stale"]
    },
    "commodities": {
      "publicationTier": "legacy",
      "displayState": "static-fallback",
      "coverage": { "trustedRecords": 0, "trustedExpectedRecords": 5 },
      "reasonCodes": ["legacy-publication", "trusted-coverage-zero"]
    }
  }
}

GET/api/commodities

African-relevant commodity benchmark prices. Includes gold, copper, cobalt, lithium, and bauxite with source attribution and update frequency.

EXAMPLE REQUEST

curl -s https://axis-mocha.vercel.app/api/commodities | jq .

EXAMPLE RESPONSE

{
  "success": true,
  "generatedAt": "2026-07-16T19:15:09.411Z",
  "sourceUpdatedAt": "2026-07-15T00:00:00.000Z",
  "dataMode": "fallback",
  "trustState": "static-fallback",
  "data": [
    {
      "id": "gold",
      "name": "GOLD (SPOT)",
      "price": 3250,
      "unit": "OZ",
      "currency": "USD",
      "trend": 0.45,
      "source": "LBMA / Kitco",
      "frequency": "daily",
      "lastUpdated": "2026-07-15",
      "dataMode": "fallback",
      "trustState": "static-fallback",
      "sourceUpdatedAt": "2026-07-15T00:00:00.000Z"
    }
  ]
}

GET/feed.xml

RSS 2.0 feed of intelligence alerts from the AXIS Africa monitoring system. Subscribe in any RSS reader.

EXAMPLE REQUEST

curl -s https://axis-mocha.vercel.app/feed.xml | head -20

EXAMPLE RESPONSE

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0">
  <channel>
    <title>AXIS Africa Intelligence Feed</title>
    <item>
      <title>[HIGH] Gold reserves policy shift — GHA</title>
      <description>Ghana announces new gold reserve requirements...</description>
    </item>
  </channel>
</rss>

GET/api/og

Dynamic Open Graph image generation. Use query params to customize social preview cards.

EXAMPLE REQUEST

curl -s "https://axis-mocha.vercel.app/api/og?country=Nigeria&score=86&status=OPTIMAL" -o preview.png

EXAMPLE RESPONSE

Returns a 1200×630 PNG image for social media cards.

GET/embed/{COUNTRY_CODE}

Embeddable country sovereignty card. Use in an iframe for external sites.

EXAMPLE REQUEST

# Use in HTML:
<iframe src="https://axis-mocha.vercel.app/embed/NGA" width="400" height="280" />

EXAMPLE RESPONSE

Returns an HTML page with a compact country card.

AXIS AFRICA — OPEN SOURCE INTELLIGENCE INFRASTRUCTURE