{"openapi":"3.0.1","info":{"title":"koreafilings API","description":"Commercial API that serves AI-generated English summaries of\nKorean DART (금융감독원 전자공시) corporate disclosures.\n\nEvery paid endpoint settles on-chain in USDC via the\n[x402](https://www.x402.org/) payment protocol. The first\ncall for a disclosure triggers an LLM run; every subsequent\ncall for the same receipt number is served from a shared\ncache for the same price, so the marginal cost to the\noperator approaches zero as adoption grows.\n\n**No API keys. No signup. No monthly fees.** The wallet\nthat signs an `X-PAYMENT` header *is* the identity.\n","contact":{"name":"korea-filings-api","url":"https://github.com/OldTemple91/korea-filings-api","email":"oldtemple9106@gmail.com"},"license":{"name":"MIT","url":"https://github.com/OldTemple91/korea-filings-api/blob/main/LICENSE"},"version":"0.0.1"},"servers":[{"url":"https://api.koreafilings.com","description":"Production"},{"url":"http://localhost:8080","description":"Local development"}],"security":[{"x402Payment":[]}],"tags":[{"name":"Public","description":"Free, unpaid endpoints for service discovery and pricing."},{"name":"Discovery","description":"Well-known discovery documents for x402 indexers."},{"name":"Disclosures","description":"Paid DART disclosure intelligence endpoints."}],"paths":{"/v1/pricing":{"get":{"tags":["Public"],"summary":"Current pricing and x402 wallet configuration","description":"Machine-readable descriptor of every paid endpoint and\nits USDC price. Also carries the x402 recipient wallet,\nCAIP-2 network id, and USDC contract address so clients\ncan verify they are paying the right destination on the\nright chain before signing.\n\nSafe to call as often as desired — no payment, no rate\nlimiting beyond the standard anti-abuse layer.\n","operationId":"pricing","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PricingResponse"}}}}},"security":[]}},"/v1/disclosures/{rcptNo}/summary":{"get":{"tags":["Disclosures"],"summary":"Get an AI-generated English summary of a DART disclosure","description":"Costs **0.005 USDC** on Base, settled via x402. Returns a\nparaphrased English summary, a 1–10 importance score,\nthe canonical event type, and ticker / sector / audience\ntags. The summary is generated once per receipt number\nand served from cache thereafter — the price does not\nchange between cold and warm calls, but the LLM cost is\nonly paid by the first caller globally.\n","operationId":"getSummary","parameters":[{"name":"rcptNo","in":"path","description":"14-digit DART receipt number, e.g. `20260424900874`","required":true,"schema":{"type":"string"},"example":20260424900874}],"responses":{"404":{"description":"Unknown receipt number — the DART filing has not been ingested yet."},"200":{"description":"Payment accepted; summary returned.","content":{"*/*":{"schema":{"$ref":"#/components/schemas/DisclosureSummaryDto"}}}},"402":{"description":"Payment required — body carries the x402 `accepts` block with wallet, network, amount, and expiry.","content":{"application/json":{}}}}}},"/.well-known/x402":{"get":{"tags":["Discovery"],"summary":"x402 service discovery document","description":"Lists every paid endpoint this service exposes in the format\nexpected by x402 ecosystem indexers (x402scan, etc.). Each\npaid endpoint appears twice — once as a path template and\nonce as a concrete known-good sample URL — so an indexer\ncan verify the runtime 402 response without guessing path\nparameters.\n","operationId":"discoveryDocument","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}}},"security":[]}}},"components":{"schemas":{"PaidEndpoint":{"type":"object","properties":{"method":{"type":"string"},"path":{"type":"string"},"priceUsdc":{"type":"string"},"description":{"type":"string"}}},"PricingResponse":{"type":"object","properties":{"x402Network":{"type":"string"},"x402Asset":{"type":"string"},"x402Recipient":{"type":"string"},"endpoints":{"type":"array","items":{"$ref":"#/components/schemas/PaidEndpoint"}}}},"DisclosureSummaryDto":{"type":"object","properties":{"rcptNo":{"type":"string"},"summaryEn":{"type":"string"},"importanceScore":{"type":"integer","format":"int32"},"eventType":{"type":"string"},"sectorTags":{"type":"array","items":{"type":"string"}},"tickerTags":{"type":"array","items":{"type":"string"}},"actionableFor":{"type":"array","items":{"type":"string"}},"generatedAt":{"type":"string","format":"date-time"}}}},"securitySchemes":{"x402Payment":{"type":"apiKey","description":"Base64-encoded signed x402 payment payload. When the\nheader is absent or invalid, the server replies 402\nwith an `accepts` block describing the required\namount, USDC contract, network, recipient, and\nexpiry. Sign an EIP-3009 TransferWithAuthorization\nfor those parameters and re-send the same request\nwith this header set.\n\nSee https://www.x402.org/ for the protocol spec and\nhttps://github.com/OldTemple91/korea-filings-api for\nthe reference Python SDK.\n","name":"X-PAYMENT","in":"header"}}}}