{
 "openapi": "3.1.0",
 "info": {
  "title": "cz.wiki public data",
  "version": "1.0.0",
  "description": "cz.wiki is an unofficial, English-primary, source-backed encyclopedia and near-real-time tracker about Changpeng Zhao (CZ), co-founder and former CEO of Binance. Every factual statement carries a numbered reference with the original link; The article text itself is written by an AI (Grok Bot) from the cited sources and every page says so, with date and provisional status. 19 languages (18 are AI translations of the English text). Unofficial third-party site, not affiliated with Changpeng Zhao or Binance. Live items are UNVERIFIED. Human overview: https://cz.wiki/ai. Agent skill: https://cz.wiki/SKILL.md.",
  "contact": {
   "email": "hello@cz.wiki",
   "url": "https://cz.wiki/ai"
  },
  "license": {
   "name": "Attribution required; see /editorial",
   "url": "https://cz.wiki/editorial"
  }
 },
 "servers": [
  {
   "url": "https://cz.wiki"
  }
 ],
 "paths": {
  "/api/live.json": {
   "get": {
    "summary": "Latest collected items (unverified)",
    "operationId": "getLive",
    "parameters": [
     {
      "name": "since",
      "in": "query",
      "required": false,
      "description": "Only items first collected after this ISO 8601 time",
      "schema": {
       "type": "string",
       "format": "date-time"
      }
     },
     {
      "name": "until",
      "in": "query",
      "required": false,
      "description": "Only items published before this ISO 8601 time",
      "schema": {
       "type": "string",
       "format": "date-time"
      }
     },
     {
      "name": "limit",
      "in": "query",
      "required": false,
      "description": "1-200, default 60",
      "schema": {
       "type": "integer",
       "minimum": 1,
       "maximum": 200
      }
     },
     {
      "name": "type",
      "in": "query",
      "required": false,
      "description": "Item type, e.g. news, court, announcement, tweet, podcast, regulatory, official, other",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "label",
      "in": "query",
      "required": false,
      "description": "attributed = posts by a named account on X (a normal source); unverified = everything else",
      "schema": {
       "type": "string",
       "enum": [
        "attributed",
        "unverified"
       ]
      }
     },
     {
      "name": "status",
      "in": "query",
      "required": false,
      "description": "Verification status",
      "schema": {
       "type": "string",
       "enum": [
        "unverified",
        "verified"
       ]
      }
     },
     {
      "name": "language",
      "in": "query",
      "required": false,
      "description": "Source language code (filter)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "lang",
      "in": "query",
      "required": false,
      "description": "Display language (one of the 19 locale codes): adds title_i18n / summary_i18n machine translations",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "headers": {
       "Access-Control-Allow-Origin": {
        "schema": {
         "type": "string"
        },
        "description": "*"
       }
      },
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/LiveResponse"
        }
       }
      }
     }
    }
   }
  },
  "/feed/live.xml": {
   "get": {
    "summary": "Atom feed of live items (unverified)",
    "operationId": "getLiveAtom",
    "responses": {
     "200": {
      "description": "OK",
      "headers": {
       "Access-Control-Allow-Origin": {
        "schema": {
         "type": "string"
        },
        "description": "*"
       }
      },
      "content": {
       "application/atom+xml": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  },
  "/feed/live.json": {
   "get": {
    "summary": "JSON Feed of live items (unverified)",
    "operationId": "getLiveJsonFeed",
    "responses": {
     "200": {
      "description": "OK",
      "headers": {
       "Access-Control-Allow-Origin": {
        "schema": {
         "type": "string"
        },
        "description": "*"
       }
      },
      "content": {
       "application/feed+json": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  },
  "/api/articles.json": {
   "get": {
    "summary": "Index of articles",
    "operationId": "listArticles",
    "responses": {
     "200": {
      "description": "OK",
      "headers": {
       "Access-Control-Allow-Origin": {
        "schema": {
         "type": "string"
        },
        "description": "*"
       }
      },
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/ArticleIndex"
        }
       }
      }
     }
    }
   }
  },
  "/api/articles/{slug}.json": {
   "get": {
    "summary": "One article as JSON",
    "operationId": "getArticle",
    "parameters": [
     {
      "name": "slug",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string",
       "enum": [
        "binance",
        "binance-2023-resolution",
        "bnb-chain",
        "bnb-standard",
        "changpeng-zhao",
        "editorial",
        "freedom-of-money",
        "giggle-academy",
        "he-yi",
        "legal-affairs",
        "pardon-of-changpeng-zhao",
        "public-reception",
        "quotes",
        "richard-teng",
        "sec-v-binance",
        "timeline",
        "united-states-v-zhao",
        "yzi-labs",
        "yzi-labs-rebrand"
       ]
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "headers": {
       "Access-Control-Allow-Origin": {
        "schema": {
         "type": "string"
        },
        "description": "*"
       }
      },
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Article"
        }
       }
      }
     }
    }
   }
  },
  "/wiki/{slug}.md": {
   "get": {
    "summary": "One article as Markdown (pages: /{slug}.md)",
    "operationId": "getArticleMarkdown",
    "parameters": [
     {
      "name": "slug",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string",
       "enum": [
        "binance",
        "binance-2023-resolution",
        "bnb-chain",
        "bnb-standard",
        "changpeng-zhao",
        "freedom-of-money",
        "giggle-academy",
        "he-yi",
        "legal-affairs",
        "pardon-of-changpeng-zhao",
        "public-reception",
        "richard-teng",
        "sec-v-binance",
        "united-states-v-zhao",
        "yzi-labs",
        "yzi-labs-rebrand"
       ]
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "headers": {
       "Access-Control-Allow-Origin": {
        "schema": {
         "type": "string"
        },
        "description": "*"
       }
      },
      "content": {
       "text/markdown": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  },
  "/feed/changes.xml": {
   "get": {
    "summary": "Atom feed of article changes",
    "operationId": "getChangesAtom",
    "responses": {
     "200": {
      "description": "OK",
      "headers": {
       "Access-Control-Allow-Origin": {
        "schema": {
         "type": "string"
        },
        "description": "*"
       }
      },
      "content": {
       "application/atom+xml": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  },
  "/feed/changes.json": {
   "get": {
    "summary": "JSON Feed of article changes",
    "operationId": "getChangesJsonFeed",
    "responses": {
     "200": {
      "description": "OK",
      "headers": {
       "Access-Control-Allow-Origin": {
        "schema": {
         "type": "string"
        },
        "description": "*"
       }
      },
      "content": {
       "application/feed+json": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  },
  "/feed.xml": {
   "get": {
    "summary": "Atom feed of reviewed items",
    "operationId": "getReviewedAtom",
    "responses": {
     "200": {
      "description": "OK",
      "headers": {
       "Access-Control-Allow-Origin": {
        "schema": {
         "type": "string"
        },
        "description": "*"
       }
      },
      "content": {
       "application/atom+xml": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  },
  "/llms.txt": {
   "get": {
    "summary": "llms.txt index",
    "operationId": "getLlmsTxt",
    "responses": {
     "200": {
      "description": "OK",
      "headers": {
       "Access-Control-Allow-Origin": {
        "schema": {
         "type": "string"
        },
        "description": "*"
       }
      },
      "content": {
       "text/plain": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  },
  "/llms-full.txt": {
   "get": {
    "summary": "Full English text for LLMs",
    "operationId": "getLlmsFull",
    "responses": {
     "200": {
      "description": "OK",
      "headers": {
       "Access-Control-Allow-Origin": {
        "schema": {
         "type": "string"
        },
        "description": "*"
       }
      },
      "content": {
       "text/plain": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  },
  "/SKILL.md": {
   "get": {
    "summary": "Agent Skill",
    "operationId": "getSkill",
    "responses": {
     "200": {
      "description": "OK",
      "headers": {
       "Access-Control-Allow-Origin": {
        "schema": {
         "type": "string"
        },
        "description": "*"
       }
      },
      "content": {
       "text/markdown": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  },
  "/sitemap.xml": {
   "get": {
    "summary": "Sitemap",
    "operationId": "getSitemap",
    "responses": {
     "200": {
      "description": "OK",
      "headers": {
       "Access-Control-Allow-Origin": {
        "schema": {
         "type": "string"
        },
        "description": "*"
       }
      },
      "content": {
       "application/xml": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  },
  "/api/featured.json": {
   "get": {
    "summary": "Featured / In depth stories",
    "operationId": "listFeatured",
    "parameters": [
     {
      "name": "active",
      "in": "query",
      "required": false,
      "description": "1 = only stories currently featured on the homepage",
      "schema": {
       "type": "string",
       "enum": [
        "1",
        "true"
       ]
      }
     },
     {
      "name": "status",
      "in": "query",
      "required": false,
      "description": "Verification status",
      "schema": {
       "type": "string",
       "enum": [
        "verified",
        "partially_verified",
        "unverified_claim",
        "attributed_claim"
       ]
      }
     },
     {
      "name": "slug",
      "in": "query",
      "required": false,
      "description": "One story by slug",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "since",
      "in": "query",
      "required": false,
      "description": "Only stories updated after this ISO 8601 time",
      "schema": {
       "type": "string",
       "format": "date-time"
      }
     },
     {
      "name": "limit",
      "in": "query",
      "required": false,
      "description": "1-200, default 50",
      "schema": {
       "type": "integer",
       "minimum": 1,
       "maximum": 200
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "headers": {
       "Access-Control-Allow-Origin": {
        "schema": {
         "type": "string"
        },
        "description": "*"
       }
      },
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/FeaturedResponse"
        }
       }
      }
     }
    }
   }
  },
  "/api/featured/{slug}.json": {
   "get": {
    "summary": "One featured story",
    "operationId": "getFeatured",
    "parameters": [
     {
      "name": "slug",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "headers": {
       "Access-Control-Allow-Origin": {
        "schema": {
         "type": "string"
        },
        "description": "*"
       }
      },
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/FeaturedStory"
        }
       }
      }
     },
     "404": {
      "description": "Not found"
     }
    }
   }
  },
  "/feed/featured.xml": {
   "get": {
    "summary": "Atom feed of featured stories",
    "operationId": "getFeaturedAtom",
    "responses": {
     "200": {
      "description": "OK",
      "headers": {
       "Access-Control-Allow-Origin": {
        "schema": {
         "type": "string"
        },
        "description": "*"
       }
      },
      "content": {
       "application/atom+xml": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  },
  "/feed/featured.json": {
   "get": {
    "summary": "JSON Feed of featured stories",
    "operationId": "getFeaturedJsonFeed",
    "responses": {
     "200": {
      "description": "OK",
      "headers": {
       "Access-Control-Allow-Origin": {
        "schema": {
         "type": "string"
        },
        "description": "*"
       }
      },
      "content": {
       "application/feed+json": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  },
  "/ai": {
   "get": {
    "summary": "For AI & developers (human-readable overview of all endpoints)",
    "operationId": "getDevelopers",
    "responses": {
     "200": {
      "description": "OK",
      "headers": {
       "Access-Control-Allow-Origin": {
        "schema": {
         "type": "string"
        },
        "description": "*"
       }
      },
      "content": {
       "text/html": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  }
 },
 "components": {
  "schemas": {
   "LiveItem": {
    "type": "object",
    "required": [
     "id",
     "type",
     "title",
     "url",
     "status"
    ],
    "properties": {
     "id": {
      "type": "string"
     },
     "source_id": {
      "type": "string"
     },
     "type": {
      "type": "string"
     },
     "title": {
      "type": "string",
      "description": "Original language"
     },
     "url": {
      "type": "string",
      "format": "uri",
      "description": "Original source URL"
     },
     "url_kind": {
      "type": "string",
      "enum": [
       "direct",
       "aggregator"
      ]
     },
     "publisher": {
      "type": [
       "string",
       "null"
      ]
     },
     "language": {
      "type": [
       "string",
       "null"
      ]
     },
     "published_at": {
      "type": [
       "string",
       "null"
      ],
      "format": "date-time"
     },
     "published_precision": {
      "type": [
       "string",
       "null"
      ],
      "enum": [
       "time",
       "day",
       null
      ]
     },
     "collected_at": {
      "type": "string",
      "format": "date-time"
     },
     "excerpt": {
      "type": [
       "string",
       "null"
      ],
      "description": "Verbatim source excerpt"
     },
     "status": {
      "type": "string",
      "enum": [
       "unverified",
       "verified"
      ],
      "description": "unverified = only means a source published it"
     },
     "label": {
      "type": "string",
      "enum": [
       "attributed",
       "unverified"
      ],
      "description": "attributed = a post by a named account (shown with a subtle \"via X\" tag and a source line, no unverified badge)"
     },
     "attribution": {
      "oneOf": [
       {
        "type": "null"
       },
       {
        "$ref": "#/components/schemas/Attribution"
       }
      ],
      "description": "Who published it, when label = attributed"
     },
     "archive_url": {
      "type": [
       "string",
       "null"
      ]
     },
     "existing_snapshot_url": {
      "type": [
       "string",
       "null"
      ]
     },
     "title_i18n": {
      "type": [
       "object",
       "null"
      ],
      "description": "Only with ?lang=. Machine translation of the title {lang, text, machine_translated, model}; null when none yet or the item is already in that language"
     },
     "summary_i18n": {
      "type": [
       "object",
       "null"
      ],
      "description": "Only with ?lang=. Machine translation of the excerpt (notable items only)"
     },
     "title_en": {
      "type": [
       "string",
       "null"
      ],
      "description": "AI machine translation of title; see ai_model/ai_at"
     },
     "ai_model": {
      "type": [
       "string",
       "null"
      ]
     },
     "ai_at": {
      "type": [
       "string",
       "null"
      ]
     }
    }
   },
   "LiveResponse": {
    "type": "object",
    "properties": {
     "generated_at": {
      "type": "string",
      "format": "date-time"
     },
     "count": {
      "type": "integer"
     },
     "latest_collected_at": {
      "type": [
       "string",
       "null"
      ]
     },
     "unverified": {
      "type": "boolean"
     },
     "notice": {
      "type": "string"
     },
     "items": {
      "type": "array",
      "items": {
       "$ref": "#/components/schemas/LiveItem"
      }
     }
    }
   },
   "Attribution": {
    "type": "object",
    "required": [
     "platform",
     "handle"
    ],
    "properties": {
     "platform": {
      "type": "string",
      "enum": [
       "x"
      ]
     },
     "handle": {
      "type": "string"
     },
     "display_name": {
      "type": [
       "string",
       "null"
      ]
     }
    }
   },
   "FeaturedSource": {
    "type": "object",
    "required": [
     "title",
     "url"
    ],
    "properties": {
     "title": {
      "type": "string"
     },
     "url": {
      "type": "string",
      "format": "uri"
     },
     "publisher": {
      "type": [
       "string",
       "null"
      ]
     },
     "date": {
      "type": [
       "string",
       "null"
      ]
     }
    }
   },
   "AiLabel": {
    "type": "object",
    "required": [
     "model",
     "provisional"
    ],
    "properties": {
     "model": {
      "type": "string"
     },
     "based_on_sources": {
      "type": "array",
      "items": {
       "type": "string",
       "format": "uri"
      }
     },
     "generated_at": {
      "type": [
       "string",
       "null"
      ],
      "format": "date-time"
     },
     "provisional": {
      "type": "boolean"
     }
    }
   },
   "FeaturedStory": {
    "type": "object",
    "required": [
     "slug",
     "url",
     "headline",
     "dek",
     "verification_status",
     "sources",
     "featured_from",
     "updated_at"
    ],
    "properties": {
     "slug": {
      "type": "string"
     },
     "url": {
      "type": "string",
      "format": "uri"
     },
     "headline": {
      "type": "string"
     },
     "dek": {
      "type": "string"
     },
     "body_md": {
      "type": [
       "string",
       "null"
      ]
     },
     "verification_status": {
      "type": "string",
      "enum": [
       "verified",
       "partially_verified",
       "unverified_claim",
       "attributed_claim"
      ],
      "description": "attributed_claim = stated by a named person, account or publication; we report what the source says"
     },
     "sources": {
      "type": "array",
      "minItems": 1,
      "items": {
       "$ref": "#/components/schemas/FeaturedSource"
      }
     },
     "related_articles": {
      "type": "array",
      "items": {
       "type": "object"
      }
     },
     "ai_label": {
      "oneOf": [
       {
        "type": "null"
       },
       {
        "$ref": "#/components/schemas/AiLabel"
       }
      ]
     },
     "featured_from": {
      "type": "string",
      "format": "date-time"
     },
     "featured_until": {
      "type": [
       "string",
       "null"
      ],
      "format": "date-time"
     },
     "active": {
      "type": "boolean"
     },
     "priority": {
      "type": "integer"
     },
     "created_at": {
      "type": [
       "string",
       "null"
      ]
     },
     "updated_at": {
      "type": "string",
      "format": "date-time"
     },
     "language": {
      "type": "string"
     },
     "notice": {
      "type": "string"
     }
    }
   },
   "FeaturedResponse": {
    "type": "object",
    "properties": {
     "generated_at": {
      "type": "string",
      "format": "date-time"
     },
     "count": {
      "type": "integer"
     },
     "latest_updated_at": {
      "type": [
       "string",
       "null"
      ]
     },
     "notice": {
      "type": "string"
     },
     "stories": {
      "type": "array",
      "items": {
       "$ref": "#/components/schemas/FeaturedStory"
      }
     }
    }
   },
   "ArticleIndex": {
    "type": "object",
    "properties": {
     "count": {
      "type": "integer"
     },
     "date_modified": {
      "type": "string"
     },
     "articles": {
      "type": "array",
      "items": {
       "type": "object"
      }
     },
     "pages": {
      "type": "array",
      "items": {
       "type": "object"
      }
     }
    }
   },
   "Reference": {
    "type": "object",
    "properties": {
     "n": {
      "type": "integer"
     },
     "id": {
      "type": "string"
     },
     "title": {
      "type": "string"
     },
     "publisher": {
      "type": "string"
     },
     "date": {
      "type": "string"
     },
     "url": {
      "type": "string",
      "format": "uri"
     },
     "note": {
      "type": [
       "string",
       "null"
      ]
     }
    }
   },
   "Article": {
    "type": "object",
    "properties": {
     "slug": {
      "type": "string"
     },
     "title": {
      "type": "string"
     },
     "summary": {
      "type": "string"
     },
     "url": {
      "type": "string"
     },
     "date_published": {
      "type": "string"
     },
     "date_modified": {
      "type": "string"
     },
     "markdown": {
      "type": "string"
     },
     "ai_content": {
      "type": "object",
      "description": "Provenance of the English text: written_by (the AI), based_on, first_written, last_revised, provisional, human_reviewed, translations",
      "properties": {
       "written_by": {
        "type": "string"
       },
       "role": {
        "type": "string"
       },
       "based_on": {
        "type": "string"
       },
       "first_written": {
        "type": "string",
        "format": "date"
       },
       "last_revised": {
        "type": "string",
        "format": "date"
       },
       "timezone": {
        "type": "string"
       },
       "provisional": {
        "type": "boolean"
       },
       "human_reviewed": {
        "type": "boolean"
       },
       "translations": {
        "type": "string"
       }
      }
     },
     "what_links_here": {
      "type": "array",
      "description": "Other articles and pages that link to this one",
      "items": {
       "type": "object",
       "properties": {
        "slug": {
         "type": "string"
        },
        "title": {
         "type": "string"
        },
        "url": {
         "type": "string"
        }
       }
      }
     },
     "sections": {
      "type": "array",
      "items": {
       "type": "object"
      }
     },
     "references": {
      "type": "array",
      "items": {
       "$ref": "#/components/schemas/Reference"
      }
     },
     "history": {
      "type": "array",
      "items": {
       "type": "object"
      }
     }
    }
   }
  }
 }
}