API 参考文档（x402）

开发者 x402 API

Minara 的 x402 端点技术规范，采用按需付费模型。

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

Chat (Base Chain)

post

Ask Minara AI - Intelligent crypto assistant

授权

x-payment-responsestring必填

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

请求体

userQuerystring必填

Required. User query content.

响应

201

Successful response

application/json

contentstring可选

AI response content.

400

Bad Request - Invalid parameters

application/json

401

Unauthorized - Invalid payment response token

application/json

402

Payment Required

application/json

post/x402/chat

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

授权

x-payment-responsestring必填

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

请求体

userQuerystring必填

Required. User query content.

响应

201

Successful response

application/json

contentstring可选

AI response content.

400

Bad Request - Invalid parameters

401

Unauthorized - Invalid payment response token

402

Payment Required

application/json

post/x402/chat/expert

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

授权

x-payment-responsestring必填

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

请求体

userQuerystring必填

Required. User query content.

响应

201

Successful response

application/json

contentstring可选

AI response content.

400

Bad Request - Invalid parameters

application/json

401

Unauthorized - Invalid payment response token

application/json

402

Payment Required

application/json

post/x402/polygon/chat

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

授权

x-payment-responsestring必填

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

请求体

userQuerystring必填

Required. User query content.

响应

201

Successful response

application/json

contentstring可选

AI response content.

400

Bad Request - Invalid parameters

401

Unauthorized - Invalid payment response token

402

Payment Required

application/json

post/x402/polygon/chat/expert

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

授权

x-payment-responsestring必填

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

请求体

userQuerystring必填

Required. User query content.

响应

201

Successful response

application/json

contentstring可选

AI response content.

400

Bad Request - Invalid parameters

401

Unauthorized - Invalid payment response token

402

Payment Required

application/json

post/x402/solana/chat

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

授权

x-payment-responsestring必填

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

请求体

userQuerystring必填

Required. User query content.

响应

201

Successful response

application/json

contentstring可选

AI response content.

400

Bad Request - Invalid parameters

401

Unauthorized - Invalid payment response token

402

Payment Required

application/json

post/x402/solana/chat/expert

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.

授权

x-payment-responsestring必填

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

请求体

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

entryPricenumber可选

Recommended entry price.

sidestring · enum可选

Trading side recommendation.

可能的值:

stopLossPricenumber可选

Recommended stop loss price.

takeProfitPricenumber可选

Recommended take profit price.

confidencenumber · 最大值: 100可选

Confidence score (0-100).

reasonsstring[]可选

Analysis reasons based on technical indicators.

risksstring[]可选

Risk factors to consider.

400

Bad Request - Invalid parameters

401

Unauthorized - Invalid payment response token

402

Payment Required

application/json

post/x402/perp-trading-suggestion

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.

授权

x-payment-responsestring必填

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

请求体

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

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.

授权

x-payment-responsestring必填

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

请求体

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

reasoningstring可选

AI reasoning and analysis (empty if only_result=true).

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

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": "BTC 当前价格是多少，关键支撑位有哪些？"
  }'

响应

状态： 201 Created

{
  "content": "BTC 目前交易价格为 98,450 美元。关键支撑位在 96,500 和 94,200 美元。近期在强劲成交量下突破 97,000 美元，表明看涨延续..."
}

聊天专家（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": "请提供 ETH 的全面分析，包括链上指标和交易策略"
  }'

响应

状态： 201 Created

{
  "content": "ETH 全面分析：\n\n**价格走势**：ETH 目前交易价格为 3,420 美元，正在 3,400-3,500 美元区间附近盘整...\n\n**链上指标**：活跃地址环比增长 12%，表明网络活动正在增强...\n\n**交易策略**：可考虑在回调至 3,300 美元支撑位时逐步买入，目标位为 3,600 和 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": "显示当前 Solana 上最热门的代币"
  }'

响应

状态： 201 Created

{
  "content": "Solana 当前热门代币：\n1. WIF - 上涨 24%，24 小时成交量 4500 万美元\n2. BONK - 上涨 18%，社区活跃度强劲\n3. JUP - 近期拉升后正在盘整，成交量达 3800 万美元..."
}

