API 参考（x402）

开发者 x402 API

Minara 的 x402 端点采用随用随付模型的技术规范。

基础 URL: https://x402.minara.ai

Chat (Base Chain)

post

Ask Minara AI - Intelligent crypto assistant

授权

x402Payment

x-payment-responsestring必填

Payment proof token obtained from x402 payment challenge flow. Required after completing payment.

请求体

application/json

userQuerystring必填

Required. User query content.

响应

201

Successful response

application/json

400

Bad Request - Invalid parameters

application/json

401

Unauthorized - Invalid payment response token

application/json

402

Payment Required

application/json

post

/x402/chat

HTTPcURLJavaScriptPython

POST /x402/chat HTTP/1.1
Host: x402.minara.ai
x-payment-response: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 85

{
  "userQuery": "What is the current price of BTC and what are the key support levels?"
}

{
  "content": "BTC is currently trading at $98,450. Key support levels are at $96,500 and $94,200..."
}

Chat Expert (Base Chain)

post

Ask Minara AI - Intelligent crypto assistant

授权

x402Payment

x-payment-responsestring必填

Payment proof token obtained from x402 payment challenge flow. Required after completing payment.

请求体

application/json

userQuerystring必填

Required. User query content.

响应

201

Successful response

application/json

400

Bad Request - Invalid parameters

401

Unauthorized - Invalid payment response token

402

Payment Required

application/json

post

/x402/chat/expert

HTTPcURLJavaScriptPython

POST /x402/chat/expert HTTP/1.1
Host: x402.minara.ai
x-payment-response: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 103

{
  "userQuery": "Provide a comprehensive analysis of ETH including on-chain metrics and trading strategy"
}

{
  "content": "Comprehensive ETH analysis: [Detailed expert analysis content]..."
}

Chat (Polygon Chain)

post

Ask Minara AI - Intelligent crypto assistant

授权

x402Payment

x-payment-responsestring必填

Payment proof token obtained from x402 payment challenge flow. Required after completing payment.

请求体

application/json

userQuerystring必填

Required. User query content.

响应

201

Successful response

application/json

400

Bad Request - Invalid parameters

application/json

401

Unauthorized - Invalid payment response token

application/json

402

Payment Required

application/json

post

/x402/polygon/chat

HTTPcURLJavaScriptPython

POST /x402/polygon/chat HTTP/1.1
Host: x402.minara.ai
x-payment-response: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 85

{
  "userQuery": "What is the current price of BTC and what are the key support levels?"
}

{
  "content": "BTC is currently trading at $98,450. Key support levels are at $96,500 and $94,200..."
}

Chat Expert (Polygon Chain)

post

Ask Minara AI - Intelligent crypto assistant

授权

x402Payment

x-payment-responsestring必填

Payment proof token obtained from x402 payment challenge flow. Required after completing payment.

请求体

application/json

userQuerystring必填

Required. User query content.

响应

201

Successful response

application/json

400

Bad Request - Invalid parameters

401

Unauthorized - Invalid payment response token

402

Payment Required

application/json

post

/x402/polygon/chat/expert

HTTPcURLJavaScriptPython

POST /x402/polygon/chat/expert HTTP/1.1
Host: x402.minara.ai
x-payment-response: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 103

{
  "userQuery": "Provide a comprehensive analysis of ETH including on-chain metrics and trading strategy"
}

{
  "content": "Comprehensive ETH analysis: [Detailed expert analysis content]..."
}

Chat (Solana Chain)

post

Ask Minara AI - Intelligent crypto assistant

授权

x402Payment

x-payment-responsestring必填

Payment proof token obtained from x402 payment challenge flow. Required after completing payment.

请求体

application/json

userQuerystring必填

Required. User query content.

响应

201

Successful response

application/json

400

Bad Request - Invalid parameters

401

Unauthorized - Invalid payment response token

402

Payment Required

application/json

post

/x402/solana/chat

HTTPcURLJavaScriptPython

POST /x402/solana/chat HTTP/1.1
Host: x402.minara.ai
x-payment-response: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 67

{
  "userQuery": "Show me the top trending tokens on Solana right now"
}

{
  "content": "Top trending Solana tokens: 1) WIF - up 24% with $45M volume..."
}

Chat Expert (Solana Chain)

post

Ask Minara AI - Intelligent crypto assistant

授权

x402Payment

x-payment-responsestring必填

