> 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.md).

# API

La API del agente Minara brinda a desarrolladores, traders y analistas de mercado acceso directo a la inteligencia financiera y la ejecución de operaciones de Minara a través de una interfaz HTTP estándar.

<figure><img src="/files/c5b67fb3c4cc4221aeef115d2187afaff1d30027" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
El acceso mediante clave de API requiere una **Pro** suscripción a un plan. En los planes Lite y Starter, la pestaña de API en tu perfil muestra un mensaje de actualización en lugar de una interfaz para crear claves. Pay-As-You-Go vía x402 no requiere ningún plan.
{% endhint %}

### Lo que puedes hacer con la API

Consulta datos de mercado en tiempo real en cripto y acciones: actividad de monederos, métricas DeFi, flujos en cadena, señales alfa. Todas las respuestas están estructuradas para el consumo por agentes.

Envía una consulta de contexto de mercado y recibe una recomendación de compra o venta junto con un payload de orden predefinido que puedes ejecutar de inmediato. Esto acorta el ciclo desde la señal hasta la operación.

Describe una operación en inglés sencillo; la API devuelve un payload de transacción ejecutable en cadena, compatible de forma predeterminada con OKX DEX.

Consulta distribuciones de probabilidad estimadas por IA para los resultados de eventos en mercados de predicción, respaldadas por datos de mercado, contexto de noticias y bandas de incertidumbre. Úsalo para identificar cuotas mal valoradas y dimensionar posiciones con límites de riesgo más claros.

### Cómo funciona

Dos métodos de facturación:

1. Clave de API, disponible en el plan Pro. Generas claves desde tu perfil de Minara y las incluyes en el `Autorización` encabezado.
2. Pay-As-You-Go a través de la [protocolo x402](https://www.x402.org/). Cada solicitud se paga con stablecoins como USDC; no se requiere suscripción a un plan.

### Comenzar

* [Autenticación](/docs/minara-handbook/es/operar/agent-api/authentication.md): cómo se autentican las solicitudes bajo cada método de facturación.
* [clave API](/docs/minara-handbook/es/operar/agent-api/api-key.md): genera y administra claves en el plan Pro.
* [x402](/docs/minara-handbook/es/operar/agent-api/x402.md): paga por solicitud con stablecoins.
* [Referencia de la API (clave de API)](/docs/minara-handbook/es/operar/agent-api/api-reference-api-key.md): especificaciones completas de los endpoints para el flujo de clave de API.
* [Referencia de la API (x402)](/docs/minara-handbook/es/operar/agent-api/api-reference-x402.md): especificaciones completas de los endpoints para el flujo de x402.


---

# 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.md?ask=<question>
```

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.