Referencia de la API (x402)

API Developer x402

Especificaciones técnicas para los endpoints x402 de Minara usando el modelo Pay-As-You-Go.

URL base: https://x402.minara.ai

Chat (Base Chain)

post

Ask Minara AI - Intelligent crypto assistant

Autorizaciones
x-payment-responsestringRequerido

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

Cuerpo
userQuerystringRequerido

Required. User query content.

Respuestas
post
/x402/chat

Chat Expert (Base Chain)

post

Ask Minara AI - Intelligent crypto assistant

Autorizaciones
x-payment-responsestringRequerido

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

Cuerpo
userQuerystringRequerido

Required. User query content.

Respuestas
post
/x402/chat/expert

Chat (Polygon Chain)

post

Ask Minara AI - Intelligent crypto assistant

Autorizaciones
x-payment-responsestringRequerido

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

Cuerpo
userQuerystringRequerido

Required. User query content.

Respuestas
post
/x402/polygon/chat

Chat Expert (Polygon Chain)

post

Ask Minara AI - Intelligent crypto assistant

Autorizaciones
x-payment-responsestringRequerido

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

Cuerpo
userQuerystringRequerido

Required. User query content.

Respuestas
post
/x402/polygon/chat/expert

Chat (Solana Chain)

post

Ask Minara AI - Intelligent crypto assistant

Autorizaciones
x-payment-responsestringRequerido

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

Cuerpo
userQuerystringRequerido

Required. User query content.

Respuestas
post
/x402/solana/chat

Chat Expert (Solana Chain)

post

Ask Minara AI - Intelligent crypto assistant

Autorizaciones
x-payment-responsestringRequerido

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

Cuerpo
userQuerystringRequerido

Required. User query content.

Respuestas
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.

Autorizaciones
x-payment-responsestringRequerido

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

Cuerpo
symbolstringRequerido

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

stylestring · enumOpcional

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

Default: scalpingValores posibles:
marginUSDnumberOpcional

Optional. Margin in USD. Default: 1000.

Default: 1000
leveragenumber · mín: 1 · máx: 40Opcional

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

Default: 10
strategystringOpcional

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

Default: max-profit
Respuestas
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.

Autorizaciones
x-payment-responsestringRequerido

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

Cuerpo
intentstringRequerido

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

walletAddressstringRequerido

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

chainstringOpcional

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

Respuestas
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.

Autorizaciones
x-payment-responsestringRequerido

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

Cuerpo
linkstringRequerido

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

modestring · enumRequerido

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

Valores posibles:
only_resultbooleanOpcional

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

Default: false
customPromptstringOpcional

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

Respuestas
post
/x402/prediction-market-ask

Endpoints

Chat (Base Chain)

Endpoint: POST /x402/chat

Solicitud

Encabezados:

  • x-payment-response (obligatorio) - Token de prueba de pago del protocolo x402

  • Content-Type: application/json

Parámetros del cuerpo:

Parámetro
Tipo
Obligatorio
Descripción

userQuery

cadena

Contenido de la consulta del usuario

Ejemplo de solicitud

Respuesta

Estado: 201 Creado


Chat Expert (Base Chain)

Endpoint: POST /x402/chat/expert

Preguntar a Minara AI - Asistente cripto inteligente en la cadena Base con modo experto

Solicitud

Encabezados:

  • x-payment-response (obligatorio) - Token de prueba de pago del protocolo x402

  • Content-Type: application/json

Parámetros del cuerpo:

Parámetro
Tipo
Obligatorio
Descripción

userQuery

cadena

Contenido de la consulta del usuario

Ejemplo de solicitud

Respuesta

Estado: 201 Creado


Chat (Solana Chain)

Endpoint: POST /x402/solana/chat

Solicitud

Encabezados:

  • x-payment-response (obligatorio) - Token de prueba de pago del protocolo x402

  • Content-Type: application/json

Parámetros del cuerpo:

Parámetro
Tipo
Obligatorio
Descripción

userQuery

cadena

Contenido de la consulta del usuario

Ejemplo de solicitud

Respuesta

Estado: 201 Creado

Chat Expert (Solana Chain)

Endpoint: POST /x402/solana/chat/expert

Preguntar a Minara AI - Asistente cripto inteligente en la cadena Solana con modo experto

Solicitud

Encabezados:

  • x-payment-response (obligatorio) - Token de prueba de pago del protocolo x402

  • Content-Type: application/json

Parámetros del cuerpo:

Parámetro
Tipo
Obligatorio
Descripción

userQuery

cadena

Contenido de la consulta del usuario

Ejemplo de solicitud

Respuesta

Estado: 201 Creado


Chat (Polygon Chain)

Endpoint: POST /x402/polygon/chat

Preguntar a Minara AI - Asistente cripto inteligente en la cadena Polygon

Solicitud

Encabezados:

  • x-payment-response (obligatorio) - Token de prueba de pago del protocolo x402

  • Content-Type: application/json

Parámetros del cuerpo:

Parámetro
Tipo
Obligatorio
Descripción