Payment proof token obtained from x402 payment challenge flow. Required after completing payment.

请求体

application/json

userQuerystring必填

Required. User query content.

响应

201

Successful response

application/json

400

Bad Request - Invalid parameters

401

Unauthorized - Invalid payment response token

402

Payment Required

application/json

post

/x402/solana/chat/expert

HTTPcURLJavaScriptPython

POST /x402/solana/chat/expert HTTP/1.1
Host: x402.minara.ai
x-payment-response: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 84

{
  "userQuery": "Analyze the liquidity distribution and whale movements for JUP token"
}

{
  "content": "[Comprehensive expert analysis of JUP token with on-chain metrics]..."
}

Perpetual Trading Suggestion

post

Get AI-powered perpetual trading suggestions with long/short recommendations, entry price, stop loss, take profit levels, and confidence score.

授权

x402Payment

x-payment-responsestring必填

Payment proof token obtained from x402 payment challenge flow. Required after completing payment.

请求体

application/json

symbolstring必填

Required. Trading symbol (e.g., 'BTC', 'ETH', 'SOL').

stylestring · enum可选

Optional. Trading style: 'scalping', 'day-trading', or 'swing-trading'. Default: 'scalping'.

Default: scalping可能的值:

marginUSDnumber可选

Optional. Margin in USD. Default: 1000.

Default: 1000

leveragenumber · 最小值: 1 · 最大值: 40可选

Optional. Leverage multiplier (max: 40). Default: 10.

Default: 10

strategystring可选

Optional. Strategy type. Default: 'max-profit'. More strategies coming soon.

Default: max-profit

响应

201

Successful response

application/json

400

Bad Request - Invalid parameters

401

Unauthorized - Invalid payment response token

402

Payment Required

application/json

post

/x402/perp-trading-suggestion

HTTPcURLJavaScriptPython

POST /x402/perp-trading-suggestion HTTP/1.1
Host: x402.minara.ai
x-payment-response: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 93

{
  "symbol": "BTC",
  "style": "day-trading",
  "marginUSD": 1000,
  "leverage": 10,
  "strategy": "max-profit"
}

{
  "entryPrice": 98450,
  "side": "long",
  "stopLossPrice": 96200,
  "takeProfitPrice": 102800,
  "confidence": 78,
  "reasons": [
    "BTC broke above key resistance at $97,500 with strong volume",
    "RSI at 62 indicates bullish momentum without being overbought",
    "MACD showing bullish crossover"
  ],
  "risks": [
    "Potential pullback at $100,000 psychological resistance",
    "High volatility expected around upcoming Fed meeting"
  ]
}

Intent to Swap Transaction

post

Convert natural language trading intent into an executable swap transaction payload. Compatible with OKX DEX by default.

授权

x402Payment

x-payment-responsestring必填

Payment proof token obtained from x402 payment challenge flow. Required after completing payment.

请求体

application/json

intentstring必填

Required. Natural language swap intent (e.g., 'swap 0.1 ETH to USDC').

walletAddressstring必填

Required. User wallet address (0x...).

chainstring可选

Optional. Chain name (e.g., 'base', 'ethereum', 'bsc', 'arbitrum', 'optimism').

响应

201

Successful response

application/json

400

Bad Request - Invalid parameters

401

Unauthorized - Invalid payment response token

402

Payment Required

application/json

post

/x402/intent-to-swap-tx

HTTPcURLJavaScriptPython

POST /x402/intent-to-swap-tx HTTP/1.1
Host: x402.minara.ai
x-payment-response: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 109

{
  "intent": "swap 0.1 ETH to USDC",
  "chain": "base",
  "walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb1"
}

{
  "transaction": {
    "chain": "base",
    "inputTokenAddress": "0x4200000000000000000000000000000000000006",
    "inputTokenSymbol": "ETH",
    "outputTokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "outputTokenSymbol": "USDC",
    "amount": "0.1",
    "amountPercentage": 100,
    "slippagePercent": "0.5"
  }
}

Prediction Market Analysis (Base Chain)

post

AI-powered prediction market analysis. Analyze prediction market events and get probability estimates for each outcome with detailed reasoning.

授权

x402Payment

x-payment-responsestring必填

Payment proof token obtained from x402 payment challenge flow. Required after completing payment.

请求体

application/json

linkstring必填

Required. Prediction market page link (e.g., Polymarket event URL).

