> ## Documentation Index
> Fetch the complete documentation index at: https://docs.visita.co.za/llms.txt
> Use this file to discover all available pages before exploring further.

# Markets API

> Access global market intelligence and commodity tracking

# Markets API

The Markets API provides structured data for macroeconomic indices, commodities, and AI-generated sentiment reports tracking broad economic trends.

<Note>
  **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.
</Note>

## 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**

```json theme={null}
{
  "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`