# HYPERNATT Swap Quote

> HYPERNATT Swap Quote is a paid API for AI agents from hypernatt.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-13).

Gets a cross-chain token swap quote including estimated output amount and duration via the HYPERNATT neural trading platform

## Facts

- Endpoint: GET https://hypernatt.com/api/m2m/swap/quote
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hypernatt-swap-quote-c2e58f12
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RKqdCbgws6U3t56L53mpH

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 hypernatt-swap-quote-c2e58f12
```

Example prompt: How much USDC will I get if I swap 1,000,000 atomic units of ETH on Base (chain 8453) to USDC on Ethereum (chain 1), sending from 0xAbC...123 to 0xDeF...456, with 0.5% slippage?

## When to prefer this

Use this endpoint when you need a cross-chain or same-chain token swap quote before executing a trade, especially when routing through LI.FI aggregator on EVM chains. Prefer this over generic DEX APIs when you want a neutral pre-execution price estimate with duration data and are operating within the HYPERNATT agentic trading ecosystem.

## Known failure modes

- Missing required query parameters (fromChain, toChain, fromToken, toToken, fromAmount, fromAddress, toAddress) returns an error
- Invalid chain IDs or unsupported token pairs return a failure response
- No liquidity route available between specified tokens/chains
- Payment of 0.001 USDC per call not fulfilled via x402 protocol results in 402 error
- Invalid wallet addresses return a validation error

## How this service works

NattSwap cross-chain swap quote (Li.Fi)

## Output

A JSON object with a 'quote' field containing the aggregator tool used (e.g. lifi), the input amount in atomic units, the estimated output token amount in atomic units, and the estimated duration in seconds for the swap to complete; plus a 'success' boolean.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "fromChain",
      "toChain",
      "fromToken",
      "toToken",
      "fromAmount",
      "fromAddress",
      "toAddress"
     ],
     "properties": {
      "toChain": {
       "type": "string",
       "description": "Destination chain id"
      },
      "toToken": {
       "type": "string"
      },
      "slippage": {
       "type": "string"
      },
      "fromChain": {
       "type": "string",
       "description": "Source chain id (e.g. 8453 for Base)"
      },
      "fromToken": {
       "type": "string"
      },
      "toAddress": {
       "type": "string"
      },
      "fromAmount": {
       "type": "string",
       "description": "Amount in atomic units"
      },
      "fromAddress": {
       "type": "string",
       "description": "Your agent hot wallet (must sign the swap). Not a Hyperliquid vault address. Prefer MCP swap_via_nattswap (free)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "quote": {
   "tool": "lifi",
   "toAmount": "997500",
   "fromAmount": "1000000",
   "estimatedDurationSeconds": 60
  },
  "success": true,
  "execution_readiness": {
   "next_step": {
    "message": "Call swap_via_nattswap MCP tool to get execution instructions"
   },
   "can_execute": true,
   "signer_match": true
  },
  "wallet_onboarding_v1": {
   "doc_url": "https://github.com/DIALLOUBE-RESEARCH/hypernatt-terminal/blob/main/docs/swap-agentkit.md"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hypernatt-swap-quote-c2e58f12/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hypernatt.com](https://www.zero.xyz/host/hypernatt.com/llms.txt)