{
    "openapi": "3.1.0",
    "info": {
        "title": "XMRList open data API",
        "version": "1.0.0",
        "description": "Free, read-only data about the Monero economy. No key needed; CORS open; rate limited to 120 requests per minute per IP. Data licence: CC BY 4.0."
    },
    "servers": [
        {
            "url": "https://xmrlist.com"
        }
    ],
    "paths": {
        "/api/listings": {
            "get": {
                "summary": "Directory listings",
                "description": "Paginated listings with filters status, category, country, tag, q.",
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {}
                        }
                    }
                }
            }
        },
        "/api/listings/{slug}": {
            "get": {
                "summary": "One listing",
                "description": "A single listing by slug.",
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {}
                        }
                    }
                }
            }
        },
        "/api/categories": {
            "get": {
                "summary": "Categories",
                "description": "All categories with listing counts.",
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {}
                        }
                    }
                }
            }
        },
        "/api/v1/stats": {
            "get": {
                "summary": "Monero Merchant Index",
                "description": "Latest daily snapshot: totals, KYC, onion, processors, discounts, health, grades, categories, countries.",
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {}
                        }
                    }
                }
            }
        },
        "/api/v1/exchanges": {
            "get": {
                "summary": "Exchanges listing XMR",
                "description": "Centralised exchanges with live XMR markets (CoinGecko), plus listing and delisting events.",
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {}
                        }
                    }
                }
            }
        },
        "/api/v1/regulation": {
            "get": {
                "summary": "Privacy-coin regulation",
                "description": "Jurisdictions with status, scope, summary and source link.",
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {}
                        }
                    }
                }
            }
        },
        "/api/v1/releases": {
            "get": {
                "summary": "Software releases",
                "description": "Latest stable and pre-release versions of Monero software, with FCMP++ readiness status.",
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {}
                        }
                    }
                }
            }
        },
        "/api/v1/advisories": {
            "get": {
                "summary": "Security advisories",
                "description": "Security advisories and security releases for Monero software.",
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {}
                        }
                    }
                }
            }
        },
        "/api/v1/status": {
            "get": {
                "summary": "Ecosystem status",
                "description": "Reachability and uptime of explorers, node lists and other Monero infrastructure.",
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {}
                        }
                    }
                }
            }
        },
        "/api/v1/network": {
            "get": {
                "summary": "Network and fees",
                "description": "Height, hashrate, mempool and fees per priority in XMR, plus XMR prices.",
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {}
                        }
                    }
                }
            }
        },
        "/data.json": {
            "get": {
                "summary": "Full directory dump",
                "description": "Every graded listing with key facts.",
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {}
                        }
                    }
                }
            }
        },
        "/stats/snapshots/{date}.json": {
            "get": {
                "summary": "Frozen daily snapshot",
                "description": "The Merchant Index exactly as published on that date.",
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {}
                        }
                    }
                }
            }
        }
    }
}