Referencia de la API (x402)

API x402 para desarrolladores

Especificaciones técnicas de los endpoints x402 de Minara usando el modelo de pago por uso.

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

Puntos finales

Chat (cadena Base)

Punto final: 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
Requerido
Descripción

userQuery

string

Contenido de la consulta del usuario

Ejemplo de solicitud

Respuesta

Estado: 201 Creado


Chat experto (cadena Base)

Punto final: POST /x402/chat/expert

Pregunta 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
Requerido
Descripción

userQuery

string

Contenido de la consulta del usuario

Ejemplo de solicitud

Respuesta

Estado: 201 Creado


Chat (cadena Solana)

Punto final: 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
Requerido
Descripción

userQuery

string

Contenido de la consulta del usuario

Ejemplo de solicitud

Respuesta

Estado: 201 Creado

Chat experto (cadena Solana)

Punto final: POST /x402/solana/chat/expert

Pregunta 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
Requerido
Descripción

userQuery

string

Contenido de la consulta del usuario

Ejemplo de solicitud

Respuesta

Estado: 201 Creado


Chat (cadena Polygon)

Punto final: POST /x402/polygon/chat

Pregunta 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
Requerido
Descripción

userQuery

string

Contenido de la consulta del usuario

Ejemplo de solicitud

Respuesta

Estado: 201 Creado


Chat experto (cadena Polygon)

Punto final: POST /x402/polygon/chat/expert

Pregunta 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
Requerido
Descripción

userQuery

string

Contenido de la consulta del usuario

Ejemplo de solicitud

Respuesta

Estado: 201 Creado


Endpoints de trading

Transacción de intención de swap

Punto final: 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
Requerido
Descripción

intent

string

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

walletAddress

string

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

chain

string

No

Nombre de la cadena (p. ej., "base", "ethereum", "bsc", "arbitrum", "optimism")

Ejemplo de solicitud

Respuesta

Estado: 201 Creado


Sugerencia de trading perpetuo

Punto final: POST /x402/perp-trading-suggestion

Obtén sugerencias de trading perpetuo potenciadas por IA con recomendaciones de largo/corto, precio de entrada, stop loss, niveles de take profit y puntuación de confianza basadas en un análisis exhaustivo del mercado.

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
Requerido
Por defecto
Descripción

symbol

string

-

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

style

string

No

"scalping"

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

marginUSD

number

No

1000

Margen en USD

leverage

number

No

10

Multiplicador de apalancamiento (máx.: 40)

strategy

string

No

"max-profit"

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

Ejemplo de solicitud

Respuesta

Estado: 201 Creado


Análisis del mercado de predicción (cadena Base)

Punto final: POST /x402/prediction-market-ask

Análisis del mercado de predicción potenciado por IA. Analiza los eventos del mercado de predicción y obtén 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
Requerido
Por defecto
Descripción

link

string

-

Enlace de la página del mercado de predicción (p. ej., URL del evento de Polymarket)

mode

string

-

Modo de chat: "fast" o "expert"

only_result

boolean

No

false

Devuelve solo las probabilidades de predicción sin razonamiento

customPrompt

string

No

-

Instrucciones personalizadas para guiar el análisis

Ejemplo de solicitud

Respuesta

Estado: 201 Creado


Análisis del mercado de predicción (cadena Polygon)

Punto final: POST /x402/polygon/prediction-market-ask

Análisis del mercado de predicción potenciado por IA en la cadena Polygon. La 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 de arriba.

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 caducada:

400 Solicitud incorrecta

Parámetros de solicitud inválidos:


Límites de tasa

Los endpoints x402 tienen límites de tasa por dirección de billetera:

  • Endpoints de IA: 60 solicitudes por minuto

  • Endpoints de trading: 30 solicitudes por minuto

Superar 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 obtener más información sobre el protocolo x402, consulta Documentación de x402

Última actualización

¿Te fue útil?