{
  "schema": "super-calendar.ioapi.v1",
  "name": "Super-Calendar I/O API",
  "description": "Low-level projection contract for reading small nodes from calendar resources without parsing full JSON payloads.",
  "base": "https://super-calendar.io/api",
  "formats": ["txt", "json", "csv", "tsv", "ndjson", "jsonl"],
  "addressing": {
    "root": "/{resource}/io",
    "table": "/{resource}/io/{table}",
    "row": "/{resource}/io/{table}/{row}",
    "column": "/{resource}/io/{table}/{field}",
    "cell": "/{resource}/io/{table}/{row}/{field}",
    "field": "/{resource}/io/{object}/{field}",
    "formatSuffix": "/{resource}/io/{address}.{format}",
    "indexBase": 1
  },
  "resources": [
    {
      "id": "weather",
      "emoji": "⛅",
      "summary": "Weather forecast calendar nodes.",
      "example": "/api/weather/io/events/summary.txt?city=Sao%20Paulo&units=metric&lang=pt-BR&emoji=true",
      "feed": "/feeds/weather/",
      "nodes": [
        {
          "id": "events",
          "kind": "table",
          "columns": ["summary", "description", "startDateString", "endDateString", "uid"]
        },
        {
          "id": "events/summary",
          "kind": "column",
          "formats": ["txt", "json", "csv", "tsv"]
        },
        {
          "id": "meta/calendarDesc",
          "kind": "field",
          "formats": ["txt", "json"]
        }
      ]
    },
    {
      "id": "exchange",
      "emoji": "💱",
      "summary": "Currency exchange calendar nodes.",
      "example": "/api/exchange/io/events/summary.txt?base=USD&target=BRL&lang=pt-BR&emoji=true",
      "feed": "/feeds/exchange/",
      "nodes": [
        {
          "id": "events",
          "kind": "table",
          "columns": ["summary", "description", "startDateString", "uid"]
        },
        {
          "id": "events/summary",
          "kind": "column",
          "formats": ["txt", "json", "csv", "tsv"]
        }
      ]
    },
    {
      "id": "moon",
      "emoji": "🌙",
      "summary": "Moon phase calendar nodes.",
      "example": "/api/moon/io/events/summary.txt?lang=en&emoji=true",
      "feed": "/feeds/moon/",
      "nodes": [
        {
          "id": "events",
          "kind": "table",
          "columns": ["summary", "description", "startDateString", "uid"]
        },
        {
          "id": "events/summary",
          "kind": "column",
          "formats": ["txt", "json", "csv", "tsv"]
        }
      ]
    },
    {
      "id": "seasons",
      "emoji": "🌐",
      "summary": "Season, solstice, and equinox calendar nodes.",
      "example": "/api/seasons/io/events/summary.txt?year=2026&hemisphere=south&lang=pt-BR&emoji=true",
      "nodes": [
        {
          "id": "events",
          "kind": "table",
          "columns": ["summary", "description", "startDateString", "uid"]
        },
        {
          "id": "events/summary",
          "kind": "column",
          "formats": ["txt", "json", "csv", "tsv"]
        }
      ]
    },
    {
      "id": "religion",
      "emoji": "🛐",
      "summary": "Religious observance calendar nodes.",
      "example": "/api/religion/io/events/summary.txt?religion=christianity&lang=en&emoji=true",
      "feed": "/feeds/religion/",
      "nodes": [
        {
          "id": "events",
          "kind": "table",
          "columns": ["summary", "description", "startDateString", "uid"]
        },
        {
          "id": "events/summary",
          "kind": "column",
          "formats": ["txt", "json", "csv", "tsv"]
        }
      ]
    },
    {
      "id": "events",
      "emoji": "🔄",
      "summary": "Recurring event calendar nodes.",
      "example": "/api/events/io/events/summary.txt?year=2026&periodic=01&studies=05&rent=10&lang=pt-BR&emoji=true",
      "nodes": [
        {
          "id": "events",
          "kind": "table",
          "columns": ["summary", "description", "startDateString", "uid"]
        },
        {
          "id": "events/summary",
          "kind": "column",
          "formats": ["txt", "json", "csv", "tsv"]
        }
      ]
    },
    {
      "id": "custom",
      "emoji": "📅",
      "summary": "Fully custom calendar event nodes.",
      "example": "/api/custom/io/events/summary.txt?lang=pt-BR&name=Dias&Counter-Day=%7B%22day%22%3A20%2C%22month%22%3A2%2C%22name%22%3A%22Counter-day%22%7D",
      "nodes": [
        {
          "id": "events",
          "kind": "table",
          "columns": ["summary", "description", "startDateString", "uid"]
        },
        {
          "id": "events/summary",
          "kind": "column",
          "formats": ["txt", "json", "csv", "tsv"]
        }
      ]
    },
    {
      "id": "holidays",
      "emoji": "📆",
      "summary": "National, regional, and municipal holiday calendar nodes.",
      "example": "/api/holidays/io/events/summary.txt?country=BR&year=2026&lang=pt-BR&emoji=true",
      "nodes": [
        {
          "id": "events",
          "kind": "table",
          "columns": ["summary", "description", "startDateString", "uid"]
        },
        {
          "id": "events/summary",
          "kind": "column",
          "formats": ["txt", "json", "csv", "tsv"]
        }
      ]
    },
    {
      "id": "languages",
      "emoji": "\ud83d\udcac",
      "summary": "Daily lexical language entry calendar nodes.",
      "example": "/api/languages/io/events/summary.txt?language=en&set=100&lang=en&emoji=true",
      "nodes": [
        {
          "id": "events",
          "kind": "table",
          "columns": ["summary", "description", "startDateString", "contentLanguage", "uid"]
        },
        {
          "id": "events/summary",
          "kind": "column",
          "formats": ["txt", "json", "csv", "tsv"]
        }
      ]
    },
    {
      "id": "crypto",
      "emoji": "📈",
      "summary": "Cryptocurrency market calendar nodes.",
      "example": "/api/crypto/io/events/summary.txt?ids=bitcoin&vs=brl&lang=pt-BR&tz=-3&emoji=true",
      "nodes": [
        {
          "id": "events",
          "kind": "table",
          "columns": ["summary", "description", "startDateString", "uid"]
        },
        {
          "id": "events/summary",
          "kind": "column",
          "formats": ["txt", "json", "csv", "tsv"]
        }
      ]
    },
    {
      "id": "earnings",
      "emoji": "📊",
      "summary": "Company earnings calendar nodes.",
      "example": "/api/earnings/io/events/summary.txt?symbol=GOOGL&lang=en&emoji=true",
      "nodes": [
        {
          "id": "events",
          "kind": "table",
          "columns": ["summary", "description", "startDateString", "uid"]
        },
        {
          "id": "events/summary",
          "kind": "column",
          "formats": ["txt", "json", "csv", "tsv"]
        }
      ]
    },
    {
      "id": "sports",
      "emoji": "🏆",
      "summary": "Sports fixture and result calendar nodes.",
      "example": "/api/sports/io/events/summary.txt?sport=volleyball&mode=games&lang=en&emoji=true",
      "nodes": [
        {
          "id": "events",
          "kind": "table",
          "columns": ["summary", "description", "startDateString", "uid"]
        },
        {
          "id": "events/summary",
          "kind": "column",
          "formats": ["txt", "json", "csv", "tsv"]
        }
      ]
    }
  ]
}