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 Auth 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: Auth
paths:
/api/v1/auth/twitter/login:
get:
tags:
- Auth
summary: Start X OAuth 2.0 login
description: Redirects to X authorization page. After login, X redirects to the callback which issues a MangroveTrader session token. Set it as MT_AUTH_TOKEN.
operationId: twitter_login_api_v1_auth_twitter_login_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}