modestring · enum必填

Required. Chat mode: 'fast' or 'expert'.

可能的值:

only_resultboolean可选

Optional. Only return prediction probabilities without reasoning. Default: false.

Default: false

customPromptstring可选

Optional. Custom instructions to guide the analysis. Use this to specify focus areas, risk preferences, or analysis style.

响应

201

Successful response

application/json

400

Bad Request - Invalid parameters

application/json

401

Unauthorized - Invalid payment response token

application/json

402

Payment Required

application/json

post

/x402/prediction-market-ask

HTTPcURLJavaScriptPython

POST /x402/prediction-market-ask HTTP/1.1
Host: x402.minara.ai
x-payment-response: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 241

{
  "link": "https://polymarket.com/event/will-there-be-another-us-government-shutdown-by-january-31",
  "mode": "fast",
  "only_result": false,
  "customPrompt": "Focus on recent news and sentiment analysis. Be more conservative in probability estimates."
}

{
  "predictions": [
    {
      "outcome": "Donald Trump",
      "yesProb": 0.65,
      "noProb": 0.35
    },
    {
      "outcome": "Kamala Harris",
      "yesProb": 0.3,
      "noProb": 0.7
    }
  ],
  "reasoning": "Based on recent polling data and historical trends, Trump maintains a slight lead in key swing states. However, the race remains highly competitive with significant uncertainty..."
}

端点

聊天（Base 链）

端点： POST /x402/chat

请求

请求头：

• x-payment-response （必填）- 来自 x402 协议的支付证明令牌

• Content-Type: application/json

请求体参数：

参数	类型	是否必填	描述
userQuery	字符串	是	用户查询内容

请求示例

curl -X POST https://x402.minara.ai/x402/chat \
  -H "x-payment-response: <payment_proof_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "userQuery": "What is the current price of BTC and what are the key support levels?"
  }'

响应

状态： 201 Created

{
  "content": "BTC is currently trading at $98,450. Key support levels are at $96,500 and $94,200. The recent breakout above $97,000 with strong volume suggests bullish continuation..."
}

---

聊天专家（Base 链）

端点： POST /x402/chat/expert

询问 Minara AI —— 在 Base 链上的智能加密助手，专家模式

请求

请求头：

• x-payment-response （必填）- 来自 x402 协议的支付证明令牌

• Content-Type: application/json

请求体参数：

参数	类型	是否必填	描述
userQuery	字符串	是	用户查询内容

请求示例

curl -X POST https://x402.minara.ai/x402/chat/expert \
  -H "x-payment-response: <payment_proof_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "userQuery": "Provide a comprehensive analysis of ETH including on-chain metrics and trading strategy"
  }'

响应

状态： 201 Created

{
  "content": "Comprehensive ETH Analysis:\n\n**Price Action**: ETH is trading at $3,420, consolidating near the $3,400-$3,500 range...\n\n**On-Chain Metrics**: Active addresses increased 12% week-over-week, indicating growing network activity...\n\n**Trading Strategy**: Consider accumulating on dips to $3,300 support with targets at $3,600 and $3,850..."
}

---

聊天（Solana 链）

端点： POST /x402/solana/chat

请求

请求头：

• x-payment-response （必填）- 来自 x402 协议的支付证明令牌

• Content-Type: application/json

请求体参数：

参数	类型	是否必填	描述
userQuery	字符串	是	用户查询内容

请求示例

curl -X POST https://x402.minara.ai/x402/solana/chat \
  -H "x-payment-response: <payment_proof_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "userQuery": "Show me the top trending tokens on Solana right now"
  }'

响应

状态： 201 Created

{
  "content": "Top trending Solana tokens:\n1. WIF - up 24% with $45M 24h volume\n2. BONK - up 18% with strong community activity\n3. JUP - consolidating after recent pump, volume at $38M..."
}

聊天专家（Solana 链）

端点： POST /x402/solana/chat/expert

询问 Minara AI —— 在 Solana 链上的智能加密助手，专家模式

请求

请求头：

• x-payment-response （必填）- 来自 x402 协议的支付证明令牌

• Content-Type: application/json

请求体参数：

参数	类型	是否必填	描述
userQuery	字符串	是	用户查询内容

请求示例

curl -X POST https://x402.minara.ai/x402/solana/chat/expert \
  -H "x-payment-response: <payment_proof_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "userQuery": "Analyze the liquidity distribution and whale movements for JUP token"
  }'

