# Minara AI Intent-to-Swap Transaction

> Minara AI Intent-to-Swap Transaction is a paid API for AI agents from x402.minara.ai, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-13).

Converts a natural language swap intent into a structured crypto swap transaction object ready for execution

## Facts

- Endpoint: POST https://x402.minara.ai/x402/intent-to-swap-tx
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/minara-ai-intent-to-swap-transaction-958b6ff0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tDCx90sy4FjUGsHHDqq4N

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability minara-ai-intent-to-swap-transaction-958b6ff0 -d '<json body>'
```

Example prompt: I want to swap 50% of my ETH for USDC on Base — my wallet is 0xAbC1234...5678. Can you generate the swap transaction parameters for that?

## When to prefer this

Use this endpoint when you need to parse a user's free-text swap request into structured, actionable swap transaction parameters without requiring the user to know token contract addresses or exact amounts. Ideal for conversational DeFi agents that accept natural language instructions and need to bridge them to on-chain execution. Prefer over manually constructing swap parameters when the input is unstructured or user-generated.

## Known failure modes

- Ambiguous intent that cannot be parsed into a valid swap (e.g. missing token or amount)
- Unsupported chain name returns an error or empty transaction
- Invalid or malformed wallet address rejected by validation
- Intent references a token that cannot be resolved to a known address
- Payment failure (402) if USDC payment is not provided or is insufficient

## How this service works

Convert natural language intent to swap transaction

## Output

Returns a structured swap transaction object containing input and output token symbols and addresses, the chain name, swap amount, slippage percentage, and amount percentage — everything needed to construct and execute a token swap on-chain.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "intent",
  "walletAddress"
 ],
 "properties": {
  "chain": {
   "type": "string",
   "description": "Chain name"
  },
  "intent": {
   "type": "string",
   "description": "Natural language of swap intent"
  },
  "walletAddress": {
   "type": "string",
   "description": "User wallet address"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "properties": {
  "transaction": {
   "type": "object",
   "properties": {
    "chain": {
     "type": "string",
     "description": "Chain name"
    },
    "amount": {
     "type": "string",
     "description": "Amount"
    },
    "slippagePercent": {
     "type": "string",
     "description": "Slippage percent"
    },
    "amountPercentage": {
     "type": "number",
     "description": "Amount percentage"
    },
    "inputTokenSymbol": {
     "type": "string",
     "description": "Input token symbol"
    },
    "inputTokenAddress": {
     "type": "string",
     "description": "Input token address"
    },
    "outputTokenSymbol": {
     "type": "string",
     "description": "Output token symbol"
    },
    "outputTokenAddress": {
     "type": "string",
     "description": "Output token address"
    }
   },
   "description": "Swap transaction result"
  }
 },
 "description": "Swap transaction result"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/minara-ai-intent-to-swap-transaction-958b6ff0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.minara.ai](https://www.zero.xyz/host/x402.minara.ai/llms.txt)