API Reference Overview
The embed Feed Pipeline
All feeds follow the same pipeline. The difference is how you author the algorithm — visually in the embed Console, from a natural language prompt via /algo/compose, or by writing code directly with the Algorithms DSL.
Pipeline
- Ingest — Push your data via the Data Sources APIs
- Search — Generate candidates from Elasticsearch indices (Farcaster, Polymarket, Zora, Kalshi)
- Enrich — Add ML features (semantic similarity, topic matching) via ML Primitives > Features
- Score — Rerank candidates with trained ML models via ML Primitives > Scoring
- Rank — Apply diversity, sorting, and limits via ML Primitives > Ranking
- Author — Create your feed algorithm (console, natural language prompt, or code)
- Validate — Run syntax and security checks via Algorithms > Algorithm Configs
- Test — Run the algorithm in a sandbox via the Test Run API
- Deploy — Save the algorithm and create a deployment config via the Deployments API
- Serve — Serve feeds with pagination and cache management via the Serving API
- Stories (optional) — Generate narrative content about market activity via Content > Stories
How to Author Algorithms
| Method | Best for | How |
|---|---|---|
| Console | Visual builder, no code | Build in the embed Console, deploy from there |
| Natural language | Quick prototyping | Describe what you want → POST /algo/compose generates the code |
| Code | Full control | Write JavaScript using the Algorithms DSL |
API Reference
| Stage | API Section |
|---|---|
| Ingest | Data Sources APIs |
| Search | Content > Search |
| Enrich | ML primitives > Features |
| Score | ML primitives > Scoring |
| Rank | ML primitives > Ranking |
| Author & Validate | Algorithms > Algorithm Configs |
| Test | Algorithms > Test Run |
| Deploy | Deployments > Feed Configuration |
| Alpha Signals | Content > Alpha Signals |
| Alpha Notifications | Deployments > Alpha Notifications Serving |
| Serve | Deployments > Serving |
| Stories | Content > Stories |
For AI Agents & LLMs
If you're building AI agents or using LLMs that interact with the embed API, we provide a machine-readable SDK reference:
llms.txt — Complete Algorithms DSL specification formatted for LLM consumption. Contains the full source of the algo-dsl package with usage patterns, filter types, and method signatures.
Use this as context when prompting AI coding assistants to write feed algorithms, or as a reference for AI agents that call the embed pipeline programmatically.
Authentication
All APIs use Bearer token authentication:
Authorization: Bearer mbd-{your-api-key}
Get your API key from the embed Console.
Updated 8 days ago
