v1.0.0 Production Ready

Moonlist Intelligence API

Welcome to the institutional gateway for autonomous on-chain operations. Moonlist provides a unified, highly-resilient API that abstracts the complexity of multiple blockchains, liquidity aggregators, and AI models into a single standardized interface.

Primary Endpoint

POST https://project-9mkjw.vercel.app/api/onchain-proxy

Authentication

Access is secured via the X-MOONLIST-KEY header. All requests are monitored for usage against your monthly plan limits.

Header	Type	Description
X-MOONLIST-KEY	String	Your unique production API key. Obtainable from the Developer Console.
Content-Type	String	Must be `application/json`.

AI Agent Crawling

Moonlist is optimized for autonomous agents and LLMs. We provide specific entry points for agents to discover our capabilities dynamically.

High-Level Context

Autonomous agents should first consume llms.txt to understand the platform's scope and primary resources.

GET https://moonlist.app/llms.txt

Dynamic Tool Discovery

Agents can use our full OpenAPI spec to generate function-calling schemas on the fly.

GET https://moonlist.app/openapi.yaml

Unified Gateway Reference

The /onchain-proxy endpoint accepts a JSON body. The target field determines which specialized engine handles the request.

Field	Required	Description
target	Yes	`brain`, `zerox`, `openocean`, `alchemy`, `news`, or `ping`.
path	Optional	Internal route for the target service (e.g. `/1/swap`).
params	Optional	Query parameters for GET/POST requests.
body	Optional	JSON payload for POST requests.

Target: Brain (AI Intelligence)

The NLP engine that powers Moonlist. It converts natural language queries into structured on-chain intents.

{
  "target": "brain",
  "body": {
    "query": "Swap 1 ETH for USDC on Base",
    "portfolio": [],
    "currency": "USD"
  }
}

Target: 0x (Solana Swaps)

Execute institutional-grade swaps on Solana. Note: Solana routing requires the /solana/ path prefix.

{
  "target": "zerox",
  "path": "/solana/swap/v1/quote",
  "method": "GET",
  "params": {
    "sellToken": "So11111111111111111111111111111111111111112",
    "buyToken": "EPjFWdd5AufqztqjnqAv3S4wd3ldYyombl63GF8Vgcyq",
    "sellAmount": "1000000000",
    "taker": "YOUR_WALLET_ADDRESS"
  }
}

Target: OpenOcean (EVM Swaps)

Multi-chain liquidity aggregation for Ethereum, BSC, Base, Polygon, Arbitrum, and Optimism.

{
  "target": "openocean",
  "path": "/1/swap",
  "params": {
    "inTokenAddress": "0x...",
    "outTokenAddress": "0x...",
    "amountDecimals": "1000000",
    "slippage": "1",
    "account": "YOUR_EVM_ADDRESS",
    "referrer": "0xC4DcEF92c168256BA9463EB6f96aD3dEfba0Be58"
  }
}

Target: Alchemy (On-Chain Audit)

Deep multi-chain data scanning. Supports all standard Alchemy JSON-RPC methods via the gateway.

{
  "target": "alchemy",
  "path": "base-mainnet",
  "body": {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "alchemy_getTokenBalances",
    "params": ["0xYOUR_ADDRESS"]
  }
}

Target: Moonlist News

Fetch real-time market insights and platform updates published by the Moonlist editorial team.

{
  "target": "news",
  "method": "GET"
}

Billing & Subscription

Moonlist API operates on a flat-fee subscription model for institutional access.

Plan: Institutional Pro
Price: $100.00 / Month (Payable in USDT/USDC)
Quota: 5,000 requests per billing cycle.
Collector: 0xC4DcEF92c168256BA9463EB6f96aD3dEfba0Be58

Discount Codes

We support promotional codes for early adopters and enterprise partners. Codes can be applied directly in the Payment Console.

If you have an invite code, enter it during the upgrade process to automatically adjust your monthly token commitment.