{"openapi":"3.1.0","info":{"title":"Tibeb API","description":"Tibeb's API for code and AI tools: read-only research records and agent runs, one login per key. Every call carries `Authorization: Bearer tbk_…`; 120 calls a minute a key; every call is in the key's audit log. Human-readable docs: https://www.tibeb.trade/api-docs.html","version":"2026-11-04"},"servers":[{"url":"https://www.tibeb.trade"}],"paths":{"/v1/rates/curve":{"get":{"summary":"V1 Rates Curve","description":"The Treasury's par curve on a day (the newest on or before `date`):\nthe points, the zero and forward curves, the named forwards and the\nmeasures. Public-domain data; arithmetic in code.","operationId":"v1_rates_curve_v1_rates_curve_get","parameters":[{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response V1 Rates Curve V1 Rates Curve Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rates/bond":{"post":{"summary":"V1 Rates Bond","description":"A fixed-coupon bond: price ↔ yield, accrued, durations, convexity,\nDV01, yields to call, G-spread and Z-spread over the Treasury curve.","operationId":"v1_rates_bond_v1_rates_bond_post","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response V1 Rates Bond V1 Rates Bond Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rates/mm":{"post":{"summary":"V1 Rates Mm","description":"A bill's price, discount yield, bond-equivalent and money-market yields.","operationId":"v1_rates_mm_v1_rates_mm_post","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response V1 Rates Mm V1 Rates Mm Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/theses":{"get":{"summary":"V1 Theses","description":"The key's login's theses: question, resolve-by date, status, how many\nof the eight checks pass, the committee's number.","operationId":"v1_theses_v1_theses_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response V1 Theses V1 Theses Get"}}}}}}},"/v1/theses/{thesis_id}":{"get":{"summary":"V1 Thesis","description":"One thesis: the scenarios, each check, the evidence with its side\nand the page's own words, the dated events, and — once the gate is\nopen — the exposure.","operationId":"v1_thesis_v1_theses__thesis_id__get","parameters":[{"name":"thesis_id","in":"path","required":true,"schema":{"type":"string","title":"Thesis Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response V1 Thesis V1 Theses  Thesis Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tickers/{symbol}/filings":{"get":{"summary":"V1 Filings","description":"The company's ten latest filings, from the SEC's own list.","operationId":"v1_filings_v1_tickers__symbol__filings_get","parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string","title":"Symbol"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response V1 Filings V1 Tickers  Symbol  Filings Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/plans":{"get":{"summary":"V1 Plans","operationId":"v1_plans_v1_plans_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response V1 Plans V1 Plans Get"}}}}}}},"/v1/journal":{"get":{"summary":"V1 Journal","operationId":"v1_journal_v1_journal_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response V1 Journal V1 Journal Get"}}}}}}},"/mcp":{"post":{"summary":"Mcp","description":"The tools above, for an AI tool that speaks MCP: `initialize`,\n`tools/list`, `tools/call`; a notification gets 202 and no body.","operationId":"mcp_mcp_post","requestBody":{"content":{"application/json":{"schema":{"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agents":{"get":{"summary":"V1 Agents","operationId":"v1_agents_v1_agents_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response V1 Agents V1 Agents Get"}}}}}}},"/v1/agents/{agent}/runs":{"post":{"summary":"V1 Start Run","description":"Start an agent on a thesis: `{thesis, start_at?}` → the run, queued.\nEvery model call is booked to the key's login; research only.","operationId":"v1_start_run_v1_agents__agent__runs_post","parameters":[{"name":"agent","in":"path","required":true,"schema":{"type":"string","title":"Agent"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response V1 Start Run V1 Agents  Agent  Runs Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/runs":{"get":{"summary":"V1 Runs","operationId":"v1_runs_v1_runs_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response V1 Runs V1 Runs Get"}}}}}}},"/v1/runs/{run_id}":{"get":{"summary":"V1 Run","operationId":"v1_run_v1_runs__run_id__get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response V1 Run V1 Runs  Run Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/runs/{run_id}/events":{"get":{"summary":"V1 Run Events","description":"Server-sent events: the run each time a step changes, until it ends.","operationId":"v1_run_events_v1_runs__run_id__events_get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/runs/{run_id}/approve":{"post":{"summary":"V1 Run Approve","description":"Approve a waiting run, or answer the question its step asked:\n`{answer: {choice, fields?, url?}}`.","operationId":"v1_run_approve_v1_runs__run_id__approve_post","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response V1 Run Approve V1 Runs  Run Id  Approve Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/runs/{run_id}/cancel":{"post":{"summary":"V1 Run Cancel","operationId":"v1_run_cancel_v1_runs__run_id__cancel_post","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response V1 Run Cancel V1 Runs  Run Id  Cancel Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/runs/{run_id}/steps/{step}/rerun":{"post":{"summary":"V1 Run Rerun","description":"A new run of the same agent on the same thesis, from step `step` on.","operationId":"v1_run_rerun_v1_runs__run_id__steps__step__rerun_post","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}},{"name":"step","in":"path","required":true,"schema":{"type":"integer","title":"Step"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response V1 Run Rerun V1 Runs  Run Id  Steps  Step  Rerun Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/webhooks":{"get":{"summary":"V1 Hooks","operationId":"v1_hooks_v1_webhooks_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response V1 Hooks V1 Webhooks Get"}}}}}},"post":{"summary":"V1 Hook Add","description":"`{url, events?}`: POSTs the run to an https address when it ends or waits.","operationId":"v1_hook_add_v1_webhooks_post","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response V1 Hook Add V1 Webhooks Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/webhooks/{hook_id}":{"delete":{"summary":"V1 Hook Drop","operationId":"v1_hook_drop_v1_webhooks__hook_id__delete","parameters":[{"name":"hook_id","in":"path","required":true,"schema":{"type":"string","title":"Hook Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response V1 Hook Drop V1 Webhooks  Hook Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pe/lbo/prefill":{"get":{"summary":"V1 Pe Prefill","description":"A filer's base-year figures from the SEC's XBRL, each with its source.","operationId":"v1_pe_prefill_v1_pe_lbo_prefill_get","parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string","default":"","title":"Symbol"}},{"name":"cik","in":"query","required":false,"schema":{"type":"string","default":"","title":"Cik"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response V1 Pe Prefill V1 Pe Lbo Prefill Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pe/lbo":{"post":{"summary":"V1 Pe Lbo","description":"The LBO model, as `/api/pe/lbo`. No model call.","operationId":"v1_pe_lbo_v1_pe_lbo_post","requestBody":{"content":{"application/json":{"schema":{"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response V1 Pe Lbo V1 Pe Lbo Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pe/lbo.xlsx":{"post":{"summary":"V1 Pe Lbo Xlsx","description":"The LBO as an Excel workbook of live formulas.","operationId":"v1_pe_lbo_xlsx_v1_pe_lbo_xlsx_post","requestBody":{"content":{"application/json":{"schema":{"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pe/ic-memo":{"post":{"summary":"V1 Pe Ic Memo","description":"The IC memo, as `/api/pe/ic-memo`; the model call is booked to the key's login.","operationId":"v1_pe_ic_memo_v1_pe_ic_memo_post","parameters":[{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"json","title":"Format"}}],"requestBody":{"content":{"application/json":{"schema":{"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pe/prefill":{"get":{"summary":"V1 Pe Wide Prefill","description":"A filer's three statements from the SEC's XBRL, each line with its source, and the base case they suggest.","operationId":"v1_pe_wide_prefill_v1_pe_prefill_get","parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string","default":"","title":"Symbol"}},{"name":"cik","in":"query","required":false,"schema":{"type":"string","default":"","title":"Cik"}},{"name":"what","in":"query","required":false,"schema":{"type":"string","default":"statements","title":"What"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response V1 Pe Wide Prefill V1 Pe Prefill Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pe/three-statement":{"post":{"summary":"V1 Pe Three Statement","description":"The three statement model, as `/api/pe/three-statement`. No model call.","operationId":"v1_pe_three_statement_v1_pe_three_statement_post","requestBody":{"content":{"application/json":{"schema":{"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pe/three-statement.xlsx":{"post":{"summary":"V1 Pe Three Statement Xlsx","description":"The three statement model as a workbook of live formulas, as `/api/pe/three-statement.xlsx`. No model call.","operationId":"v1_pe_three_statement_xlsx_v1_pe_three_statement_xlsx_post","requestBody":{"content":{"application/json":{"schema":{"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pe/dcf":{"post":{"summary":"V1 Pe Dcf","description":"The dcf model, as `/api/pe/dcf`. No model call.","operationId":"v1_pe_dcf_v1_pe_dcf_post","requestBody":{"content":{"application/json":{"schema":{"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pe/dcf.xlsx":{"post":{"summary":"V1 Pe Dcf Xlsx","description":"The dcf model as a workbook of live formulas, as `/api/pe/dcf.xlsx`. No model call.","operationId":"v1_pe_dcf_xlsx_v1_pe_dcf_xlsx_post","requestBody":{"content":{"application/json":{"schema":{"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pe/comps":{"post":{"summary":"V1 Pe Comps","description":"The comps model, as `/api/pe/comps`. No model call.","operationId":"v1_pe_comps_v1_pe_comps_post","requestBody":{"content":{"application/json":{"schema":{"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pe/comps.xlsx":{"post":{"summary":"V1 Pe Comps Xlsx","description":"The comps model as a workbook of live formulas, as `/api/pe/comps.xlsx`. No model call.","operationId":"v1_pe_comps_xlsx_v1_pe_comps_xlsx_post","requestBody":{"content":{"application/json":{"schema":{"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pe/deal-comps":{"post":{"summary":"V1 Pe Deal Comps","description":"The deal comps model, as `/api/pe/deal-comps`. No model call.","operationId":"v1_pe_deal_comps_v1_pe_deal_comps_post","requestBody":{"content":{"application/json":{"schema":{"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pe/deal-comps.xlsx":{"post":{"summary":"V1 Pe Deal Comps Xlsx","description":"The deal comps model as a workbook of live formulas, as `/api/pe/deal-comps.xlsx`. No model call.","operationId":"v1_pe_deal_comps_xlsx_v1_pe_deal_comps_xlsx_post","requestBody":{"content":{"application/json":{"schema":{"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pe/merger":{"post":{"summary":"V1 Pe Merger","description":"The merger model, as `/api/pe/merger`. No model call.","operationId":"v1_pe_merger_v1_pe_merger_post","requestBody":{"content":{"application/json":{"schema":{"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pe/merger.xlsx":{"post":{"summary":"V1 Pe Merger Xlsx","description":"The merger model as a workbook of live formulas, as `/api/pe/merger.xlsx`. No model call.","operationId":"v1_pe_merger_xlsx_v1_pe_merger_xlsx_post","requestBody":{"content":{"application/json":{"schema":{"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"An API key a signed-in account makes under Tools → API keys: tbk_…"}}},"security":[{"apiKey":[]}]}