{"openapi":"3.1.0","info":{"title":"Payments Hot Intelligence API","version":"1.0.0","description":"Read-only, evidence-tiered intelligence for cross-border payments and payment companies.","contact":{"name":"Patrick Pan","email":"patrick20041219@gmail.com"}},"servers":[{"url":"https://pmthot.com"}],"paths":{"/api/agent/brief":{"get":{"operationId":"getDecisionBrief","summary":"Get a curated, evidence-linked operator or investor brief","parameters":[{"name":"locale","in":"query","schema":{"type":"string","enum":["en","zh"],"default":"en"}},{"name":"lens","in":"query","schema":{"type":"string","enum":["operator","investor"],"default":"operator"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":10,"default":5}}],"responses":{"200":{"description":"Decision-ready brief with editorial context and traceable evidence","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/items":{"get":{"operationId":"listSignals","summary":"List official items or the unified signal index","parameters":[{"name":"scope","in":"query","schema":{"type":"string","enum":["official","all"],"default":"official"}},{"name":"topic","in":"query","schema":{"type":"string","enum":["company","cross-border","payment-infrastructure","web3","ai-agent"]}},{"name":"query","in":"query","description":"Case-insensitive search across titles, summaries, companies, publishers, topics, and tags.","schema":{"type":"string","maxLength":120}},{"name":"origin","in":"query","schema":{"type":"string","enum":["official","external"]}},{"name":"tier","in":"query","schema":{"type":"string","enum":["A1","B1","B2"]}},{"name":"from","in":"query","description":"Inclusive publication-date floor.","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","description":"Inclusive publication-date ceiling.","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"full","in":"query","description":"Include full official Markdown when scope is official.","schema":{"type":"integer","enum":[0,1],"default":0}}],"responses":{"200":{"description":"Paginated signal collection","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignalCollection"}}}},"400":{"description":"Invalid filter"}}}},"/api/items/{id}/markdown":{"get":{"operationId":"getSignalMarkdown","summary":"Get one source record as Markdown","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"locale","in":"query","schema":{"type":"string","enum":["en","zh"],"default":"en"}}],"responses":{"200":{"description":"Evidence-linked Markdown","content":{"text/markdown":{"schema":{"type":"string"}}}},"404":{"description":"Signal not found"}}}},"/api/companies":{"get":{"operationId":"listCompanies","summary":"List monitored payment companies","responses":{"200":{"description":"Company collection","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/companies/{slug}":{"get":{"operationId":"getCompany","summary":"Get one company intelligence record","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Company intelligence","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Company not found"}}}}},"components":{"schemas":{"SignalCollection":{"type":"object","required":["generatedAt","count","page","limit","items"],"properties":{"generatedAt":{"type":"string","format":"date-time"},"count":{"type":"integer"},"page":{"type":"integer"},"limit":{"type":"integer"},"pageCount":{"type":"integer"},"hasMore":{"type":"boolean"},"items":{"type":"array","items":{"type":"object"}}}}}}}