{
 "openapi": "3.1.0",
 "info": {
  "title": "VINCAP",
  "version": "2026-11-02",
  "description": "The record of publicly traded wine companies: register editions, vineyard ownership and the investor calendar, paid per call in USDC over x402. Not investment advice.",
  "x-guidance": "VINCAP keeps the dated register of publicly traded wine companies, the vineyards and wineries they own, and their investor calendar. GET /api/paid/register-snapshots returns every register edition with what changed, /api/paid/estates the monthly estate-ownership record with its history chain, and /api/paid/calendar every results date, AGM and dividend with its recorded outcome; each is one call, paid per call over x402 (USDC on Base). The CSVs at https://vincap.co/data, the series API and the MCP server at https://vincap.co/api/mcp stay free.",
  "contact": {
   "email": "hello@vincap.co"
  }
 },
 "servers": [
  {
   "url": "https://vincap.co"
  }
 ],
 "x-x402": {
  "asset": "USDC",
  "network": "base",
  "manifest": "https://vincap.co/.well-known/x402"
 },
 "paths": {
  "/api/paid/register-snapshots": {
   "get": {
    "operationId": "registerSnapshots",
    "summary": "Listed wine companies list: every dated edition of the register of publicly traded wine stocks (ISIN, shares, wine share, sources) with what changed, in one call.",
    "description": "Listed wine companies list: every dated edition of the register of publicly traded wine stocks (ISIN, shares, wine share, sources) with what changed, in one call. Not investment advice.",
    "tags": [
     "wine",
     "companies",
     "stocks",
     "isin"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.05"
     },
     "protocols": [
      {
       "x402": {}
      }
     ]
    },
    "parameters": [],
    "responses": {
     "200": {
      "description": "The paid answer (JSON), after an x402 payment settles.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "as_of": {
           "type": "string"
          },
          "count": {
           "type": "integer"
          },
          "editions": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "date": {
              "type": "string"
             },
             "rows": {
              "type": "integer"
             },
             "added": {
              "type": "array"
             },
             "removed": {
              "type": "array"
             },
             "changed": {
              "type": "array"
             },
             "companies": {
              "type": "array",
              "items": {
               "type": "object",
               "properties": {
                "bc_id": {
                 "type": "string"
                },
                "name": {
                 "type": "string"
                },
                "isin": {
                 "type": "string"
                }
               }
              }
             }
            }
           }
          },
          "data_contract": {
           "type": "object",
           "properties": {
            "source": {
             "type": "array",
             "items": {
              "type": "object",
              "properties": {
               "name": {
                "type": "string"
               }
              }
             }
            },
            "as_of": {
             "type": "string"
            },
            "status": {
             "type": "string"
            }
           }
          }
         }
        },
        "example": {
         "as_of": "2026-10-17",
         "count": 9,
         "editions": [
          {
           "date": "2026-10-17",
           "rows": 83,
           "added": [],
           "removed": [],
           "changed": [],
           "companies": [
            {
             "bc_id": "BC-00001",
             "name": "Treasury Wine Estates",
             "isin": "AU000000TWE9"
            }
           ]
          }
         ],
         "data_contract": {
          "source": [
           {
            "name": "company filings and exchange notices"
           }
          ],
          "as_of": "2026-10-17",
          "status": "frozen"
         }
        }
       }
      }
     },
     "402": {
      "description": "Payment Required"
     }
    }
   }
  },
  "/api/paid/estates": {
   "get": {
    "operationId": "estates",
    "summary": "Which vineyards and wineries do listed wine companies own?",
    "description": "Which vineyards and wineries do listed wine companies own? Every monthly record of estates by owner, with hash-chained history and source probes, in one call. Not investment advice.",
    "tags": [
     "wine",
     "vineyards",
     "wineries",
     "ownership"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.05"
     },
     "protocols": [
      {
       "x402": {}
      }
     ]
    },
    "parameters": [],
    "responses": {
     "200": {
      "description": "The paid answer (JSON), after an x402 payment settles.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "as_of": {
           "type": "string"
          },
          "history": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "month": {
              "type": "string"
             },
             "entity_id": {
              "type": "string"
             },
             "status": {
              "type": "string"
             },
             "row_sha256": {
              "type": "string"
             }
            }
           }
          },
          "snapshots": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "month": {
              "type": "string"
             },
             "rows": {
              "type": "array",
              "items": {
               "type": "object",
               "properties": {
                "entity_id": {
                 "type": "string"
                },
                "company_symbol": {
                 "type": "string"
                },
                "stake_pct": {
                 "type": "string"
                }
               }
              }
             }
            }
           }
          },
          "data_contract": {
           "type": "object",
           "properties": {
            "status": {
             "type": "string"
            },
            "license": {
             "type": "object",
             "properties": {
              "clause": {
               "type": "string"
              }
             }
            }
           }
          }
         }
        },
        "example": {
         "as_of": "2026-10",
         "history": [
          {
           "month": "2026-10",
           "entity_id": "penfolds-magill-estate",
           "status": "owned",
           "row_sha256": "27b8…"
          }
         ],
         "snapshots": [
          {
           "month": "2026-10",
           "rows": [
            {
             "entity_id": "penfolds-magill-estate",
             "company_symbol": "TWE.AX",
             "stake_pct": "100"
            }
           ]
          }
         ],
         "data_contract": {
          "status": "frozen",
          "license": {
           "clause": "CC BY 4.0"
          }
         }
        }
       }
      }
     },
     "402": {
      "description": "Payment Required"
     }
    }
   }
  },
  "/api/paid/calendar": {
   "get": {
    "operationId": "calendar",
    "summary": "Wine stocks earnings calendar: every results date, AGM and dividend of listed wine companies (Treasury Wine Estates and more), sourced, with the recorded outcome, in one call.",
    "description": "Wine stocks earnings calendar: every results date, AGM and dividend of listed wine companies (Treasury Wine Estates and more), sourced, with the recorded outcome, in one call. Not investment advice.",
    "tags": [
     "wine",
     "earnings",
     "calendar",
     "stocks"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.01"
     },
     "protocols": [
      {
       "x402": {}
      }
     ]
    },
    "parameters": [],
    "responses": {
     "200": {
      "description": "The paid answer (JSON), after an x402 payment settles.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "as_of": {
           "type": "string"
          },
          "count": {
           "type": "integer"
          },
          "events": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "ticker": {
              "type": "string"
             },
             "event_type": {
              "type": "string"
             },
             "date": {
              "type": "string"
             },
             "status": {
              "type": "string"
             },
             "outcome": {
              "type": "string"
             }
            }
           }
          },
          "data_contract": {
           "type": "object",
           "properties": {
            "status": {
             "type": "string"
            }
           }
          }
         }
        },
        "example": {
         "as_of": "2026-10-16",
         "count": 120,
         "events": [
          {
           "ticker": "TWE.AX",
           "event_type": "results",
           "date": "2026-08-13",
           "status": "recorded",
           "outcome": "occurred-as-scheduled"
          }
         ],
         "data_contract": {
          "status": "published"
         }
        }
       }
      }
     },
     "402": {
      "description": "Payment Required"
     }
    }
   }
  }
 }
}