MangroveTrader X402 API

x402 payment-gated endpoints

GitHub OpenAPI

Operations 3

POST /api/x402/leaderboard Trader leaderboard (x402-gated) #
POST /api/x402/search Search trader (x402-gated) #
POST /api/x402/trade_history Trade history (x402-gated, dynamic pricing) #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/mangrovetraders-com:mangrovetraders-com-x402-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

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.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

mangrovetraders-com-x402-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: MangroveTrader X402 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: X402
  description: x402 payment-gated endpoints
paths:
  /api/x402/leaderboard:
    post:
      tags:
      - X402
      summary: Trader leaderboard (x402-gated)
      description: Top 500 leaderboard rankings. $0.25 USDC on Base. Max 500 rows via REST. API key holders get free access. Payment handled by x402 middleware.
      operationId: rest_leaderboard_api_x402_leaderboard_post
      responses:
        '200':
          description: Leaderboard data (authenticated or paid)
          content:
            application/json:
              schema: {}
        '402':
          description: Payment required -- includes x402 payment options
  /api/x402/search:
    post:
      tags:
      - X402
      summary: Search trader (x402-gated)
      description: Search for a trader by handle. Costs $0.02 USDC on Base. API key holders get free access. Returns 402 with payment requirements if no credentials are provided. Payment handled by x402 middleware.
      operationId: rest_search_trader_api_x402_search_post
      responses:
        '200':
          description: Search results (authenticated or paid)
          content:
            application/json:
              schema: {}
        '402':
          description: Payment required -- includes x402 payment options
  /api/x402/trade_history:
    post:
      tags:
      - X402
      summary: Trade history (x402-gated, dynamic pricing)
      description: 'Full trade history for a trader. Dynamic pricing: $0.01 per 3 trades (USDC on Base). Payment is handled at the tool level, NOT by the Coinbase x402 middleware. Pass the x402 payment signature in the X-Payment header. API key holders get free access via X-API-Key header.'
      operationId: rest_trade_history_api_x402_trade_history_post
      responses:
        '200':
          description: Trade history data (authenticated or paid)
          content:
            application/json:
              schema: {}
        '402':
          description: Payment required -- includes x402 payment options