响应

状态： 201 Created

{
  "content": "**JUP Token Deep Analysis**\n\n**Liquidity Distribution**: Total liquidity across major DEXs is $125M, with 65% concentrated in the $0.85-$0.92 range...\n\n**Whale Activity**: Top 10 holders control 34% of supply. Detected 3 significant whale transactions in the last 24h totaling $4.2M in buys...\n\n**Risk Assessment**: Moderate liquidity risk above $1.00 mark. Consider this in position sizing..."
}

---

聊天（Polygon 链）

端点： POST /x402/polygon/chat

询问 Minara AI —— 在 Polygon 链上的智能加密助手

请求

请求头：

• x-payment-response （必填）- 来自 x402 协议的支付证明令牌

• Content-Type: application/json

请求体参数：

参数	类型	是否必填	描述
userQuery	字符串	是	用户查询内容

请求示例

curl -X POST https://x402.minara.ai/x402/polygon/chat \
  -H "x-payment-response: <payment_proof_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "userQuery": "What is the current price of BTC and what are the key support levels?"
  }'

响应

状态： 201 Created

{
  "content": "BTC is currently trading at $98,450. Key support levels are at $96,500 and $94,200. The recent breakout above $97,000 with strong volume suggests bullish continuation..."
}

---

聊天专家（Polygon 链）

端点： POST /x402/polygon/chat/expert

询问 Minara AI —— 在 Polygon 链上的智能加密助手，专家模式

请求

请求头：

• x-payment-response （必填）- 来自 x402 协议的支付证明令牌

• Content-Type: application/json

请求体参数：

参数	类型	是否必填	描述
userQuery	字符串	是	用户查询内容

请求示例

curl -X POST https://x402.minara.ai/x402/polygon/chat/expert \
  -H "x-payment-response: <payment_proof_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "userQuery": "Provide a comprehensive analysis of ETH including on-chain metrics and trading strategy"
  }'

响应

状态： 201 Created

{
  "content": "**Comprehensive ETH Analysis**\n\n**Price Action**: ETH is trading at $3,420, consolidating near the $3,400-$3,500 range...\n\n**On-Chain Metrics**: Active addresses increased 12% week-over-week, indicating growing network activity...\n\n**Trading Strategy**: Consider accumulating on dips to $3,300 support with targets at $3,600 and $3,850..."
}

---

交易端点

换币意图交易

端点： POST /x402/intent-to-swap-tx

将自然语言的交易意图转换为可执行的换币交易负载。默认兼容 OKX DEX。

请求

请求头：

• x-payment-response （必填）- 来自 x402 协议的支付证明令牌

• Content-Type: application/json

请求体参数：

参数	类型	是否必填	描述
intent	字符串	是	自然语言的换币意图（例如，"swap 0.1 ETH to USDC"）
walletAddress	字符串	是	用户钱包地址（0x...）
chain	字符串	否	链名称（例如，"base"、"ethereum"、"bsc"、"arbitrum"、"optimism"）

请求示例

curl -X POST https://x402.minara.ai/x402/intent-to-swap-tx \
  -H "x-payment-response: <payment_proof_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "intent": "swap 0.1 ETH to USDC",
    "walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb1",
    "chain": "base"
  }'

响应

状态： 201 Created

{
  "transaction": {
    "chain": "base",
    "inputTokenAddress": "0x4200000000000000000000000000000000000006",
    "inputTokenSymbol": "ETH",
    "outputTokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "outputTokenSymbol": "USDC",
    "amount": "0.1",
    "amountPercentage": 100,
    "slippagePercent": "0.5"
  }
}

---

永续合约交易建议

端点： POST /x402/perp-trading-suggestion

获取由 AI 提供的永续合约交易建议，包括多/空建议、入场价、止损、止盈位和基于全面市场分析的置信度评分。

请求

请求头：

• x-payment-response （必填）- 来自 x402 协议的支付证明令牌

• Content-Type: application/json

请求体参数：

参数	类型	是否必填	默认	描述
symbol	字符串	是	-	交易符号（例如，"BTC"、"ETH"、"SOL"）
style	字符串	否	"scalping"	交易风格："scalping"（剥头皮）、"day-trading"（日内交易）或 "swing-trading"（波段交易）
marginUSD	数字	否	1000	以美元计的保证金
leverage	数字	否	10	杠杆倍数（最大：40）
strategy	字符串	否	"max-profit"	策略类型（更多策略即将推出）

