Integrate any bot: keyless, keyed, ethers, viem, Python, and AI agents

The quote API is a plain HTTPS GET with open CORS and no key, so every bot runtime that can make an HTTP request is already compatible. Below is the same swap — WETH → USDC on Base — in every shape a bot might take. Pick your stack; the response is identical.

Keyless bot (any language, zero dependencies)

The lowest common denominator: one fetch, no SDK, no RPC key. Perfect for serverless functions, Telegram/Discord webhooks and edge workers.

const u = 'https://blazephoenix.xyz/api/quote?chain=base&in=WETH&out=USDC&amountIn=1000000000000000000';
const q = await fetch(u).then(r => r.json());
console.log(q.amountOut, q.meta.cache);   // net output + how it was served

Keyed-RPC server bot (your own node, signing server-side)

Bots that sign with their OWN funds keep using their existing keyed RPC — the API builds the calldata, your node broadcasts it. Add recipient to get a ready tx; your provider key never touches us.

const q = await fetch('https://blazephoenix.xyz/api/quote?chain=base&in=WETH&out=USDC'
  + '&amountIn=1000000000000000000&recipient=' + wallet.address + '&slippageBps=50'
).then(r => r.json());
// q.tx = { to, data, value } — broadcast with YOUR keyed provider:
const hash = await wallet.sendTransaction(q.tx);

ethers v6 / viem (modern signers)

The tx object the API returns is provider-agnostic — it drops straight into ethers v6 (wallet.sendTransaction), viem (walletClient.sendTransaction), or ethers v5 with the same shape. No adapter needed.

// viem
import { createWalletClient, http } from 'viem';
import { base } from 'viem/chains';
const client = createWalletClient({ account, chain: base, transport: http() });
await client.sendTransaction(q.tx);
// ethers v6:  await signer.sendTransaction(q.tx);

Python (web3.py, trading & research bots)

Python bots hit the same endpoint with requests; the returned tx dict is consumed directly by web3.py. Ideal for screeners and quant research where the data, not the signing, is the point.

import requests
q = requests.get('https://blazephoenix.xyz/api/quote', params={
  'chain': 'base', 'in': 'WETH', 'out': 'USDC', 'amountIn': 10**18,
  'recipient': acct.address, 'slippageBps': 50,
}).json()
tx = q['tx']; tx['nonce'] = w3.eth.get_transaction_count(acct.address)
signed = acct.sign_transaction(tx); w3.eth.send_raw_transaction(signed.rawTransaction)

AI agents (LLM function-calling — a first-class citizen)

Autonomous agents do not read docs; they read tool schemas. Drop this OpenAI/Anthropic-style function definition into your agent and it can quote and trade through BlazePhoenix natively — the discovery root (/api), OpenAPI spec (/api/openapi.json) and /llms.txt let it self-configure the rest.

{
  "name": "blazephoenix_quote",
  "description": "Get an on-chain DEX aggregator quote (no key). Add recipient for signable tx calldata.",
  "parameters": { "type": "object", "required": ["chain","in","out","amountIn"], "properties": {
    "chain": { "type": "string", "enum": ["base","eth","optimism","arbitrum"] },
    "in":  { "type": "string", "description": "token address, ETH/WETH/USDC/BZPX, or any symbol" },
    "out": { "type": "string" },
    "amountIn": { "type": "string", "description": "integer base units (wei-style)" },
    "recipient": { "type": "string", "description": "0x address → response includes tx {to,data,value}" }
  } },
  "url": "https://blazephoenix.xyz/api/quote"
}

One rule for every runtime

Whatever the stack: preview freely (identical concurrent requests coalesce, previews edge-cache ~1 block), but the number you SIGN should be a fresh request carrying recipient and, for size, exact=1 — those are never TTL-cached, because anything executable must never be stale. Zero-custody bots skip signing entirely and hand the user a deep link. The API does not care which you are; it answers all of them the same.

Related engineering

• A free DEX aggregator API with no key: quote, sign, send — three calls, zero signup ›
• Zero-custody trading bots: an SDK pattern where the bot never touches funds ›
• Running a quote API in production: error codes, retries, and rate limits without keys ›