{ "openapi": "3.1.0", "info": { "title": "MacroTape Brief API", "version": "1.1.0", "summary": "Daily treasuries, FX and crypto in one token-light brief, built for AI agents.", "description": "Read-only endpoints, GET only, CORS open. API key required on data endpoints (Authorization: Bearer or X-API-Key). Get a key: POST /api/keys or /pricing.html (early access, payment comes later). Weekdays, AM (~7 AM ET) and PM (~1 PM ET) editions. Not investment advice.", "contact": { "name": "Brandon Eitniear", "email": "brandons-assistant@mail.grokbot.com", "url": "https://digest.atlasdynamics.space" }, "license": { "name": "API key required; quote with attribution", "url": "https://digest.atlasdynamics.space/pricing.html" } }, "externalDocs": { "description": "Plain-English API reference with curl, Python, JavaScript and LLM tool-call examples", "url": "https://digest.atlasdynamics.space/api.html" }, "servers": [ { "url": "https://digest.atlasdynamics.space" } ], "paths": { "/api/latest.json": { "get": { "operationId": "getLatestBrief", "summary": "Latest brief (newest edition), structured JSON", "security": [ { "bearerAuth": [] }, { "apiKeyHeader": [] } ], "responses": { "200": { "description": "Latest brief", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Brief" } } } }, "401": { "description": "Missing or unknown API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Daily limit reached for this key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/api/latest.txt": { "get": { "operationId": "getLatestBriefText", "summary": "Latest brief, compact plain text (token-minimal)", "security": [ { "bearerAuth": [] }, { "apiKeyHeader": [] } ], "responses": { "200": { "description": "Compact text", "content": { "text/plain": { "schema": { "type": "string" } } } }, "401": { "description": "Missing or unknown API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Daily limit reached for this key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/api/briefs/{date}.json": { "get": { "operationId": "getBriefByDate", "summary": "Brief for a date (newest edition that day)", "security": [ { "bearerAuth": [] }, { "apiKeyHeader": [] } ], "responses": { "200": { "description": "Brief", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Brief" } } } }, "401": { "description": "Missing or unknown API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Daily limit reached for this key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "No brief for that date/edition" } }, "parameters": [ { "name": "date", "in": "path", "required": true, "schema": { "type": "string", "format": "date" }, "example": "2026-10-17" } ] } }, "/api/briefs/{date}.txt": { "get": { "operationId": "getBriefTextByDate", "summary": "Compact text brief for a date (newest edition)", "security": [ { "bearerAuth": [] }, { "apiKeyHeader": [] } ], "responses": { "200": { "description": "Compact text", "content": { "text/plain": { "schema": { "type": "string" } } } }, "401": { "description": "Missing or unknown API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Daily limit reached for this key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "No brief for that date/edition" } }, "parameters": [ { "name": "date", "in": "path", "required": true, "schema": { "type": "string", "format": "date" }, "example": "2026-10-17" } ] } }, "/api/briefs/{date}-{edition}.json": { "get": { "operationId": "getBriefEdition", "summary": "One edition (am|pm) of a dated brief", "security": [ { "bearerAuth": [] }, { "apiKeyHeader": [] } ], "responses": { "200": { "description": "Brief", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Brief" } } } }, "401": { "description": "Missing or unknown API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Daily limit reached for this key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "No brief for that date/edition" } }, "parameters": [ { "name": "date", "in": "path", "required": true, "schema": { "type": "string", "format": "date" }, "example": "2026-10-17" }, { "name": "edition", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "am", "pm" ] } } ] } }, "/api/briefs/{date}-{edition}.txt": { "get": { "operationId": "getBriefEditionText", "summary": "One edition (am|pm), compact text", "security": [ { "bearerAuth": [] }, { "apiKeyHeader": [] } ], "responses": { "200": { "description": "Compact text", "content": { "text/plain": { "schema": { "type": "string" } } } }, "401": { "description": "Missing or unknown API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Daily limit reached for this key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "No brief for that date/edition" } }, "parameters": [ { "name": "date", "in": "path", "required": true, "schema": { "type": "string", "format": "date" }, "example": "2026-10-17" }, { "name": "edition", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "am", "pm" ] } } ] } }, "/api/archive.json": { "get": { "operationId": "getArchive", "summary": "Bulk: every brief, full JSON", "security": [ { "bearerAuth": [] }, { "apiKeyHeader": [] } ], "responses": { "200": { "description": "Archive", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Archive" } } } }, "401": { "description": "Missing or unknown API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Daily limit reached for this key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/api/archive.csv": { "get": { "operationId": "getArchiveCsv", "summary": "Bulk: one row per brief, one column per field", "security": [ { "bearerAuth": [] }, { "apiKeyHeader": [] } ], "responses": { "200": { "description": "CSV", "content": { "text/csv": { "schema": { "type": "string" } } } }, "401": { "description": "Missing or unknown API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Daily limit reached for this key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/api/changelog.json": { "get": { "operationId": "getChangelog", "summary": "Freshness: section as_of dates, last fetch, runs incl. skipped", "security": [ { "bearerAuth": [] }, { "apiKeyHeader": [] } ], "responses": { "200": { "description": "Changelog", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Changelog" } } } }, "401": { "description": "Missing or unknown API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Daily limit reached for this key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/api/index.json": { "get": { "operationId": "listBriefs", "summary": "Index of all briefs and editions, newest first (open, no key)", "security": [], "responses": { "200": { "description": "Index", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Index" } } } } } } }, "/api/topics.json": { "get": { "operationId": "listTopics", "summary": "Every queryable subject with its JSON field path, unit and source (open, no key)", "security": [], "responses": { "200": { "description": "Topics", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Topics" } } } } } } }, "/api/keys": { "post": { "operationId": "createApiKey", "summary": "Self-serve API key (shown once). Early access, payment comes later.", "security": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "email", "plan" ], "properties": { "email": { "type": "string", "format": "email" }, "plan": { "type": "string", "enum": [ "trial", "light", "pro" ] } } } } } }, "responses": { "201": { "description": "Key created", "content": { "application/json": { "schema": { "type": "object", "properties": { "key": { "type": "string" }, "plan": { "type": "string" }, "daily_limit": { "type": "integer" }, "message": { "type": "string" } } } } } }, "400": { "description": "Invalid email or plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "A key already exists for this email", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Signup capacity reached for today", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } } }, "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "description": "Authorization: Bearer " }, "apiKeyHeader": { "type": "apiKey", "in": "header", "name": "X-API-Key" } }, "schemas": { "Brief": { "type": "object", "required": [ "date", "generated_at", "compact", "treasuries", "fx", "crypto" ], "properties": { "schema_version": { "type": "string" }, "name": { "type": "string" }, "date": { "type": "string", "format": "date" }, "edition": { "type": "string", "enum": [ "am", "pm" ], "description": "Absent on briefs published before editions began." }, "edition_note": { "type": "string" }, "generated_at": { "type": "string", "format": "date-time" }, "generated_at_et": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "compact": { "type": "string", "description": "Token-minimal one-line brief." }, "compact_tokens_est": { "type": "integer" }, "signals": { "type": "array", "items": { "type": "string" } }, "basis": { "type": "string" }, "notes": { "type": "array", "items": { "type": "string" } }, "disclaimer": { "type": "string" }, "license": { "type": "string" }, "treasuries": { "type": "object", "properties": { "as_of": { "type": "string", "format": "date" }, "prior": { "type": "string", "format": "date" }, "unit": { "type": "string" }, "source": { "type": "string" }, "source_url": { "type": "string" }, "yields": { "type": "object", "description": "Keyed by tenor label (1M, 1.5M, 2M, 3M, 4M, 6M, 1Y, 2Y, 3Y, 5Y, 7Y, 10Y, 20Y, 30Y as published).", "additionalProperties": { "type": "object", "properties": { "yield": { "type": [ "number", "null" ] }, "chg_bp": { "type": [ "integer", "null" ] }, "years": { "type": [ "number", "null" ] } } } }, "tenors": { "type": "array", "items": { "type": "string" } }, "spreads": { "type": "object", "description": "2s10s, 3m10y, 2s5s, 5s30s, 10s30s", "additionalProperties": { "type": "object", "properties": { "bp": { "type": [ "integer", "null" ] }, "chg_bp": { "type": [ "integer", "null" ] }, "def": { "type": "string" } } } }, "curve_shape": { "type": "object", "properties": { "label": { "type": [ "string", "null" ], "enum": [ "normal", "inverted", "flat", "humped", null ] }, "rule": { "type": "string" }, "available": { "type": "boolean" }, "basis_10y_3m_bp": { "type": [ "integer", "null" ] } } }, "spread_2s10s_bp": { "type": [ "integer", "null" ] }, "spread_2s10s_chg_bp": { "type": [ "integer", "null" ] }, "spread_3m10y_bp": { "type": [ "integer", "null" ] }, "spread_3m10y_chg_bp": { "type": [ "integer", "null" ] } } }, "fx": { "type": "object", "properties": { "as_of": { "type": "string", "format": "date" }, "prior": { "type": "string", "format": "date" }, "basis": { "type": "string" }, "source": { "type": "string" }, "source_url": { "type": "string" }, "pairs": { "type": "object", "description": "Every ECB currency vs USD; EUR/GBP/AUD/NZD as XXXUSD, the rest USDXXX.", "additionalProperties": { "type": "object", "properties": { "rate": { "type": [ "number", "null" ] }, "chg_pct": { "type": [ "number", "null" ] } } } }, "top_movers": { "type": "array", "items": { "type": "object", "properties": { "pair": { "type": "string" }, "chg_pct": { "type": [ "number", "null" ] } } } }, "usd_breadth": { "type": "object", "properties": { "currencies": { "type": "integer" }, "usd_up": { "type": "integer" }, "usd_down": { "type": "integer" }, "unchanged": { "type": "integer" }, "def": { "type": "string" } } } } }, "crypto": { "type": "object", "properties": { "as_of": { "type": "string", "format": "date-time" }, "window": { "type": "string" }, "quote": { "type": "string" }, "source": { "type": "string" }, "source_url": { "type": "string" }, "assets": { "type": "object", "properties": { "BTC": { "type": "object", "properties": { "price": { "type": [ "number", "null" ] }, "chg_24h_pct": { "type": [ "number", "null" ] }, "mcap_usd": { "type": [ "integer", "null" ] } } }, "ETH": { "type": "object", "properties": { "price": { "type": [ "number", "null" ] }, "chg_24h_pct": { "type": [ "number", "null" ] }, "mcap_usd": { "type": [ "integer", "null" ] } } }, "SOL": { "type": "object", "properties": { "price": { "type": [ "number", "null" ] }, "chg_24h_pct": { "type": [ "number", "null" ] }, "mcap_usd": { "type": [ "integer", "null" ] } } } } }, "total_mcap_usd": { "type": [ "integer", "null" ] }, "total_mcap_chg_24h_pct": { "type": [ "number", "null" ] }, "btc_dominance_pct": { "type": [ "number", "null" ] }, "eth_dominance_pct": { "type": [ "number", "null" ] }, "top20": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "rank": { "type": "integer" }, "id": { "type": "string" }, "symbol": { "type": "string" }, "name": { "type": "string" }, "price": { "type": [ "number", "null" ] }, "mcap_usd": { "type": [ "integer", "null" ] }, "chg_24h_pct": { "type": [ "number", "null" ] } } } }, "altcoin_movers": { "type": "object", "properties": { "available": { "type": "boolean" }, "reason": { "type": "string" }, "universe": { "type": "string" }, "stablecoin_filter": { "type": "string" }, "gainers": { "type": "array", "items": { "type": "object", "properties": { "rank": { "type": "integer" }, "id": { "type": "string" }, "symbol": { "type": "string" }, "name": { "type": "string" }, "price": { "type": [ "number", "null" ] }, "mcap_usd": { "type": [ "integer", "null" ] }, "chg_24h_pct": { "type": [ "number", "null" ] } } } }, "losers": { "type": "array", "items": { "type": "object", "properties": { "rank": { "type": "integer" }, "id": { "type": "string" }, "symbol": { "type": "string" }, "name": { "type": "string" }, "price": { "type": [ "number", "null" ] }, "mcap_usd": { "type": [ "integer", "null" ] }, "chg_24h_pct": { "type": [ "number", "null" ] } } } } } }, "stablecoins": { "type": "object", "properties": { "available": { "type": "boolean" }, "reason": { "type": "string" }, "mcap_usd": { "type": [ "integer", "null" ] }, "mcap_chg_24h_pct": { "type": [ "number", "null" ] }, "coins_counted": { "type": "integer" }, "def": { "type": "string" } } } } } } }, "Error": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" }, "signup_url": { "type": "string" }, "docs_url": { "type": "string" }, "pricing_url": { "type": "string" } } }, "Index": { "type": "object", "properties": { "latest": { "type": "string", "format": "date" }, "latest_edition": { "type": [ "string", "null" ] }, "latest_url": { "type": "string" }, "updated_at": { "type": "string" }, "count": { "type": "integer" }, "briefs": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "format": "date" }, "edition": { "type": [ "string", "null" ] }, "json": { "type": "string" }, "txt": { "type": "string" }, "day_json": { "type": "string" } } } } } }, "Archive": { "type": "object", "properties": { "count": { "type": "integer" }, "updated_at": { "type": "string" }, "briefs": { "type": "array", "items": { "$ref": "#/components/schemas/Brief" } } } }, "Changelog": { "type": "object", "properties": { "latest": { "type": "object" }, "schedule": { "type": "string" }, "sections": { "type": "object" }, "skipped_runs_count": { "type": "integer" }, "runs": { "type": "array", "items": { "type": "object", "properties": { "at": { "type": "string" }, "at_et": { "type": "string" }, "date": { "type": "string" }, "edition": { "type": [ "string", "null" ] }, "status": { "type": "string", "enum": [ "ok", "skipped" ] }, "reason": { "type": "string" } } } } } }, "Topics": { "type": "object", "properties": { "count": { "type": "integer" }, "topics": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "section": { "type": "string" }, "topic": { "type": "string" }, "source": { "type": [ "string", "null" ] }, "source_url": { "type": [ "string", "null" ] }, "as_of_path": { "type": "string" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "unit": { "type": "string" }, "meaning": { "type": "string" } } } } } } } } } } } }