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/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,
  "data": [
    {
      "country": "NGA",
      "name": "Nigeria",
      "axisScore": 68,
      "status": "IMPROVING",
      "infrastructureControl": 55,
      "policyIndependence": 60,
      "currencyStability": 45,
      "resourceWealth": 92,
      "keyResources": ["Oil", "Gas", "Tin"]
    }
  ]
}

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,
  "data": [
    {
      "id": "gold",
      "name": "GOLD (SPOT)",
      "price": 3250,
      "unit": "OZ",
      "currency": "USD",
      "trend": 0.45,
      "source": "LBMA / Kitco",
      "frequency": "daily",
      "lastUpdated": "2025-01-15"
    }
  ]
}

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