Agent API docs
Use this page to wire agents to Atlas endpoints.
Base URL
/api/agent/v1Subscribe or sign in with your Substack email to create keys.
Fetch calculator definitions, change assumptions, run the shared Atlas math, and compare revenue, margin, payback, power, or capacity sensitivity.
Combine company profiles, taxonomy membership, calendar events, Taiwan revenue, memory data, and dashboard rows before drafting a financial note.
Watch earnings, transcript availability, revenue releases, and source updates, then refresh analysis when new data changes the debate.
Use structured endpoints and generated timestamps so agents can separate Atlas-authored context, live data, and calculator output.
Agent financial analysis loop
Example
curl -X POST /api/agent/v1/calculators/ai-factory/run \
-H "Authorization: Bearer atlas_..." \
-H "Content-Type: application/json" \
-d '{"inputs":{"activeMw":120,"gpuTdpWatts":1200,"rackKw":120}}'Agents can vary inputs such as active MW, rack density, accelerator power, ASP, HBM stacks, wafer starts, or utilization, then summarize which assumption drives the largest change.
Call the catalog endpoint first when wiring an agent. It returns this same capability map with method, path, cache behavior, and access status.
/api/agent/v1/catalogDiscover available Atlas agent API capabilities.
/api/agent/v1/taxonomyAI infrastructure categories, layers, segments, and labels.
/api/agent/v1/companies?category=&segment=&marketCap=&q=&limit=Atlas AI infrastructure company universe with optional category, segment, market cap, and text filters.
/api/agent/v1/companies/{slug}Atlas-authored company profile, taxonomy memberships, and peer set.
/api/agent/v1/companies/{slug}/dashboardCompany dashboard data: quote, financials, earnings, transcript dates, ownership, filings, and news.
/api/agent/v1/companies/{slug}/transcripts/{fyYYYY-qN}Authenticated access to a single earnings-call transcript for agent analysis, subject to upstream data terms.
/api/agent/v1/calendarEarnings, transcript, and Atlas catalyst calendar for the AI infrastructure universe.
/api/agent/v1/taiwan-revenueOfficial Taiwan monthly revenue tracker, baskets, leaders, laggards, and source statuses.
/api/agent/v1/memory?limit=Persisted memory spot-price observations and memory-company financial rows.
/api/agent/v1/calculatorsAvailable Atlas calculator models, presets, and default inputs.
/api/agent/v1/calculators/{calculator}/runRun shared calculator math for AI factory, CPO stack, HBM revenue bridge, GPU cloud TCO, custom ASIC economics, OCS TAM, N3 allocation bottlenecks, optical transceiver TAM, inference token economics, or data center power bottleneck scenarios.