Справочник API (x402)

API разработчика x402

Технические спецификации конечных точек x402 Minara с использованием модели Pay-As-You-Go.

Базовый URL: https://x402.minara.ai

Chat (Base Chain)

post

Ask Minara AI - Intelligent crypto assistant

Authorizations

x-payment-responsestringRequired

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

Body

userQuerystringRequired

Required. User query content.

Responses

201

Successful response

application/json

contentstringOptional

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

Authorizations

x-payment-responsestringRequired

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

Body

userQuerystringRequired

Required. User query content.

Responses

201

Successful response

application/json

contentstringOptional

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

Authorizations

x-payment-responsestringRequired

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

Body

userQuerystringRequired

Required. User query content.

Responses

201

Successful response

application/json

contentstringOptional

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

Authorizations

x-payment-responsestringRequired

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

Body

userQuerystringRequired

Required. User query content.

Responses

201

Successful response

application/json

contentstringOptional

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

Authorizations

x-payment-responsestringRequired

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

Body

userQuerystringRequired

Required. User query content.

Responses

201

Successful response

application/json

contentstringOptional

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

Authorizations

x-payment-responsestringRequired

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

Body

userQuerystringRequired

Required. User query content.

Responses

201

Successful response

application/json

contentstringOptional

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.

Authorizations

x-payment-responsestringRequired

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

Body

symbolstringRequired

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

stylestring · enumOptional

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

Default: scalpingPossible values:

marginUSDnumberOptional

Optional. Margin in USD. Default: 1000.

Default: 1000

leveragenumber · min: 1 · max: 40Optional

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

Default: 10

strategystringOptional

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

Default: max-profit

Responses

201

Successful response

application/json

entryPricenumberOptional

Recommended entry price.

sidestring · enumOptional

Trading side recommendation.

Possible values:

stopLossPricenumberOptional

Recommended stop loss price.

takeProfitPricenumberOptional

Recommended take profit price.

confidencenumber · max: 100Optional

Confidence score (0-100).

reasonsstring[]Optional

Analysis reasons based on technical indicators.

risksstring[]Optional

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.

Authorizations

x-payment-responsestringRequired

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

Body

intentstringRequired

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

walletAddressstringRequired

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

chainstringOptional

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

Responses

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.

Authorizations

x-payment-responsestringRequired

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

Body

linkstringRequired

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

modestring · enumRequired

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

Possible values:

only_resultbooleanOptional

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

Default: false

customPromptstringOptional

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

Responses

201

Successful response

application/json

reasoningstringOptional

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

string

Да

Содержимое пользовательского запроса

Пример запроса

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 Создано

