> For the complete documentation index, see [llms.txt](https://docs.lid.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lid.pro/es/developers/agentic-commerce-api.md). # API de comercio agéntico La conexión de agentes sobre MCP ya funciona; la API REST completa y el SDK están en la hoja de ruta. Qué suma, para quién es, cómo entrar temprano. En palabras simples: esta página trata de dejar que el software, no solo las personas, venda y compre en Lid. Si vendes, nada de esto cambia cómo usas Lid. ## ¿Un agente de IA puede vender un producto digital hoy? Sí, en Lid, sobre MCP, hoy. Un agente con una clave crea un producto, aloja el archivo, fija una comisión para sharers y lee sus ventas; el dinero se liquida en una sola transacción, 3% fijo, en la billetera real del dueño de la clave. También puede compartir productos de otros, correr retos y campañas, revisar resultados y recibir webhooks firmados. Las compras desde el saldo propio del agente están en vista previa. El acceso es con una clave de API desde **Ajustes > Desarrollador**, usada como bearer token, con un espejo REST en `api.lid.pro/api/v1/agent/*`. Empieza en [Agentes en Lid](/es/agents.md) y la [Referencia de herramientas](/es/agents/tools.md). **Estado: la conexión de agentes sobre MCP ya funciona. La API REST pública completa y el SDK están en la hoja de ruta.** Lo que esta página describe más allá de la superficie en vivo es dirección, no referencia. ## ¿Por qué el comercio de agentes necesita sus propios rieles? Si los agentes autónomos se vuelven actores económicos relevantes en los próximos 12 a 24 meses, necesitan rieles nativos para transaccionar entre ellos. Hoy los agentes pueden llamar APIs, generar contenido y razonar. No pueden comprar y vender productos con atribución on-chain, repartir ingresos automáticamente con otros agentes, ni liquidar de forma atómica en dólares digitales con facilidad. Lid es un candidato creíble para esos rieles porque el ciclo central ya está construido para eso. Distribución sin permisos, atribución aplicable, repartos atómicos, liquidación instantánea. Las cuatro son propiedades necesarias para que el comercio de agentes funcione a escala. Los agentes ya crean, comparten y leen sobre el riel hoy. ## ¿Qué va a sumar la API completa? Más allá de lo que la conexión MCP hace hoy: * Pago programático para dinero de producción, con políticas de gasto por clave * Historial de atribución por sharer y pruebas on-chain por venta * Repartos ponderados entre varios referidos * Analítica y exportaciones a nivel de cuenta * Un SDK (JavaScript, Python) ## ¿Para quién es? **Frameworks de agentes de IA.** Si construyes un agente que necesita descubrir productos, atribuir compras o repartir ingresos con otros agentes, la API es el riel nativo. **Integraciones SaaS.** Si operas un producto y quieres embeber el ciclo de comercio de Lid (digamos, como primitiva de monetización dentro de otra herramienta para creadores), la API es cómo te conectas. **Consumidores de datos.** Marketplaces, agregadores o plataformas de analítica que quieren leer el estado de Lid para descubrimiento, ranking o reportes. ## ¿Qué no es? * Una API pública de pagos para transferencias arbitrarias de USDC. Lid enruta comercio específicamente. Los pagos de propósito general quedan fuera. * Una rampa fiat de entrada o salida. El retiro a banco y la entrada con tarjeta son piezas separadas, en construcción. ## ¿En qué orden sale? 1. Endurecer la conexión MCP con los primeros design partners. 2. Construir la superficie completa de la API. 3. Beta privada con frameworks de agentes y socios de integración seleccionados. 4. API pública. Sin compromisos de fecha. Las cosas salen cuando están listas. ## ¿Cómo entro temprano? Si construyes un agente o una integración que necesita estas primitivas, queremos hablar ahora. Los primeros design partners definen la superficie de la API. Escribe a con una descripción corta de lo que construyes y cómo usarías la API. Los socios seleccionados entran a la beta privada. Siguiente: [Integraciones](/es/developers/integrations.md) --- # 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, and the optional `goal` query parameter: ``` GET https://docs.lid.pro/es/developers/agentic-commerce-api.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.