> For the complete documentation index, see [llms.txt](https://minara.ai/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://minara.ai/docs/minara-handbook/es/operar/agent-api/api-reference-x402.md). # Referencia de la API (x402) ### API x402 para desarrolladores Especificaciones técnicas para los endpoints x402 de Minara usando el modelo de pago por uso. **URL base**: `https://x402.minara.ai` ## Chat (Base Chain) > Ask Minara AI - Intelligent crypto assistant ```json {"openapi":"3.0.0","info":{"title":"Minara x402 API","version":"1.0"},"servers":[{"url":"https://x402.minara.ai"}],"security":[{"x402Payment":[]}],"components":{"securitySchemes":{"x402Payment":{"type":"apiKey","in":"header","name":"x-payment-response","description":"Payment proof token obtained from x402 payment challenge flow. Required after completing payment."}},"schemas":{"ChatRequest":{"type":"object","required":["userQuery"],"properties":{"userQuery":{"type":"string","description":"Required. User query content."}}},"ChatResponse":{"type":"object","properties":{"content":{"type":"string","description":"AI response content."}}},"BadRequestError":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"UnauthorizedError":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"PaymentRequiredError":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"paymentInstructions":{"type":"object","properties":{"amount":{"type":"string","description":"Payment amount required."},"currency":{"type":"string","description":"Payment currency (e.g., USDC)."},"recipient":{"type":"string","description":"Payment recipient address."},"chain":{"type":"string","description":"Blockchain for payment."}}}}}}},"paths":{"/x402/chat":{"post":{"summary":"Chat (Base Chain)","description":"Ask Minara AI - Intelligent crypto assistant","operationId":"x402Chat","tags":["AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatResponse"}}}},"400":{"description":"Bad Request - Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}}},"401":{"description":"Unauthorized - Invalid payment response token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredError"}}}}}}}}} ``` ## Chat Expert (Base Chain) > Ask Minara AI - Intelligent crypto assistant ```json {"openapi":"3.0.0","info":{"title":"Minara x402 API","version":"1.0"},"servers":[{"url":"https://x402.minara.ai"}],"security":[{"x402Payment":[]}],"components":{"securitySchemes":{"x402Payment":{"type":"apiKey","in":"header","name":"x-payment-response","description":"Payment proof token obtained from x402 payment challenge flow. Required after completing payment."}},"schemas":{"ChatRequest":{"type":"object","required":["userQuery"],"properties":{"userQuery":{"type":"string","description":"Required. User query content."}}},"ChatResponse":{"type":"object","properties":{"content":{"type":"string","description":"AI response content."}}},"PaymentRequiredError":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"paymentInstructions":{"type":"object","properties":{"amount":{"type":"string","description":"Payment amount required."},"currency":{"type":"string","description":"Payment currency (e.g., USDC)."},"recipient":{"type":"string","description":"Payment recipient address."},"chain":{"type":"string","description":"Blockchain for payment."}}}}}}},"paths":{"/x402/chat/expert":{"post":{"summary":"Chat Expert (Base Chain)","description":"Ask Minara AI - Intelligent crypto assistant","operationId":"x402ChatExpert","tags":["AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatResponse"}}}},"400":{"description":"Bad Request - Invalid parameters"},"401":{"description":"Unauthorized - Invalid payment response token"},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredError"}}}}}}}}} ``` ## Chat (Polygon Chain) > Ask Minara AI - Intelligent crypto assistant ```json {"openapi":"3.0.0","info":{"title":"Minara x402 API","version":"1.0"},"servers":[{"url":"https://x402.minara.ai"}],"security":[{"x402Payment":[]}],"components":{"securitySchemes":{"x402Payment":{"type":"apiKey","in":"header","name":"x-payment-response","description":"Payment proof token obtained from x402 payment challenge flow. Required after completing payment."}},"schemas":{"ChatRequest":{"type":"object","required":["userQuery"],"properties":{"userQuery":{"type":"string","description":"Required. User query content."}}},"ChatResponse":{"type":"object","properties":{"content":{"type":"string","description":"AI response content."}}},"BadRequestError":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"UnauthorizedError":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"PaymentRequiredError":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"paymentInstructions":{"type":"object","properties":{"amount":{"type":"string","description":"Payment amount required."},"currency":{"type":"string","description":"Payment currency (e.g., USDC)."},"recipient":{"type":"string","description":"Payment recipient address."},"chain":{"type":"string","description":"Blockchain for payment."}}}}}}},"paths":{"/x402/polygon/chat":{"post":{"summary":"Chat (Polygon Chain)","description":"Ask Minara AI - Intelligent crypto assistant","operationId":"x402PolygonChat","tags":["AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatResponse"}}}},"400":{"description":"Bad Request - Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}}},"401":{"description":"Unauthorized - Invalid payment response token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredError"}}}}}}}}} ``` ## Chat Expert (Polygon Chain) > Ask Minara AI - Intelligent crypto assistant ```json {"openapi":"3.0.0","info":{"title":"Minara x402 API","version":"1.0"},"servers":[{"url":"https://x402.minara.ai"}],"security":[{"x402Payment":[]}],"components":{"securitySchemes":{"x402Payment":{"type":"apiKey","in":"header","name":"x-payment-response","description":"Payment proof token obtained from x402 payment challenge flow. Required after completing payment."}},"schemas":{"ChatRequest":{"type":"object","required":["userQuery"],"properties":{"userQuery":{"type":"string","description":"Required. User query content."}}},"ChatResponse":{"type":"object","properties":{"content":{"type":"string","description":"AI response content."}}},"PaymentRequiredError":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"paymentInstructions":{"type":"object","properties":{"amount":{"type":"string","description":"Payment amount required."},"currency":{"type":"string","description":"Payment currency (e.g., USDC)."},"recipient":{"type":"string","description":"Payment recipient address."},"chain":{"type":"string","description":"Blockchain for payment."}}}}}}},"paths":{"/x402/polygon/chat/expert":{"post":{"summary":"Chat Expert (Polygon Chain)","description":"Ask Minara AI - Intelligent crypto assistant","operationId":"x402PolygonChatExpert","tags":["AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatResponse"}}}},"400":{"description":"Bad Request - Invalid parameters"},"401":{"description":"Unauthorized - Invalid payment response token"},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredError"}}}}}}}}} ``` ## Chat (Solana Chain) > Ask Minara AI - Intelligent crypto assistant ```json {"openapi":"3.0.0","info":{"title":"Minara x402 API","version":"1.0"},"servers":[{"url":"https://x402.minara.ai"}],"security":[{"x402Payment":[]}],"components":{"securitySchemes":{"x402Payment":{"type":"apiKey","in":"header","name":"x-payment-response","description":"Payment proof token obtained from x402 payment challenge flow. Required after completing payment."}},"schemas":{"ChatRequest":{"type":"object","required":["userQuery"],"properties":{"userQuery":{"type":"string","description":"Required. User query content."}}},"ChatResponse":{"type":"object","properties":{"content":{"type":"string","description":"AI response content."}}},"PaymentRequiredError":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"paymentInstructions":{"type":"object","properties":{"amount":{"type":"string","description":"Payment amount required."},"currency":{"type":"string","description":"Payment currency (e.g., USDC)."},"recipient":{"type":"string","description":"Payment recipient address."},"chain":{"type":"string","description":"Blockchain for payment."}}}}}}},"paths":{"/x402/solana/chat":{"post":{"summary":"Chat (Solana Chain)","description":"Ask Minara AI - Intelligent crypto assistant","operationId":"x402SolanaChat","tags":["AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatResponse"}}}},"400":{"description":"Bad Request - Invalid parameters"},"401":{"description":"Unauthorized - Invalid payment response token"},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredError"}}}}}}}}} ``` ## Chat Expert (Solana Chain) > Ask Minara AI - Intelligent crypto assistant ```json {"openapi":"3.0.0","info":{"title":"Minara x402 API","version":"1.0"},"servers":[{"url":"https://x402.minara.ai"}],"security":[{"x402Payment":[]}],"components":{"securitySchemes":{"x402Payment":{"type":"apiKey","in":"header","name":"x-payment-response","description":"Payment proof token obtained from x402 payment challenge flow. Required after completing payment."}},"schemas":{"ChatRequest":{"type":"object","required":["userQuery"],"properties":{"userQuery":{"type":"string","description":"Required. User query content."}}},"ChatResponse":{"type":"object","properties":{"content":{"type":"string","description":"AI response content."}}},"PaymentRequiredError":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"paymentInstructions":{"type":"object","properties":{"amount":{"type":"string","description":"Payment amount required."},"currency":{"type":"string","description":"Payment currency (e.g., USDC)."},"recipient":{"type":"string","description":"Payment recipient address."},"chain":{"type":"string","description":"Blockchain for payment."}}}}}}},"paths":{"/x402/solana/chat/expert":{"post":{"summary":"Chat Expert (Solana Chain)","description":"Ask Minara AI - Intelligent crypto assistant","operationId":"x402SolanaChatExpert","tags":["AI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatResponse"}}}},"400":{"description":"Bad Request - Invalid parameters"},"401":{"description":"Unauthorized - Invalid payment response token"},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredError"}}}}}}}}} ``` ## Perpetual Trading Suggestion > Get AI-powered perpetual trading suggestions with long/short recommendations, entry price, stop loss, take profit levels, and confidence score. ```json {"openapi":"3.0.0","info":{"title":"Minara x402 API","version":"1.0"},"servers":[{"url":"https://x402.minara.ai"}],"security":[{"x402Payment":[]}],"components":{"securitySchemes":{"x402Payment":{"type":"apiKey","in":"header","name":"x-payment-response","description":"Payment proof token obtained from x402 payment challenge flow. Required after completing payment."}},"schemas":{"PerpTradingRequest":{"type":"object","required":["symbol"],"properties":{"symbol":{"type":"string","description":"Required. Trading symbol (e.g., 'BTC', 'ETH', 'SOL')."},"style":{"type":"string","enum":["scalping","day-trading","swing-trading"],"default":"scalping","description":"Optional. Trading style: 'scalping', 'day-trading', or 'swing-trading'. Default: 'scalping'."},"marginUSD":{"type":"number","default":1000,"description":"Optional. Margin in USD. Default: 1000."},"leverage":{"type":"number","default":10,"minimum":1,"maximum":40,"description":"Optional. Leverage multiplier (max: 40). Default: 10."},"strategy":{"type":"string","default":"max-profit","description":"Optional. Strategy type. Default: 'max-profit'. More strategies coming soon."}}},"PerpTradingResponse":{"type":"object","properties":{"entryPrice":{"type":"number","description":"Recommended entry price."},"side":{"type":"string","enum":["long","short"],"description":"Trading side recommendation."},"stopLossPrice":{"type":"number","description":"Recommended stop loss price."},"takeProfitPrice":{"type":"number","description":"Recommended take profit price."},"confidence":{"type":"number","minimum":0,"maximum":100,"description":"Confidence score (0-100)."},"reasons":{"type":"array","items":{"type":"string"},"description":"Analysis reasons based on technical indicators."},"risks":{"type":"array","items":{"type":"string"},"description":"Risk factors to consider."}}},"PaymentRequiredError":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"paymentInstructions":{"type":"object","properties":{"amount":{"type":"string","description":"Payment amount required."},"currency":{"type":"string","description":"Payment currency (e.g., USDC)."},"recipient":{"type":"string","description":"Payment recipient address."},"chain":{"type":"string","description":"Blockchain for payment."}}}}}}},"paths":{"/x402/perp-trading-suggestion":{"post":{"summary":"Perpetual Trading Suggestion","description":"Get AI-powered perpetual trading suggestions with long/short recommendations, entry price, stop loss, take profit levels, and confidence score.","operationId":"x402PerpTradingSuggestion","tags":["Trading"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerpTradingRequest"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerpTradingResponse"}}}},"400":{"description":"Bad Request - Invalid parameters"},"401":{"description":"Unauthorized - Invalid payment response token"},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredError"}}}}}}}}} ``` ## Intent to Swap Transaction > Convert natural language trading intent into an executable swap transaction payload. Compatible with OKX DEX by default. ```json {"openapi":"3.0.0","info":{"title":"Minara x402 API","version":"1.0"},"servers":[{"url":"https://x402.minara.ai"}],"security":[{"x402Payment":[]}],"components":{"securitySchemes":{"x402Payment":{"type":"apiKey","in":"header","name":"x-payment-response","description":"Payment proof token obtained from x402 payment challenge flow. Required after completing payment."}},"schemas":{"IntentToSwapRequest":{"type":"object","required":["intent","walletAddress"],"properties":{"intent":{"type":"string","description":"Required. Natural language swap intent (e.g., 'swap 0.1 ETH to USDC')."},"walletAddress":{"type":"string","description":"Required. User wallet address (0x...)."},"chain":{"type":"string","description":"Optional. Chain name (e.g., 'base', 'ethereum', 'bsc', 'arbitrum', 'optimism')."}}},"SwapTransactionResponse":{"type":"object","properties":{"transaction":{"type":"object","description":"Swap transaction details","properties":{"chain":{"type":"string","description":"Chain name."},"inputTokenAddress":{"type":"string","description":"Input token contract address."},"inputTokenSymbol":{"type":"string","description":"Input token symbol."},"outputTokenAddress":{"type":"string","description":"Output token contract address."},"outputTokenSymbol":{"type":"string","description":"Output token symbol."},"amount":{"type":"string","description":"Transaction amount."},"amountPercentage":{"type":"number","description":"Amount percentage."},"slippagePercent":{"type":"string","description":"Slippage percentage."}}}}},"PaymentRequiredError":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"paymentInstructions":{"type":"object","properties":{"amount":{"type":"string","description":"Payment amount required."},"currency":{"type":"string","description":"Payment currency (e.g., USDC)."},"recipient":{"type":"string","description":"Payment recipient address."},"chain":{"type":"string","description":"Blockchain for payment."}}}}}}},"paths":{"/x402/intent-to-swap-tx":{"post":{"summary":"Intent to Swap Transaction","description":"Convert natural language trading intent into an executable swap transaction payload. Compatible with OKX DEX by default.","operationId":"x402IntentToSwap","tags":["Trading"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntentToSwapRequest"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SwapTransactionResponse"}}}},"400":{"description":"Bad Request - Invalid parameters"},"401":{"description":"Unauthorized - Invalid payment response token"},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredError"}}}}}}}}} ``` ## Prediction Market Analysis (Base Chain) > AI-powered prediction market analysis. Analyze prediction market events and get probability estimates for each outcome with detailed reasoning. ```json {"openapi":"3.0.0","info":{"title":"Minara x402 API","version":"1.0"},"servers":[{"url":"https://x402.minara.ai"}],"security":[{"x402Payment":[]}],"components":{"securitySchemes":{"x402Payment":{"type":"apiKey","in":"header","name":"x-payment-response","description":"Payment proof token obtained from x402 payment challenge flow. Required after completing payment."}},"schemas":{"PredictionMarketRequest":{"type":"object","required":["link","mode"],"properties":{"link":{"type":"string","description":"Required. Prediction market page link (e.g., Polymarket event URL)."},"mode":{"type":"string","enum":["fast","expert"],"description":"Required. Chat mode: 'fast' or 'expert'."},"only_result":{"type":"boolean","default":false,"description":"Optional. Only return prediction probabilities without reasoning. Default: false."},"customPrompt":{"type":"string","description":"Optional. Custom instructions to guide the analysis. Use this to specify focus areas, risk preferences, or analysis style."}}},"PredictionMarketResponse":{"type":"object","properties":{"predictions":{"type":"array","description":"Array of prediction outcomes. Each outcome represents an event option with its yes/no probabilities.","items":{"type":"object","properties":{"outcome":{"type":"string","description":"Outcome name (event option, e.g., candidate name, team name)."},"yesProb":{"type":"number","description":"Probability of YES for this outcome (0-1)."},"noProb":{"type":"number","description":"Probability of NO for this outcome (0-1)."}}}},"reasoning":{"type":"string","description":"AI reasoning and analysis (empty if only_result=true)."}}},"BadRequestError":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"UnauthorizedError":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"PaymentRequiredError":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"paymentInstructions":{"type":"object","properties":{"amount":{"type":"string","description":"Payment amount required."},"currency":{"type":"string","description":"Payment currency (e.g., USDC)."},"recipient":{"type":"string","description":"Payment recipient address."},"chain":{"type":"string","description":"Blockchain for payment."}}}}}}},"paths":{"/x402/prediction-market-ask":{"post":{"summary":"Prediction Market Analysis (Base Chain)","description":"AI-powered prediction market analysis. Analyze prediction market events and get probability estimates for each outcome with detailed reasoning.","operationId":"x402PredictionMarketAsk","tags":["Prediction"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PredictionMarketRequest"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PredictionMarketResponse"}}}},"400":{"description":"Bad Request - Invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}}},"401":{"description":"Unauthorized - Invalid payment response token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredError"}}}}}}}}} ``` ## 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` | cadena | Sí | Contenido de la consulta del usuario | #### Solicitud de ejemplo ```bash curl -X POST https://x402.minara.ai/x402/chat \\ -H "x-payment-response: " \\ -H "Content-Type: application/json" \\ -d '{ "userQuery": "¿Cuál es el precio actual de BTC y cuáles son los niveles clave de soporte?" }' ``` #### Respuesta **Estado:** 201 Created ```json { "content": "BTC actualmente cotiza a $98,450. Los niveles clave de soporte están en $96,500 y $94,200. La reciente ruptura por encima de $97,000 con un fuerte volumen sugiere continuación alcista..." } ``` *** ### 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` | cadena | Sí | Contenido de la consulta del usuario | #### Solicitud de ejemplo ```bash curl -X POST https://x402.minara.ai/x402/chat/expert \\ -H "x-payment-response: " \\ -H "Content-Type: application/json" \\ -d '{ "userQuery": "Proporciona un análisis integral de ETH, incluyendo métricas on-chain y estrategia de trading" }' ``` #### Respuesta **Estado:** 201 Created ```json { "content": "Análisis integral de ETH:\n\n**Acción del precio**: ETH cotiza a $3,420, consolidándose cerca del rango de $3,400-$3,500...\n\n**Métricas on-chain**: Las direcciones activas aumentaron un 12% semana a semana, lo que indica una mayor actividad de la red...\n\n**Estrategia de trading**: Considera acumular en retrocesos hacia el soporte de $3,300 con objetivos en $3,600 y $3,850..." } ``` *** ### 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` | cadena | Sí | Contenido de la consulta del usuario | #### Solicitud de ejemplo ```bash curl -X POST https://x402.minara.ai/x402/solana/chat \\ -H "x-payment-response: " \\ -H "Content-Type: application/json" \\ -d '{ "userQuery": "Muéstrame los tokens en tendencia más destacados en Solana ahora mismo" }' ``` #### Respuesta **Estado:** 201 Created ```json { "content": "Tokens de Solana en tendencia:\n1. WIF - sube un 24% con $45M de volumen en 24 h\n2. BONK - sube un 18% con fuerte actividad de la comunidad\n3. JUP - consolidándose tras el reciente impulso, volumen en $38M..." } ``` ### 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` | cadena | Sí | Contenido de la consulta del usuario | #### Solicitud de ejemplo ```bash curl -X POST https://x402.minara.ai/x402/solana/chat/expert \\ -H "x-payment-response: " \\ -H "Content-Type: application/json" \\ -d '{ "userQuery": "Analiza la distribución de liquidez y los movimientos de las ballenas para el token JUP" }' ``` #### Respuesta **Estado:** 201 Created ```json { "content": "**Análisis profundo del token JUP**\n\n**Distribución de liquidez**: La liquidez total en los principales DEX es de $125M, con el 65% concentrado en el rango de $0.85-$0.92...\n\n**Actividad de ballenas**: Los 10 principales poseedores controlan el 34% de la oferta. Se detectaron 3 transacciones significativas de ballenas en las últimas 24 h, por un total de $4.2M en compras...\n\n**Evaluación de riesgo**: Riesgo de liquidez moderado por encima de la marca de $1.00. Ten esto en cuenta al dimensionar posiciones..." } ``` *** ### 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` | cadena | Sí | Contenido de la consulta del usuario | #### Solicitud de ejemplo ```bash curl -X POST https://x402.minara.ai/x402/polygon/chat \\ -H "x-payment-response: " \\ -H "Content-Type: application/json" \\ -d '{ "userQuery": "¿Cuál es el precio actual de BTC y cuáles son los niveles clave de soporte?" }' ``` #### Respuesta **Estado:** 201 Created ```json { "content": "BTC actualmente cotiza a $98,450. Los niveles clave de soporte están en $96,500 y $94,200. La reciente ruptura por encima de $97,000 con un fuerte volumen sugiere continuación alcista..." } ``` *** ### 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` | cadena | Sí | Contenido de la consulta del usuario | #### Solicitud de ejemplo ```bash curl -X POST https://x402.minara.ai/x402/polygon/chat/expert \\ -H "x-payment-response: " \\ -H "Content-Type: application/json" \\ -d '{ "userQuery": "Proporciona un análisis integral de ETH, incluyendo métricas on-chain y estrategia de trading" }' ``` #### Respuesta **Estado:** 201 Created ```json { "content": "**Análisis integral de ETH**\n\n**Acción del precio**: ETH cotiza a $3,420, consolidándose cerca del rango de $3,400-$3,500...\n\n**Métricas on-chain**: Las direcciones activas aumentaron un 12% semana a semana, lo que indica una mayor actividad de la red...\n\n**Estrategia de trading**: Considera acumular en retrocesos hacia el soporte de $3,300 con objetivos en $3,600 y $3,850..." } ``` *** ## Endpoints de trading ### Transacción de intención de swap **Punto final:** `POST /x402/intent-to-swap-tx` Convierte una 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` | cadena | Sí | Intención de swap en lenguaje natural (p. ej., "swap 0.1 ETH por USDC") | | `walletAddress` | cadena | Sí | Dirección de la cartera del usuario (0x...) | | `chain` | cadena | No | Nombre de la cadena (p. ej., "base", "ethereum", "bsc", "arbitrum", "optimism") | #### Solicitud de ejemplo ```bash curl -X POST https://x402.minara.ai/x402/intent-to-swap-tx \\ -H "x-payment-response: " \\ -H "Content-Type: application/json" \\ -d '{ "intent": "intercambia 0.1 ETH por USDC", "walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb1", "chain": "base" }' ``` #### Respuesta **Estado:** 201 Created ```json { "transaction": { "chain": "base", "inputTokenAddress": "0x4200000000000000000000000000000000000006", "inputTokenSymbol": "ETH", "outputTokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "outputTokenSymbol": "USDC", "amount": "0.1", "amountPercentage": 100, "slippagePercent": "0.5" } } ``` *** ### Sugerencia de trading perpetuo **Punto final:** `POST /x402/perp-trading-suggestion` Obtén sugerencias de trading perpetuo impulsadas por IA con recomendaciones de largo/corto, precio de entrada, stop loss, niveles de take profit y puntuación de confianza basada en un análisis integral 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 | Predeterminado | Descripción | | ----------- | ------ | --------- | -------------- | -------------------------------------------------------------- | | `symbol` | cadena | Sí | - | Símbolo de trading (p. ej., "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) | #### Solicitud de ejemplo ```bash curl -X POST https://x402.minara.ai/x402/perp-trading-suggestion \\ -H "x-payment-response: " \\ -H "Content-Type: application/json" \\ -d '{ "symbol": "BTC", "style": "day trading", "marginUSD": 1000, "leverage": 10, "strategy": "max-profit" }' ``` #### Respuesta **Estado:** 201 Created ```json { "entryPrice": 98450, "side": "long", "stopLossPrice": 96200, "takeProfitPrice": 102800, "confidence": 78, "reasons": [ "BTC rompió por encima de la resistencia clave en $97,500 con un fuerte volumen", "RSI en 62 indica impulso alcista sin estar sobrecomprado", "MACD mostrando un cruce alcista en el marco temporal de 4H", "El perfil de volumen muestra acumulación en los niveles actuales" ], "risks": [ "Posible retroceso en la resistencia psicológica de $100,000", "Se espera alta volatilidad alrededor de la próxima reunión de la Fed", "Las tasas de financiación en los principales exchanges muestran una tendencia al alza" ] } ``` *** ### Análisis del mercado de predicción (cadena Base) **Punto final:** `POST /x402/prediction-market-ask` Análisis del mercado de predicción impulsado por IA. Analiza 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 | Predeterminado | Descripción | | -------------- | -------- | --------- | -------------- | ------------------------------------------------------------------------------------ | | `enlace` | cadena | Sí | - | Enlace de la página del mercado de predicción (p. ej., URL del evento de Polymarket) | | `modo` | cadena | Sí | - | Modo de chat: "fast" o "expert" | | `only_result` | booleano | No | false | Devuelve solo las probabilidades de predicción sin razonamiento | | `customPrompt` | cadena | No | - | Instrucciones personalizadas para guiar el análisis | #### Solicitud de ejemplo ```bash curl -X POST https://x402.minara.ai/x402/prediction-market-ask \\ -H "x-payment-response: " \\ -H "Content-Type: application/json" \\ -d '{ "link": "https://polymarket.com/event/will-there-be-another-us-government-shutdown-by-january-31", "mode": "rápido", "only_result": false, "customPrompt": "Céntrate en las noticias recientes y el análisis de sentimiento. Sé más conservador en las estimaciones de probabilidad." }' ``` #### Respuesta **Estado:** 201 Created ```json { "predictions": [ { "outcome": "Donald Trump", "yesProb": 0.65, "noProb": 0.35 }, { "outcome": "Kamala Harris", "yesProb": 0.3, "noProb": 0.7 } ], "reasoning": "Basado en datos recientes de encuestas y tendencias históricas, Trump mantiene una ligera ventaja en estados clave indecisos. Sin embargo, la contienda sigue siendo muy competitiva, con una incertidumbre significativa..." } ``` *** ### Análisis del mercado de predicción (cadena Polygon) **Punto final:** `POST /x402/polygon/prediction-market-ask` Análisis del mercado 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. #### Solicitud de ejemplo ```bash curl -X POST https://x402.minara.ai/x402/polygon/prediction-market-ask \\ -H "x-payment-response: " \\ -H "Content-Type: application/json" \\ -d '{ "link": "https://polymarket.com/event/will-there-be-another-us-government-shutdown-by-january-31", "mode": "rápido", "only_result": false }' ``` #### Respuesta **Estado:** 201 Created Mismo formato de respuesta que el endpoint de la cadena Base. *** ## Respuestas de error ### 402 Payment Required La solicitud inicial sin credenciales de pago devolverá: ```json { "error": "payment_required", "message": "Se requiere pago para acceder a este recurso", "paymentInstructions": { "amount": "0.20", "currency": "USDC", "recipient": "0x...", "chain": "base" } } ``` ### 401 Unauthorized Prueba de pago inválida o expirada: ```json { "error": "unauthorized", "message": "Token de respuesta de pago inválido" } ``` ### 400 Bad Request Parámetros de solicitud inválidos: ```json { "error": "bad_request", "message": "Falta el parámetro requerido: userQuery" } ``` *** ## Límites de tasa Los endpoints x402 tienen límite de tasa por dirección de wallet: * **Endpoints de IA:** 60 solicitudes por minuto * **Endpoints de trading:** 30 solicitudes por minuto Superar los límites de tasa devolverá: ```json { "error": "rate_limit_exceeded", "message": "Demasiadas solicitudes. Inténtalo de nuevo en 30 segundos.", "retryAfter": 30 } ``` *** ## 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](https://x402scan.com/server) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://minara.ai/docs/minara-handbook/es/operar/agent-api/api-reference-x402.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.