userQuery

cadena

Contenido de la consulta del usuario

Ejemplo de solicitud

Respuesta

Estado: 201 Creado


Chat Expert (Polygon Chain)

Endpoint: POST /x402/polygon/chat/expert

Preguntar a Minara AI - Asistente cripto inteligente en la cadena Polygon con modo experto

Solicitud

Encabezados:

  • x-payment-response (obligatorio) - Token de prueba de pago del protocolo x402

  • Content-Type: application/json

Parámetros del cuerpo:

Parámetro
Tipo
Obligatorio
Descripción

userQuery

cadena

Contenido de la consulta del usuario

Ejemplo de solicitud

Respuesta

Estado: 201 Creado


Endpoints de Trading

Intención de Transacción de Swap

Endpoint: POST /x402/intent-to-swap-tx

Convierte la intención de trading en lenguaje natural en una carga útil de transacción de swap ejecutable. Compatible con OKX DEX por defecto.

Solicitud

Encabezados:

  • x-payment-response (obligatorio) - Token de prueba de pago del protocolo x402

  • Content-Type: application/json

Parámetros del cuerpo:

Parámetro
Tipo
Obligatorio
Descripción

intent

cadena

Intención de swap en lenguaje natural (por ejemplo, "swap 0.1 ETH a USDC")

walletAddress

cadena

Dirección de la cartera del usuario (0x...)

chain

cadena

No

Nombre de la cadena (por ejemplo, "base", "ethereum", "bsc", "arbitrum", "optimism")

Ejemplo de solicitud

Respuesta

Estado: 201 Creado


Sugerencia de Trading de Perpetuos

Endpoint: POST /x402/perp-trading-suggestion

Obtén sugerencias de trading de perpetuos con IA con recomendaciones long/short, precio de entrada, stop loss, niveles de take profit y puntuación de confianza basada en un análisis de mercado integral.

Solicitud

Encabezados:

  • x-payment-response (obligatorio) - Token de prueba de pago del protocolo x402

  • Content-Type: application/json

Parámetros del cuerpo:

Parámetro
Tipo
Obligatorio
Predeterminado
Descripción

symbol

cadena

-

Símbolo de trading (por ejemplo, "BTC", "ETH", "SOL")

style

cadena

No

"scalping"

Estilo de trading: "scalping", "day-trading" o "swing-trading"

marginUSD

número

No

1000

Margen en USD

leverage

número

No

10

Multiplicador de apalancamiento (máx.: 40)

strategy

cadena

No

"max-profit"

Tipo de estrategia (más estrategias próximamente)

Ejemplo de solicitud

Respuesta

Estado: 201 Creado


Análisis de Mercado de Predicción (Base Chain)

Endpoint: POST /x402/prediction-market-ask

Análisis de mercados de predicción impulsado por IA. Analiza eventos de mercados de predicción y obtiene estimaciones de probabilidad para cada resultado con razonamiento detallado.

Solicitud

Encabezados:

  • x-payment-response (obligatorio) - Token de prueba de pago del protocolo x402

  • Content-Type: application/json

Parámetros del cuerpo:

Parámetro
Tipo
Obligatorio
Predeterminado
Descripción

link

cadena

-

Enlace a la página del mercado de predicción (por ejemplo, URL de evento en Polymarket)

mode

cadena

-

Modo de chat: "fast" o "expert"

only_result

booleano

No

false

Solo devolver probabilidades de predicción sin razonamiento

customPrompt

cadena

No

-

Instrucciones personalizadas para guiar el análisis

Ejemplo de solicitud

Respuesta

Estado: 201 Creado


Análisis de Mercado de Predicción (Polygon Chain)

Endpoint: POST /x402/polygon/prediction-market-ask

Análisis de mercados de predicción impulsado por IA en la cadena Polygon. Misma funcionalidad que el endpoint de la cadena Base.

Solicitud

Encabezados:

  • x-payment-response (obligatorio) - Token de prueba de pago del protocolo x402

  • Content-Type: application/json

Parámetros del cuerpo:

Igual que el endpoint de la cadena Base anterior.

Ejemplo de solicitud

Respuesta

Estado: 201 Creado

Mismo formato de respuesta que el endpoint de la cadena Base.


Respuestas de error

402 Pago requerido

La solicitud inicial sin credenciales de pago devolverá:

401 No autorizado

Prueba de pago inválida o expirada:

400 Solicitud incorrecta

Parámetros de solicitud inválidos:


Límites de tasa

Los endpoints x402 tienen límite de tasa por dirección de cartera:

  • Endpoints de IA: 60 solicitudes por minuto

  • Endpoints de Trading: 30 solicitudes por minuto

Exceder los límites de tasa devolverá:


Notas

  • Todos los endpoints x402 requieren el x-payment-response encabezado después de completar el desafío de pago

  • Los precios están sujetos a cambios según las condiciones de la red

  • Para más información sobre el protocolo x402, ver Documentación x402arrow-up-right

Última actualización

¿Te fue útil?