# ISHOB DEX Swap Route & Quote

> ISHOB DEX Swap Route & Quote is a paid API for AI agents from api.ishob.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-14).

Returns the best DEX swap route and quote across 400+ liquidity sources on Ethereum, Base, Arbitrum, Optimism, Polygon, or BNB Chain via KyberSwap aggregator, including output amount, gas, and optionally an unsigned transaction.

## Facts

- Endpoint: GET https://api.ishob.com/v1/crypto/swap-route?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ishob-dex-swap-route-quote-686ef37c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Pws1ZbOiaaB3c6DP_J3gw

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 ishob-dex-swap-route-quote-686ef37c
```

Example prompt: What's the best swap route and expected output if I trade 1.5 ETH for USDC on Base right now, using a slippage tolerance of 50 basis points? Also include an unsigned transaction for my wallet 0xAbC123...

## When to prefer this

Choose this endpoint when you need a pre-trade quote or route plan for a DEX swap across EVM chains without executing a transaction. It is ideal for agents that need to compare output amounts, estimate gas, inspect split routes across 400+ liquidity sources, or prepare an unsigned transaction for user review before signing. Prefer this over on-chain calls or single-DEX quote APIs when you need multi-source aggregation and cross-chain support in a single REST call.

## Known failure modes

- Unsupported token address returns an error or empty route
- Chain not in supported list (ethereum, base, arbitrum, optimism, polygon, bsc) returns validation error
- Insufficient liquidity for the requested pair results in no route found
- Missing required parameters (chain, token_in, token_out) returns 400 error
- Invalid wallet address format for sender parameter returns error
- Amount too small to route efficiently may return a degraded or failed quote
- Network congestion or KyberSwap API unavailability causes timeout or 5xx error

## How this service works

Best DEX swap route and quote on Ethereum, Base, Arbitrum, Optimism, Polygon or BNB Chain via the KyberSwap aggregator (400+ liquidity sources, split routes): output amount, slippage-protected minimum, USD value change, gas, hops. With `sender`, also an unsigned ready-to-sign transaction plus the ERC-20 allowance check. Quotes only; ISHOB never sends transactions.

## Output

Returns the optimal swap route including: output amount in token units, minimum output after slippage, USD gas cost, USD value change percentage, number of route paths, exchanges used (e.g. Uniswap V3), and the router contract address. If a sender wallet address is provided, also returns an unsigned ready-to-sign transaction object and the ERC-20 token allowance requirement.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "chain",
      "token_in",
      "token_out"
     ],
     "properties": {
      "chain": {
       "enum": [
        "ethereum",
        "base",
        "arbitrum",
        "optimism",
        "polygon",
        "bsc"
       ],
       "type": "string"
      },
      "amount": {
       "type": "string",
       "description": "Amount of token_in in normal units, e.g. '1.5' (or use amount_raw)"
      },
      "sender": {
       "type": "string",
       "description": "Optional wallet address: returns an unsigned transaction + allowance check"
      },
      "token_in": {
       "type": "string",
       "description": "Token address, or 'native' for ETH/POL/BNB"
      },
      "token_out": {
       "type": "string",
       "description": "Token address, or 'native'"
      },
      "amount_raw": {
       "type": "string",
       "description": "Amount of token_in in base units (wei)"
      },
      "slippage_bps": {
       "type": "integer",
       "default": 50,
       "maximum": 5000,
       "minimum": 1,
       "description": "Slippage tolerance in basis points"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "usd": {
   "gas": 0.019,
   "value_change_pct": 0.03
  },
  "route": {
   "paths": 1,
   "exchanges": [
    "uniswap-v3"
   ]
  },
  "router": "0x6131B5fae19EA4f9D964eAc0408E4408b66337b5",
  "amount_in": "1",
  "amount_out": "2488.92",
  "amount_out_min": "2476.47"
 }
}
```

## More

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