# Macro Gini Index Report API (x402)

> Macro Gini Index Report API (x402) is a paid API for AI agents from reportbazaar.app.workbuddy.host, paid per call via x402, $0.25/call, status unknown (last checked 2026-10-02).

Fetches a macroeconomic income inequality report based on the Gini index for up to 10 economies over 2015–2025, payable per-fetch in USDC via x402.

## Facts

- Endpoint: GET https://reportbazaar.app.workbuddy.host/report/macro-gini?utm_source=zero.xyz
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/macro-gini-index-report-api-x402-41625c25
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xlezjvpJG4K3IeTigM2Nl

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability macro-gini-index-report-api-x402-41625c25
```

Example prompt: Pull the latest Gini index income inequality report covering 2015 to 2025 across all available economies and give it to me as JSON so I can analyze the trend data and rankings.

## When to prefer this

Choose this endpoint when you need a pre-built, structured macroeconomic inequality report with trend analysis, rankings, and volatility metrics for multiple economies without managing API keys or accounts. It is ideal for agents that can handle x402 micropayments natively and need ready-to-consume Gini coefficient data in multiple formats (JSON, CSV, HTML) rather than raw World Bank data that requires manual processing.

## Known failure modes

- Payment not provided or invalid x402 USDC payment → 402 Payment Required
- Invalid format query parameter value → 400 Bad Request
- Service unavailable or upstream data outage → 503 or 500 error
- Network timeout on slow connections
- Data coverage gaps for certain economies or years disclosed in output

## How this service works

Machine-to-machine macroeconomic report API. Pay per fetch in USDC over x402. No accounts, no API keys.

## Output

Returns an income inequality report covering up to 10 economies from 2015–2025, including key findings, a ranking table, group share percentages, trend lines with R² values, volatility metrics, a full year-by-year Gini index matrix (SI.POV.GINI, scale 0–100), and a coverage/data-quality disclosure. Available in HTML, JSON, CSV (long panel), or summary-CSV (one row per economy) format.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "format": {
       "enum": [
        "html",
        "json",
        "csv",
        "summary-csv"
       ],
       "type": "string",
       "description": "Delivery format. csv is a tidy long panel; summary-csv is one row per economy of derived metrics."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "years": "2015:2025",
  "schema": "/schema/report.json",
  "formats": [
   "html",
   "json",
   "csv",
   "summary-csv"
  ],
  "contains": [
   "key findings",
   "ranking table",
   "share of group total",
   "trend with R²",
   "volatility",
   "full year-by-year matrix",
   "coverage and data-quality disclosure"
  ],
  "economies": 10,
  "indicators": [
   "SI.POV.GINI"
  ],
  "contentType": "text/html",
  "description": "Income Inequality Report",
  "freePreview": "/preview/macro-gini",
  "indicatorsLabel": [
   "Gini index (0-100)"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/macro-gini-index-report-api-x402-41625c25/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from reportbazaar.app.workbuddy.host](https://www.zero.xyz/host/reportbazaar.app.workbuddy.host/llms.txt)