Skip to main content

​
Markets API

The Markets API provides structured data for macroeconomic indices, commodities, and AI-generated sentiment reports tracking broad economic trends.
Access Level Required: High-volume streams and AI forecasting (e.g. Brent Crude futures, JSE Sentiment matching) require a Visita Pro subscription. Basic quotes are open to registered residents.

​
Endpoints

​
1. Global Markets

Retrieve pricing for indices (e.g. JSE All Share, S&P 500). GET /api/v1/markets Parameters
  • symbol (optional string): Filter by a specific symbol.
Response 
{
  "data": [
    {
      "id": "uuid",
      "symbol": "JSE_ALSI",
      "name": "JSE All Share Index",
      "current_price": 79400.50,
      "daily_change_pct": 0.54,
      "market_status": "open"
    }
  ],
  "meta": {
    "count": 1
  }
}

​
2. Commodities

Access real-time commodity data impacting local township prices (e.g., Maize, Fuel). GET /api/v1/markets/commodities

​
3. Sentiment Analysis (Visita Pro Only)

AI-generated reports explaining what market movements mean for the township economy. GET /api/v1/markets/sentiment