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

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

Технические спецификации конечных точек Minara x402 с использованием модели 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
post
/x402/chat

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
post
/x402/chat/expert

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
post
/x402/polygon/chat

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
post
/x402/polygon/chat/expert

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
post
/x402/solana/chat

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
post
/x402/solana/chat/expert

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
post
/x402/perp-trading-suggestion

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
post
/x402/intent-to-swap-tx

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
post
/x402/prediction-market-ask

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

Чат (Base Chain)

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

Запрос

Заголовки:

  • x-payment-response (обязательно) - токен подтверждения оплаты из протокола x402

  • Content-Type: application/json

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

Параметр
Тип
Обязательно
Описание

userQuery

строка

Да

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

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

Ответ

Статус: 201 Created


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

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

Спросите Minara AI — интеллектуальный крипто-ассистент в сети Base с режимом эксперта

Запрос

Заголовки:

  • x-payment-response (обязательно) - токен подтверждения оплаты из протокола x402

  • Content-Type: application/json

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

Параметр
Тип
Обязательно
Описание

userQuery

строка

Да

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

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

Ответ

Статус: 201 Created


Чат (Solana Chain)

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

Запрос

Заголовки:

  • x-payment-response (обязательно) - токен подтверждения оплаты из протокола x402

  • Content-Type: application/json

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

Параметр
Тип
Обязательно
Описание

userQuery

строка

Да

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

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

Ответ

Статус: 201 Created

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

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

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

Запрос

Заголовки:

  • x-payment-response (обязательно) - токен подтверждения оплаты из протокола x402

  • Content-Type: application/json

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

Параметр
Тип
Обязательно
Описание

userQuery

строка

Да

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

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

Ответ

Статус: 201 Created


Чат (Polygon Chain)

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

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

Запрос

Заголовки:

  • x-payment-response (обязательно) - токен подтверждения оплаты из протокола x402

  • Content-Type: application/json

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

Параметр
Тип
Обязательно
Описание

userQuery

строка

Да

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

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

Ответ

Статус: 201 Created


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

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

Спросите Minara AI — интеллектуальный крипто-ассистент в сети Polygon с режимом эксперта

Запрос

Заголовки:

  • x-payment-response (обязательно) - токен подтверждения оплаты из протокола x402

  • Content-Type: application/json

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

Параметр
Тип
Обязательно
Описание

userQuery

строка

Да

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

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

Ответ

Статус: 201 Created


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

Intent to Swap Транзакция

Конечная точка: 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")

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

Ответ

Статус: 201 Created


Предложение по перпетуальной торговле

Конечная точка: POST /x402/perp-trading-suggestion

Получите рекомендации по перпетуальной торговле на основе ИИ с рекомендациями по длинным/коротким позициям, ценой входа, стоп-лоссом, целями по прибыли и оценкой уверенности на основе комплексного анализа рынка.

Запрос

Заголовки:

  • x-payment-response (обязательно) - токен подтверждения оплаты из протокола x402

  • Content-Type: application/json

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

Параметр
Тип
Обязательно
По умолчанию
Описание

symbol

строка

Да

-

Торговый символ (например, "BTC", "ETH", "SOL")

style

строка

Нет

"scalping"

Торговый стиль: "scalping", "day-trading" или "swing-trading"

marginUSD

число

Нет

1000

Маржа в USD

leverage

число

Нет

10

Коэффициент кредитного плеча (макс.: 40)

strategy

строка

Нет

"max-profit"

Тип стратегии (в будущем добавятся дополнительные стратегии)

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

Ответ

Статус: 201 Created


Анализ рынка предсказаний (Base Chain)

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

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

Запрос

Заголовки:

  • x-payment-response (обязательно) - токен подтверждения оплаты из протокола x402

  • Content-Type: application/json

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

Параметр
Тип
Обязательно
По умолчанию
Описание

link

строка

Да

-

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

mode

строка

Да

-

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

only_result

boolean

Нет

false

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

customPrompt

строка

Нет

-

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

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

Ответ

Статус: 201 Created


Анализ рынка предсказаний (Polygon Chain)

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

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

Запрос

Заголовки:

  • x-payment-response (обязательно) - токен подтверждения оплаты из протокола x402

  • Content-Type: application/json

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

То же, что и конечная точка Base, указанная выше.

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

Ответ

Статус: 201 Created

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


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

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

Первоначальный запрос без платёжных данных вернёт:

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

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

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

Неверные параметры запроса:


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

Конечные точки x402 ограничены по частоте для каждого адреса кошелька:

  • AI конечные точки: 60 запросов в минуту

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

Превышение лимитов частоты вернёт:


Примечания

  • Все конечные точки x402 требуют x-payment-response заголовка после завершения платёжного челленджа

  • Цены могут изменяться в зависимости от условий сети

  • Для получения дополнительной информации о протоколе x402 смотрите Документация x402arrow-up-right

Последнее обновление

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