Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. By signing up you are subscribing to the APIs.io and API Evangelist
newsletters — you can unsubscribe from any issue. See our
Privacy Policy and Terms.
openapi: 3.2.0
info:
title: MangroveTrader Discovery API
description: 'Agent-native trading performance tracker with x402 payments and MCP tools.
## For Agents
- **REST discovery**: GET `/openapi.json` for the full OpenAPI 3.0 spec
- **MCP tool catalog**: GET `/api/v1/docs/tools` for tool names, parameters, access tiers, and pricing
- **MCP endpoint**: Connect to `/mcp` via Streamable HTTP transport
## Access Tiers
| Tier | How to access |
|------|---------------|
| Free | No credentials needed |
| Auth | `X-API-Key` header |
| x402 | Payment via x402 protocol (or API key for free access) |'
version: 0.1.0
tags:
- name: Discovery
description: API and tool discovery endpoints (free, no auth)
paths:
/api/v1/docs/tools:
get:
tags:
- Discovery
summary: MCP tool catalog
description: Lists all registered MCP tools with their access tier, parameters, and pricing. Agents should call this before connecting via MCP to discover what tools are available and what each one costs.
operationId: tool_catalog_api_v1_docs_tools_get
responses:
'200':
description: List of MCP tools with metadata
content:
application/json:
schema: {}
/health:
get:
tags:
- Discovery
summary: Health check
description: Returns service health, Redis connectivity, and worker heartbeat. Free, no auth required.
operationId: health_health_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}