{"openapi":"3.1.0","info":{"title":"Bimini Sonar — Agent Data API","version":"1.0.0","description":"Daily forward-looking market assessment — Tailwind, Headwind or Crosswind — with a transparent chain of reasoning, plus the economic events and central-bank transcripts behind it. Paid per call over the Machine Payments Protocol. No account, no API key, no subscription.","x-guidance":"Browse GET /api/data/briefs (free) to see the published briefs, then buy a body with GET /api/data/briefs/{external_id}. Use GET /api/data/economic-events for dated economic releases and GET /api/data/transcripts for central-bank speeches and testimony; both carry a directional assessment and supporting analysis. Every call is priced the same regardless of rows returned, so narrow with the from/to/search filters rather than paging. Requesting a paid endpoint returns 402 with a WWW-Authenticate: Payment challenge; pay it and retry with Authorization: Payment to receive the data and a Payment-Receipt header.","contact":{"url":"https://sonar.bimini.one/agents","email":"api@bimini.one"}},"servers":[{"url":"https://sonar.bimini.one"}],"paths":{"/api/data":{"get":{"operationId":"discoveryManifest","summary":"Discovery manifest — endpoints, live prices and return shapes","tags":["Discovery"],"security":[],"responses":{"200":{"description":"Service manifest","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/data/briefs":{"get":{"operationId":"listBriefs","summary":"Brief catalogue — free","tags":["Briefs"],"security":[],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Published briefs","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/data/briefs/{external_id}":{"get":{"operationId":"getBrief","summary":"Full daily intelligence brief body","tags":["Briefs"],"x-payment-info":{"offers":[{"amount":"6330000","currency":"usd","description":"Full daily intelligence brief body","intent":"charge","method":"stripe"}]},"parameters":[{"name":"external_id","in":"path","required":true,"schema":{"type":"string"},"description":"From the free catalogue"},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["md","text","html"],"default":"md"}}],"responses":{"200":{"description":"Brief body","content":{"application/json":{"schema":{"type":"object","properties":{"external_id":{"type":"string"},"title":{"type":"string"},"brief_date":{"type":"string"},"summary":{"type":"string"},"markdown":{"type":"string"}}}}}},"402":{"description":"Payment Required"}}}},"/api/data/economic-events":{"get":{"operationId":"listEconomicEvents","summary":"Economic releases with a directional assessment and supporting analysis","tags":["Economic events"],"x-payment-info":{"offers":[{"amount":"1000000","currency":"usd","description":"Economic releases with a directional assessment","intent":"charge","method":"stripe"}]},"parameters":[{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"ISO date — earliest item to return"},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"ISO date — latest item to return"},{"name":"region","in":"query","required":false,"schema":{"type":"string"},"description":"Region code, e.g. US"},{"name":"search","in":"query","required":false,"schema":{"type":"string"},"description":"Title contains"},{"name":"importance","in":"query","required":false,"schema":{"type":"string","enum":["low","medium","high"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":5,"default":5},"description":"Rows per call (max 5 — priced per call, so use the filters)"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0},"description":"Pagination offset"}],"responses":{"200":{"description":"Economic events","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"rows":{"type":"array","items":{"type":"object"}}},"required":["rows"]}}}},"402":{"description":"Payment Required"}}}},"/api/data/transcripts":{"get":{"operationId":"listTranscripts","summary":"Central-bank speeches and testimony with a directional assessment","tags":["Transcripts"],"x-payment-info":{"offers":[{"amount":"3000000","currency":"usd","description":"Central-bank speeches and testimony with a directional assessment","intent":"charge","method":"stripe"}]},"parameters":[{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"ISO date — earliest item to return"},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"ISO date — latest item to return"},{"name":"region","in":"query","required":false,"schema":{"type":"string"},"description":"Region code, e.g. US"},{"name":"search","in":"query","required":false,"schema":{"type":"string"},"description":"Title contains"},{"name":"type","in":"query","required":false,"schema":{"type":"string"},"description":"speech | press_conference | …"},{"name":"speaker","in":"query","required":false,"schema":{"type":"string"},"description":"Speaker name contains"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":5,"default":5},"description":"Rows per call (max 5 — priced per call, so use the filters)"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0},"description":"Pagination offset"}],"responses":{"200":{"description":"Transcripts","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"rows":{"type":"array","items":{"type":"object"}}},"required":["rows"]}}}},"402":{"description":"Payment Required"}}}}}}