请求示例

curl -X POST https://x402.minara.ai/x402/perp-trading-suggestion \
  -H "x-payment-response: <payment_proof_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "symbol": "BTC",
    "style": "day-trading",
    "marginUSD": 1000,
    "leverage": 10,
    "strategy": "max-profit"
  }'

响应

状态： 201 Created

{
  "entryPrice": 98450,
  "side": "long",
  "stopLossPrice": 96200,
  "takeProfitPrice": 102800,
  "confidence": 78,
  "reasons": [
    "BTC broke above key resistance at $97,500 with strong volume",
    "RSI at 62 indicates bullish momentum without being overbought",
    "MACD showing bullish crossover on 4H timeframe",
    "Volume profile shows accumulation at current levels"
  ],
  "risks": [
    "Potential pullback at $100,000 psychological resistance",
    "High volatility expected around upcoming Fed meeting",
    "Funding rates on major exchanges trending higher"
  ]
}

---

预测市场分析（Base 链）

端点： POST /x402/prediction-market-ask

由 AI 驱动的预测市场分析。分析预测市场事件并为每个结果提供概率估计及详细推理。

请求

请求头：

• x-payment-response （必填）- 来自 x402 协议的支付证明令牌

• Content-Type: application/json

请求体参数：

参数	类型	是否必填	默认	描述
link	字符串	是	-	预测市场页面链接（例如，Polymarket 事件 URL）
mode	字符串	是	-	聊天模式："fast" 或 "expert"
only_result	布尔值	否	false	仅返回预测概率，不包含推理
customPrompt	字符串	否	-	用于指导分析的自定义指令

请求示例

curl -X POST https://x402.minara.ai/x402/prediction-market-ask \
  -H "x-payment-response: <payment_proof_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "link": "https://polymarket.com/event/will-there-be-another-us-government-shutdown-by-january-31",
    "mode": "fast",
    "only_result": false,
    "customPrompt": "Focus on recent news and sentiment analysis. Be more conservative in probability estimates."
  }'

响应

状态： 201 Created

{
  "predictions": [
    {
      "outcome": "Donald Trump",
      "yesProb": 0.65,
      "noProb": 0.35
    },
    {
      "outcome": "Kamala Harris",
      "yesProb": 0.3,
      "noProb": 0.7
    }
  ],
  "reasoning": "Based on recent polling data and historical trends, Trump maintains a slight lead in key swing states. However, the race remains highly competitive with significant uncertainty..."
}

---

预测市场分析（Polygon 链）

端点： POST /x402/polygon/prediction-market-ask

在 Polygon 链上的 AI 驱动预测市场分析。功能与 Base 链端点相同。

请求

请求头：

• x-payment-response （必填）- 来自 x402 协议的支付证明令牌

• Content-Type: application/json

请求体参数：

与上述 Base 链端点相同。

请求示例

curl -X POST https://x402.minara.ai/x402/polygon/prediction-market-ask \
  -H "x-payment-response: <payment_proof_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "link": "https://polymarket.com/event/will-there-be-another-us-government-shutdown-by-january-31",
    "mode": "fast",
    "only_result": false
  }'

响应

状态： 201 Created

与 Base 链端点相同的响应格式。

---

错误响应

402 需付款

初始请求未包含支付凭证将返回：

{
  "error": "payment_required",
  "message": "Payment required to access this resource",
  "paymentInstructions": {
    "amount": "0.20",
    "currency": "USDC",
    "recipient": "0x...",
    "chain": "base"
  }
}

401 未经授权

无效或已过期的支付证明：

{
  "error": "unauthorized",
  "message": "Invalid payment response token"
}

400 错误请求

请求参数无效：

{
  "error": "bad_request",
  "message": "Missing required parameter: userQuery"
}

---

速率限制

x402 端点按钱包地址进行速率限制：

• AI 端点： 每分钟 60 次请求

• 交易端点： 每分钟 30 次请求

超过速率限制将返回：

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Please try again in 30 seconds.",
  "retryAfter": 30
}

---

注意

• 所有 x402 端点在完成支付挑战后都需要 x-payment-response 该请求头

• 价格可能会根据网络状况发生变化

• 有关 x402 协议的更多信息，请参见 x402 文档