API Reference
API Reference
Every console surface is a plain HTTP endpoint returning JSON. Base URL is your deployment host — locally http://127.0.0.1:8017.
Endpoints marked 🔒 require an API key. Public endpoints need none. All request and response bodies are JSON.
Authentication
Pass your key in the X-API-Key request header. Manage keys in the Console.
curl "http://127.0.0.1:8017/v2/subnets" \
-H "X-API-Key: $BTI_API_KEY"
Runtime & messages
Health, source metadata and normalized message access.
GET/healthLiveness probe
GET/statusRuntime status & versions
GET/sourcesList ingest sources
GET/sources/metaSource metadata
GET/messagesQuery normalized messages 🔒
GET/messages/metaMessage facets & counts 🔒
GET/messages/qualityMessage quality metrics 🔒
Subnets (v2)
Object-first subnet intelligence. All routes require a key.
GET/v2/subnetsList all subnets 🔒
GET/v2/subnets/{netuid}Subnet profile 🔒
GET/v2/subnets/{netuid}/contextFull context object 🔒
GET/v2/subnets/{netuid}/timelineChronological events 🔒
GET/v2/subnets/{netuid}/claimsExtracted claims 🔒
GET/v2/subnets/{netuid}/evidenceSupporting evidence 🔒
GET/v2/subnets/{netuid}/reportComposed report 🔒
GET/v2/entities/{entity_id}/neighborhoodEntity graph 🔒
Memory
Cross-message facts, people, events and claims over the corpus.
GET/memory/searchSearch the corpus 🔒
GET/memory/researchResearch-grade retrieval 🔒
GET/memory/claimsClaim records 🔒
GET/memory/manifestMemory manifest 🔒
GET/memory/person/{entity_id}Person record 🔒
GET/memory/subnet/{subnet}Subnet memory 🔒
GET/memory/event/{event_id}Event record 🔒
GET/memory/fact/{fact_id}Fact record 🔒
Insights
Aggregate statistics, topics and trends.
GET/insights/statsCorpus statistics 🔒
GET/insights/searchSearch insights 🔒
GET/insights/topicsTrending topics 🔒
GET/insights/trendsTime-series trends 🔒
GET/insights/listList insights 🔒
Knowledge
Static and generated knowledge documents.
GET/knowledge/static/documentsList static docs 🔒
GET/knowledge/static/searchSearch static docs 🔒
GET/knowledge/static/documentFetch a static doc 🔒
GET/knowledge/created/documentsList generated docs 🔒
GET/knowledge/created/searchSearch generated docs 🔒
Research & datasets
Datasets, metrics, repositories and media intelligence. All routes require a key.
GET/data/catalogDataset catalog 🔒
GET/datasets/subnets/latestLatest subnet dataset 🔒
GET/datasets/subnets/reviewReview queue 🔒
POST/datasets/subnets/review/{netuid}/overrides/materializeApply overrides 🔒
GET/metrics/subnets/{netuid}Subnet metrics 🔒
GET/profiles/subnets/{netuid}Subnet profile 🔒
GET/repos/discoverDiscover repositories 🔒
GET/repos/subnets/{netuid}Repos for a subnet 🔒
GET/media/search/revenueRevenue-claim media 🔒
GET/media/claimsMedia claims 🔒
GET/signals/socialSocial signals 🔒
GET/pipelinesPipeline definitions 🔒
GET/pipelines/runsPipeline run history 🔒
Assistant
Conversational intelligence over the corpus.
POST/assistant/chatChat completion 🔒
# Request body
{ "message": "What changed on subnet 64 this week?" }
Managed Twitter/X account access.
GET/twitter/accountsList accounts 🔒
POST/twitter/accounts/addAdd an account 🔒
POST/twitter/accounts/{profile}/removeRemove an account 🔒
GET/twitter/followingFollowing list 🔒
Streaming
Live event stream over Server-Sent Events.
GET/eventsSSE event stream 🔒
Ops & billing
Operational health and spend. Health & summary are public.
GET/ops/healthOps health
GET/ops/service-qualityLive service quality
GET/ops/alertsActive alerts
GET/ops/work-queuesWork queue depth
GET/ops/worker/planWorker schedule
GET/ops/spend/summarySpend summary
POST/ops/spend/checkPre-flight spend check 🔒
POST/ops/spend/recordRecord spend 🔒
Account & keys
Session, account and API-key management.
POST/auth/loginLog in
POST/auth/demoStart a demo session
GET/auth/demo-credentialsDemo credentials
GET/auth/meCurrent account 🔒
POST/auth/logoutLog out 🔒
GET/auth/api-keysList API keys 🔒
POST/auth/api-keysCreate an API key 🔒
DELETE/auth/api-keys/{key_id}Revoke an API key 🔒
GET/auth/billingBilling details 🔒