{
  "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

string

Да

Содержимое пользовательского запроса

Пример запроса

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 Создано

{
  "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

string

Да

Содержимое пользовательского запроса

Пример запроса

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 Создано

{
  "content": "Самые трендовые токены Solana:\n1. WIF - рост на 24% при объеме $45M за 24ч\n2. BONK - рост на 18% при высокой активности сообщества\n3. JUP - консолидация после недавнего пампа, объем $38M..."
}

Чат-эксперт (сеть Solana)

Конечная точка: POST /x402/solana/chat/expert

Спросите Minara AI - интеллектуального крипто-ассистента в сети Solana в режиме эксперта

Запрос

Заголовки:

x-payment-response (обязательно) - токен подтверждения оплаты из протокола x402
Content-Type: application/json

Параметры тела:

Параметр

Тип

Требуется

Описание

userQuery

string

Да

Содержимое пользовательского запроса

Пример запроса

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 Создано

{
  "content": "**Глубокий анализ токена JUP**\n\n**Распределение ликвидности**: Общая ликвидность на основных DEX составляет $125M, при этом 65% сосредоточено в диапазоне $0.85-$0.92...\n\n**Активность китов**: Топ-10 держателей контролируют 34% предложения. За последние 24ч обнаружено 3 значимые транзакции китов на общую сумму $4.2M в покупках...\n\n**Оценка риска**: Умеренный риск ликвидности выше отметки $1.00. Учитывайте это при размере позиции..."
}

Чат (сеть Polygon)

Конечная точка: POST /x402/polygon/chat

Спросите Minara AI - интеллектуального крипто-ассистента в сети Polygon

Запрос

Заголовки:

x-payment-response (обязательно) - токен подтверждения оплаты из протокола x402
Content-Type: application/json

Параметры тела:

Параметр

Тип

Требуется

Описание

userQuery

string

Да

Содержимое пользовательского запроса

Пример запроса

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 Создано

{
  "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

string

Да

Содержимое пользовательского запроса

Пример запроса

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 Создано

{
  "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

Преобразуйте торговое намерение на естественном языке в исполняемый полезный payload транзакции обмена. По умолчанию совместимо с OKX DEX.

Запрос

Заголовки:

x-payment-response (обязательно) - токен подтверждения оплаты из протокола x402
Content-Type: application/json

Параметры тела:

Параметр

Тип

Требуется

Описание

intent

string

Да

Намерение свопа на естественном языке (например, "обменяй 0.1 ETH на USDC")

walletAddress

string

Да

Адрес кошелька пользователя (0x...)

chain

string

Нет

Имя сети (например, "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 Создано

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

Анализ рынка прогнозов (сеть Base)

Конечная точка: POST /x402/prediction-market-ask

Анализ рынка прогнозов на базе ИИ. Анализируйте события рынка прогнозов и получайте оценки вероятностей для каждого исхода с подробным обоснованием.

Запрос

Заголовки:

x-payment-response (обязательно) - токен подтверждения оплаты из протокола x402
Content-Type: application/json

Параметры тела:

Параметр

Тип

Требуется

По умолчанию

Описание

link

string

Да

Ссылка на страницу рынка прогнозов (например, URL события Polymarket)

mode

string

Да

Режим чата: "fast" или "expert"

only_result

boolean

Нет

false

Возвращайте только вероятности прогнозов без обоснования

customPrompt

string

Нет

Пользовательские инструкции для направления анализа

Пример запроса

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 Создано

{
  "predictions": [
    {
      "outcome": "Donald Trump",
      "yesProb": 0.65,
      "noProb": 0.35
    },
    {
      "outcome": "Kamala Harris",
      "yesProb": 0.3,
      "noProb": 0.7
    }
  ],
  "reasoning": "На основе последних данных опросов и исторических тенденций Трамп сохраняет небольшое преимущество в ключевых колеблющихся штатах. Однако гонка остается крайне конкурентной, с высокой степенью неопределенности..."
}

Анализ рынка прогнозов (сеть Polygon)

Конечная точка: POST /x402/polygon/prediction-market-ask

Анализ рынка прогнозов на базе ИИ в сети Polygon. Та же функциональность, что и у конечной точки Base chain.

Запрос

Заголовки:

x-payment-response (обязательно) - токен подтверждения оплаты из протокола x402
Content-Type: application/json

Параметры тела:

То же, что и у конечной точки Base chain выше.

Пример запроса

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 Создано

Такой же формат ответа, как и у конечной точки Base chain.

Ответы с ошибками

402 Требуется оплата

При первоначальном запросе без платежных учетных данных будет возвращено:

{
  "error": "payment_required",
  "message": "Требуется оплата для доступа к этому ресурсу",
  "paymentInstructions": {
    "amount": "0.20",
    "currency": "USDC",
    "recipient": "0x...",
    "chain": "base"
  }
}

401 Неавторизовано

Недействительное или просроченное подтверждение оплаты:

{
  "error": "unauthorized",
  "message": "Недействительный токен ответа об оплате"
}

400 Неверный запрос

Недопустимые параметры запроса:

{
  "error": "bad_request",
  "message": "Отсутствует обязательный параметр: userQuery"
}

Ограничения по частоте запросов

Для конечных точек x402 действует ограничение частоты запросов по адресу кошелька:

Конечные точки ИИ: 60 запросов в минуту
Торговые конечные точки: 30 запросов в минуту

При превышении лимита будет возвращено:

{
  "error": "rate_limit_exceeded",
  "message": "Слишком много запросов. Пожалуйста, попробуйте снова через 30 секунд.",
  "retryAfter": 30
}

Примечания

Для всех конечных точек x402 требуется x-payment-response заголовок после завершения платежного челленджа
Цены могут изменяться в зависимости от состояния сети
Для получения дополнительной информации о протоколе x402 см. Документация x402

ПредыдущаяСправочник API (API-ключ)СледующаяЛиквидность

Последнее обновление 1 месяц назад

Это было полезно?

Добрый день

API разработчика x402

Chat (Base Chain)

Chat Expert (Base Chain)

Chat (Polygon Chain)

Chat Expert (Polygon Chain)

Chat (Solana Chain)

Chat Expert (Solana Chain)

Perpetual Trading Suggestion

Intent to Swap Transaction

Prediction Market Analysis (Base Chain)

Конечные точки

Чат (сеть Base)

Запрос

Пример запроса

Ответ

Чат-эксперт (сеть Base)

Запрос

Пример запроса

Ответ

Чат (сеть Solana)

Запрос

Пример запроса

Ответ

Чат-эксперт (сеть Solana)

Запрос

Пример запроса

Ответ

Чат (сеть Polygon)

Запрос

Пример запроса

Ответ

Чат-эксперт (сеть Polygon)

Запрос

Пример запроса

Ответ

Торговые конечные точки

Транзакция по намерению обмена

Запрос

Пример запроса

Ответ

Рекомендация по бессрочной торговле

Запрос

Пример запроса

Ответ

Анализ рынка прогнозов (сеть Base)

Запрос

Пример запроса

Ответ

Анализ рынка прогнозов (сеть Polygon)

Запрос

Пример запроса

Ответ

Ответы с ошибками

402 Требуется оплата

401 Неавторизовано

400 Неверный запрос

Ограничения по частоте запросов

Примечания