聊天专家（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": "分析 JUP 代币的流动性分布和鲸鱼动向"
  }'

响应

状态： 201 Created

{
  "content": "**JUP 代币深度分析**\n\n**流动性分布**：主要 DEX 的总流动性为 1.25 亿美元，其中 65% 集中在 0.85-0.92 美元区间...\n\n**鲸鱼活动**：前 10 大持仓地址控制了 34% 的供应量。过去 24 小时内检测到 3 笔显著鲸鱼交易，累计买入 420 万美元...\n\n**风险评估**：超过 1.00 美元关口后流动性风险中等。制定仓位规模时应考虑这一点..."
}

聊天（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": "BTC 当前价格是多少，关键支撑位有哪些？"
  }'

响应

状态： 201 Created

{
  "content": "BTC 目前交易价格为 98,450 美元。关键支撑位在 96,500 和 94,200 美元。近期在强劲成交量下突破 97,000 美元，表明看涨延续..."
}

聊天专家（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": "请提供 ETH 的全面分析，包括链上指标和交易策略"
  }'

响应

状态： 201 Created

{
  "content": "**ETH 全面分析**\n\n**价格走势**：ETH 目前交易价格为 3,420 美元，正在 3,400-3,500 美元区间附近盘整...\n\n**链上指标**：活跃地址环比增长 12%，表明网络活动正在增强...\n\n**交易策略**：可考虑在回调至 3,300 美元支撑位时逐步买入，目标位为 3,600 和 3,850 美元..."
}

交易端点

兑换意图交易

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

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

请求

请求头：

x-payment-response （必填）- 来自 x402 协议的支付证明令牌
Content-Type: application/json

请求体参数：

参数

类型

必填

描述

intent

字符串

是

自然语言兑换意图（例如，“将 0.1 ETH 兑换为 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": "将 0.1 ETH 兑换为 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

数字

否

杠杆倍数（最大：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 在强劲成交量下突破了 97,500 美元的关键阻力位",
    "RSI 为 62，表明看涨动能仍在，但尚未超买",
    "MACD 在 4 小时时间框架上显示看涨交叉",
    "成交量分布显示当前价位正在吸筹"
  ],
  "risks": [
    "在 100,000 美元这一心理阻力位附近可能回调",
    "即将到来的美联储会议周围预计波动性较高",
    "主要交易所的资金费率呈上升趋势"
  ]
}

预测市场分析（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": "聚焦近期新闻和情绪分析。概率估计更保守一些。"
  }'

响应

状态： 201 Created

{
  "predictions": [
    {
      "outcome": "Donald Trump",
      "yesProb": 0.65,
      "noProb": 0.35
    },
    {
      "outcome": "Kamala Harris",
      "yesProb": 0.3,
      "noProb": 0.7
    }
  ],
  "reasoning": "根据近期民调数据和历史趋势，Trump 在关键摇摆州仍保持微弱领先。然而，竞选仍然高度胶着，存在很大不确定性..."
}

预测市场分析（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": "访问此资源需要支付",
  "paymentInstructions": {
    "amount": "0.20",
    "currency": "USDC",
    "recipient": "0x...",
    "chain": "base"
  }
}

401 Unauthorized

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

{
  "error": "unauthorized",
  "message": "无效的支付响应令牌"
}

400 Bad Request

无效的请求参数：

{
  "error": "bad_request",
  "message": "缺少必填参数：userQuery"
}

速率限制

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

AI 端点： 每分钟 60 个请求
交易端点： 每分钟 30 个请求

超出速率限制将返回：

{
  "error": "rate_limit_exceeded",
  "message": "请求过多。请在 30 秒后重试。",
  "retryAfter": 30
}

备注

所有 x402 端点都需要 x-payment-response 在完成支付挑战后提供该请求头
价格可能会根据网络状况变化
有关 x402 协议的更多信息，请参阅 x402 文档

上一页API 参考文档（API 密钥）下一页流动性

最后更新于 1个月前

这有帮助吗？