{
  "info": {
    "name": "0si.ai Disclosure API v1",
    "description": "Korean disclosures, US SEC filings, structured Delta, usage, realtime streams and signed webhooks. Pro keys use every request; trial keys (any signed-in account) can call REST reads only.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    {
      "key": "base_url",
      "value": "https://app.0si.ai/api/v1"
    },
    {
      "key": "api_key",
      "value": "osi_live_your_secret_key",
      "type": "secret"
    },
    {
      "key": "stock_code",
      "value": "005930"
    },
    {
      "key": "disclosure_id",
      "value": "kind:20260722000912"
    },
    {
      "key": "sec_ticker",
      "value": "AAPL"
    },
    {
      "key": "sec_accession_number",
      "value": "0000320193-26-000079"
    },
    {
      "key": "webhook_id",
      "value": "00000000-0000-0000-0000-000000000000"
    }
  ],
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{api_key}}",
        "type": "string"
      }
    ]
  },
  "item": [
    {
      "name": "Status and usage",
      "item": [
        {
          "name": "Status",
          "request": {
            "method": "GET",
            "url": "{{base_url}}/status"
          }
        },
        {
          "name": "Usage",
          "request": {
            "method": "GET",
            "url": "{{base_url}}/usage"
          }
        }
      ]
    },
    {
      "name": "Companies",
      "item": [
        {
          "name": "Search companies",
          "request": {
            "method": "GET",
            "url": "{{base_url}}/companies?q=삼성&market=KOSPI"
          }
        },
        {
          "name": "Company detail",
          "request": {
            "method": "GET",
            "url": "{{base_url}}/companies/{{stock_code}}"
          }
        },
        {
          "name": "Fundamental history",
          "request": {
            "method": "GET",
            "url": "{{base_url}}/companies/{{stock_code}}/fundamentals/history"
          }
        }
      ]
    },
    {
      "name": "Disclosures",
      "item": [
        {
          "name": "List disclosures",
          "request": {
            "method": "GET",
            "url": "{{base_url}}/disclosures?sentiment=very_positive&sentiment=positive&limit=50"
          }
        },
        {
          "name": "Watchlist disclosures",
          "request": {
            "method": "GET",
            "url": "{{base_url}}/disclosures?watchlist=true&limit=20"
          }
        },
        {
          "name": "Disclosure detail",
          "request": {
            "method": "GET",
            "url": "{{base_url}}/disclosures/{{disclosure_id}}"
          }
        },
        {
          "name": "Structured Delta",
          "request": {
            "method": "GET",
            "url": "{{base_url}}/disclosures/{{disclosure_id}}/delta"
          }
        },
        {
          "name": "Revision history",
          "request": {
            "method": "GET",
            "url": "{{base_url}}/disclosures/{{disclosure_id}}/revisions"
          }
        },
        {
          "name": "Market reaction",
          "request": {
            "method": "GET",
            "url": "{{base_url}}/disclosures/{{disclosure_id}}/market-reaction"
          }
        },
        {
          "name": "Realtime stream (filtered)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "text/event-stream"
              }
            ],
            "url": "{{base_url}}/stream?stock_code={{stock_code}}&sentiment=very_positive&sentiment=positive"
          }
        }
      ]
    },
    {
      "name": "US SEC filings",
      "item": [
        {
          "name": "Latest SEC filings",
          "request": {
            "method": "GET",
            "url": "{{base_url}}/sec/filings?limit=50"
          }
        },
        {
          "name": "Ticker filings",
          "request": {
            "method": "GET",
            "url": "{{base_url}}/sec/filings?ticker={{sec_ticker}}"
          }
        },
        {
          "name": "10-Q and 10-K only",
          "request": {
            "method": "GET",
            "url": "{{base_url}}/sec/filings?form=10-Q&form=10-K&periodic_only=true"
          }
        },
        {
          "name": "SEC filing detail",
          "request": {
            "method": "GET",
            "url": "{{base_url}}/sec/filings/{{sec_accession_number}}"
          }
        },
        {
          "name": "SEC periodic Delta",
          "request": {
            "method": "GET",
            "url": "{{base_url}}/sec/filings/{{sec_accession_number}}/delta"
          }
        },
        {
          "name": "SEC realtime stream",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "text/event-stream"
              }
            ],
            "url": "{{base_url}}/sec/stream?form=8-K&form=10-Q&form=10-K"
          }
        }
      ]
    },
    {
      "name": "Webhooks",
      "item": [
        {
          "name": "List webhooks",
          "request": {
            "method": "GET",
            "url": "{{base_url}}/webhooks"
          }
        },
        {
          "name": "Create webhook",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Watchlist positives\",\n  \"url\": \"https://example.com/hooks/osi\",\n  \"events\": [\n    \"disclosure.created\",\n    \"disclosure.updated\"\n  ],\n  \"markets\": [\n    \"KR\",\n    \"US\"\n  ],\n  \"sentiments\": [\n    \"very_positive\",\n    \"positive\"\n  ],\n  \"watchlist_only\": true\n}"
            },
            "url": "{{base_url}}/webhooks"
          }
        },
        {
          "name": "Update webhook",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"stock_codes\": [\n    \"005930\",\n    \"AAPL\"\n  ],\n  \"enabled\": true\n}"
            },
            "url": "{{base_url}}/webhooks/{{webhook_id}}"
          }
        },
        {
          "name": "Rotate signing secret",
          "request": {
            "method": "POST",
            "url": "{{base_url}}/webhooks/{{webhook_id}}/rotate-secret"
          }
        },
        {
          "name": "Delete webhook",
          "request": {
            "method": "DELETE",
            "url": "{{base_url}}/webhooks/{{webhook_id}}"
          }
        },
        {
          "name": "Test webhook",
          "request": {
            "method": "POST",
            "url": "{{base_url}}/webhooks/{{webhook_id}}/test"
          }
        },
        {
          "name": "Delivery history",
          "request": {
            "method": "GET",
            "url": "{{base_url}}/webhooks/{{webhook_id}}/deliveries"
          }
        }
      ]
    }
  ]
}