UltraEdge API documentation
Where am I? This is the developer reference for the UltraEdge Marketplace API. The product itself is at demo.ultraedge.ai; the plain-English walk through the calls each role makes is at API by role. Pick a surface below to open its interactive page.
Version 0.1.0. Server https://api.ultraedge.ai. One API, several documented surfaces. Pick the one for your role.
Every screen UltraEdge ships, including the admin console, is a client of these endpoints.
| Surface | Swagger | Scalar | OpenAPI 3.1 |
|---|---|---|---|
| UltraEdge Marketplace API (all surfaces) Every operation, with its x-audience tags. | Swagger UI | Scalar | openapi.json |
| UltraEdge Public API Visitors without an account: search and read active listings, price history, and sign up or log in. No bearer token needed. | Swagger UI | Scalar | openapi.json |
| UltraEdge Buyer API Verified buyer companies: search listings, place bids (auto-declined under the seller's private floor), counter, accept, withdraw, and move deals along. | Swagger UI | Scalar | openapi.json |
| UltraEdge Seller (vendor) API Sellers, also called vendors in this API (the token scope and role are both named vendor; /swagger/seller is an alias): create, publish, pause and update listings, set the private floor, answer bids, counter, accept or decline, and manage deals. | Swagger UI | Scalar | openapi.json |
| UltraEdge Company Admin API A company's administrator: company profile, verification documents, users, and everything a buyer or vendor can do for that company. | Swagger UI | Scalar | openapi.json |
| UltraEdge Admin API UltraEdge platform operators only: settings for every marketplace rule, audit log, company verification decisions, listing review, plus Monitoring (health, counts, series, sweeps), Ops (queue, disputes, suspensions, announcements) and Finance (fee ledger, summary, statements, invoices). | Swagger UI | Scalar | openapi.json |
| UltraEdge Service API Machine clients with an API key: stock-system connectors, spreadsheet import jobs, monitoring. Reads listings and health; writes inventory on behalf of a vendor. | Swagger UI | Scalar | openapi.json |
MCP server (for LLM clients)
Connect Claude Code, Claude Desktop or any MCP client to POST /mcp (Streamable HTTP) with the same bearer token. Tools follow your role. Discovery: /mcp/info · /.well-known/mcp.json.
Machine-readable list: /openapi/audiences.json. Authenticate with Authorization: Bearer <access_token> from POST /v1/auth/login.