v1.0.0 Production Gateway

Moonlist Intelligence API

Welcome to the institutional gateway for autonomous on-chain operations. Moonlist provides a unified, highly-resilient API that abstracts multi-chain liquidity aggregation, natural language AI intent detection, and high-performance RPC node auditing into a single standardized interface.

Quick Start: Generate your production key in the Developer Console to begin executing requests against the Unified Gateway.

Primary Gateway Endpoint

POST https://endpoint.moonlist.app/v1

Authentication

Authentication is enforced via the X-MOONLIST-KEY header (or ml-key query parameter for Web3 wallet/paymaster compatibility). All requests are monitored against your monthly subscription tier.

Header / Parameter	Type	Requirement	Description
X-MOONLIST-KEY	String	Required	Your unique production key (e.g. `ml_4f89a2...`). Managed in the Developer Console.
Content-Type	String	Required	Must be `application/json`.

AI Agent & LLM Discovery

Moonlist is engineered from the ground up for autonomous LLM agents (LangChain, AutoGPT, Vercel AI SDK, Mastra). We export dynamic machine-readable specifications for automated tool-calling.

1. Context Overview (llms.txt)

Autonomous agents should ingest llms.txt to parse the core capabilities and endpoints of the Moonlist platform.

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

View Spec

2. Machine Schema (OpenAPI 3.0)

Pass our full OpenAPI YAML to your agent runtime to auto-generate tool calling schemas on the fly.

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

View OpenAPI

Unified Gateway Reference

The /v1 endpoint accepts a unified JSON object. The target parameter dictates which backend execution node handles the request.

Field	Type	Required	Description
target	String	Yes	Specialized target node: `brain`, `zerox`, `openocean`, `alchemy`, `binance`, `base-rpc`, `news`, or `ping`.
path	String	Optional	Sub-route path for target service (e.g. `/1/swap` or `eth-mainnet`).
method	String	Optional	HTTP Method for upstream target (default `POST`).
params	Object	Optional	Query string parameters key-value object.
body	Object	Optional	JSON payload passed directly to target service.

Target: Brain (AI NLP Intent Engine)

Converts unformatted human language or agent prompt text into structured on-chain transaction execution commands (Swaps, Sends, Liquidity Routing).

POST /v1 (target: brain)

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

Target: 0x (Solana & Cross-Chain DEX)

Execute institutional DEX swaps on Solana and cross-chain routes. Supports Solana quote generation and swap-instructions.

POST /v1 (target: zerox - Solana Quote)

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

Target: OpenOcean (EVM Aggregation)

Multi-chain liquidity routing across Ethereum, BSC, Base, Polygon, Arbitrum, Optimism, and Avalanche.

POST /v1 (target: openocean - EVM Swap Quote)

{
  "target": "openocean",
  "path": "/1/swap",
  "params": {
    "inTokenAddress": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
    "outTokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amountDecimals": "1000000000000000000",
    "slippage": "1",
    "account": "YOUR_EVM_ADDRESS",
    "referrer": "0xC4DcEF92c168256BA9463EB6f96aD3dEfba0Be58"
  }
}

Target: Alchemy (Multi-Chain Audit RPC)

Direct proxy to high-speed Alchemy nodes. Specify target network in path (e.g. eth-mainnet, base-mainnet, polygon-mainnet).

POST /v1 (target: alchemy - Token Balances RPC)

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

Target: Binance Web3 Engine

Access Binance Web3 Build endpoints with automatic server-side HMAC-SHA256 signature generation.

POST /v1 (target: binance)

{
  "target": "binance",
  "path": "/wallet/asset/list",
  "method": "POST",
  "body": {}
}

Target: Base L2 RPC (Coinbase CDP)

Direct JSON-RPC node connection to Coinbase Developer Platform Base L2 mainnet infrastructure.

POST /v1 (target: base-rpc)

{
  "target": "base-rpc",
  "body": {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "eth_blockNumber",
    "params": []
  }
}

Target: Moonlist News

Fetch real-time market intelligence, protocol updates, and research posts directly from Moonlist editors.

POST /v1 (target: news)

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

Target: Ping (Health Check)

Fast heartbeat check to verify Gateway connectivity and API key validity.

POST /v1 (target: ping)

{
  "target": "ping"
}

Error Status Codes

The Unified Gateway uses standard HTTP status codes to communicate execution results.

Status Code	Status Name	Description & Resolution
200 OK	Success	Request executed successfully by upstream target engine.
401 Unauthorized	Missing Key	Missing or invalid `X-MOONLIST-KEY` header. Check Developer Console credentials.
402 Payment Required	Subscription Required	API Key has no active subscription. Upgrade plan in Developer Console.
400 Bad Request	Invalid Payload	Missing `target` parameter or malformed JSON payload body.
500 Internal Error	Upstream Failure	Upstream network connection error or target provider rate limit.

Billing & Subscriptions

Moonlist API operates on a predictable flat-rate monthly tier for developer and institutional access.

Plan: Institutional Pro
Monthly Rate: $100.00 / Month (Payable in USDT / USDC)
Supported Payment Chains: Ethereum, BSC, Base L2, Polygon
Quota: 5,000 requests per monthly billing cycle
Treasury Address: 0xC4DcEF92c168256BA9463EB6f96aD3dEfba0Be58