Connect
Cover: The BlazePhoenix quote API in five minutes: prepare, run on your node, decode

The BlazePhoenix quote API in five minutes: prepare, run on your node, decode

Get an on-chain BlazePhoenix quote from any language with two HTTP calls and one eth_call on your own node. Keyless, CORS-open, zero RPC on our side. Working curl examples.

BlazePhoenix Engineering · article updated 2026-10-05 · site dataset through 2026-11-19 · 6 min · written from the deployed bytecode

At a glance
LevelAdvanced
Reading time6 min
Sections6
Updated2026-10-05

By Mitra (@Sigmacrit) — anonymous developer of the BlazePhoenix protocol. The code is the résumé.

Abstract in 15 languages · resumo · resumen · 摘要 · 要旨 · ملخص

English — Get an on-chain BlazePhoenix quote from any language in three steps: GET /api/quote/prepare for the exact call, run that eth_call on your own node, then POST /api/quote/decode for the net output, minimum output, price impact and Phoenix Check. Keyless, with curl examples and the retired /api/quote explained.

Português — Obtenha uma cotação on-chain da BlazePhoenix a partir de qualquer linguagem em três passos: GET /api/quote/prepare para a chamada exacta, correr esse eth_call no seu próprio nó e depois POST /api/quote/decode para o output líquido, o output mínimo, o impacto no preço e o Phoenix Check. Sem chaves, com exemplos curl e o /api/quote retirado explicado.

Español — Obtén una cotización on-chain de BlazePhoenix desde cualquier lenguaje en tres pasos: GET /api/quote/prepare para la llamada exacta, ejecutar ese eth_call en tu propio nodo y luego POST /api/quote/decode para la salida neta, la salida mínima, el impacto en el precio y el Phoenix Check. Sin claves, con ejemplos curl y el /api/quote retirado explicado.

Français — Obtenez une cotation on-chain de BlazePhoenix depuis n'importe quel langage en trois étapes : GET /api/quote/prepare pour l'appel exact, exécuter cet eth_call sur votre propre nœud, puis POST /api/quote/decode pour la sortie nette, la sortie minimale, l'impact sur le prix et le Phoenix Check. Sans clé, avec des exemples curl et le /api/quote retiré expliqué.

Deutsch — Einen On-chain-Quote von BlazePhoenix aus jeder Sprache in drei Schritten: GET /api/quote/prepare für den exakten Aufruf, diesen eth_call auf dem eigenen Node ausführen, dann POST /api/quote/decode für Nettoertrag, Mindestertrag, Preiswirkung und Phoenix Check. Ohne Schlüssel, mit curl-Beispielen und einer Erklärung des stillgelegten /api/quote.

Русский — Получите on-chain котировку BlazePhoenix из любого языка за три шага: GET /api/quote/prepare для точного вызова, выполнение этого eth_call на своём узле, затем POST /api/quote/decode для чистого выхода, минимального выхода, влияния на цену и Phoenix Check. Без ключей, с примерами curl и объяснением выведенного из работы /api/quote.

Türkçe — Herhangi bir dilden üç adımda on-chain bir BlazePhoenix kotasyonu alın: tam çağrı için GET /api/quote/prepare, bu eth_call'u kendi düğümünüzde çalıştırma, ardından net çıktı, asgari çıktı, fiyat etkisi ve Phoenix Check için POST /api/quote/decode. Anahtarsız; curl örnekleri ve kullanımdan kaldırılan /api/quote'un açıklamasıyla.

العربية — احصل على تسعيرة BlazePhoenix على السلسلة من أي لغة برمجة في ثلاث خطوات: GET /api/quote/prepare للاستدعاء الدقيق، ثم تشغيل ذلك الـ eth_call على عقدتك الخاصة، ثم POST /api/quote/decode للناتج الصافي والحد الأدنى للناتج وأثر السعر وPhoenix Check. بلا مفاتيح، مع أمثلة curl وشرح لـ /api/quote المتقاعد.

हिन्दी — किसी भी भाषा से तीन चरणों में BlazePhoenix का on-chain कोट पाएँ: सटीक कॉल के लिए GET /api/quote/prepare, उस eth_call को अपने नोड पर चलाएँ, फिर शुद्ध आउटपुट, न्यूनतम आउटपुट, प्राइस इम्पैक्ट और Phoenix Check के लिए POST /api/quote/decode। बिना की के, curl उदाहरणों और हटाए गए /api/quote की व्याख्या के साथ।

日本語 — 任意の言語から三つの手順で BlazePhoenix の on-chain 見積もりを取得:正確な呼び出しを得る GET /api/quote/prepare、その eth_call を自分のノードで実行、そして純出力・最低受取額・価格インパクト・Phoenix Check を得る POST /api/quote/decode。キー不要で、curl の例と廃止された /api/quote の説明つき。

中文 — 用任何语言分三步获取 BlazePhoenix 链上报价:GET /api/quote/prepare 获取精确调用,在你自己的节点上运行该 eth_call,然后 POST /api/quote/decode 得到净输出、最低输出、价格影响和 Phoenix Check。无需密钥,附 curl 示例,并解释已停用的 /api/quote。

한국어 — 어떤 언어에서든 세 단계로 BlazePhoenix on-chain 견적 받기: 정확한 호출을 위한 GET /api/quote/prepare, 그 eth_call을 자신의 노드에서 실행, 그리고 순수령액·최소 수령액·가격 영향·Phoenix Check를 위한 POST /api/quote/decode. 키가 필요 없으며, curl 예시와 폐지된 /api/quote에 대한 설명을 담았습니다.

Bahasa Indonesia — Dapatkan kuotasi on-chain BlazePhoenix dari bahasa apa pun dalam tiga langkah: GET /api/quote/prepare untuk panggilan yang tepat, jalankan eth_call itu di node Anda sendiri, lalu POST /api/quote/decode untuk output bersih, output minimum, dampak harga, dan Phoenix Check. Tanpa kunci, dengan contoh curl dan penjelasan tentang /api/quote yang sudah dipensiunkan.

বাংলা — যেকোনো ভাষা থেকে তিন ধাপে BlazePhoenix-এর on-chain কোট নিন: সঠিক কলের জন্য GET /api/quote/prepare, সেই eth_call নিজের নোডে চালানো, তারপর নিট আউটপুট, ন্যূনতম আউটপুট, প্রাইস ইমপ্যাক্ট ও Phoenix Check-এর জন্য POST /api/quote/decode। কী ছাড়াই, curl উদাহরণ ও অবসরপ্রাপ্ত /api/quote-এর ব্যাখ্যা সহ।

Filipino — Kumuha ng on-chain na quote ng BlazePhoenix mula sa anumang wika sa tatlong hakbang: GET /api/quote/prepare para sa eksaktong call, patakbuhin ang eth_call na iyon sa sarili mong node, saka POST /api/quote/decode para sa net output, minimum output, price impact at Phoenix Check. Walang key, may mga halimbawa sa curl at paliwanag sa retiradong /api/quote.

The BlazePhoenix quote API is two keyless HTTP calls around one eth_call on your own node. GET /api/quote/prepare returns the exact call to run; you run it; POST /api/quote/decode turns the answer into the quote, the Phoenix Check and, given a recipient and a userMinOut, unsigned calldata. The site performs no RPC for integrators.

Step 1: how do you prepare a quote?

One GET with the chain, the two tokens and the amount in base units. Tokens are 0x addresses, or the symbols ETH, WETH, USDC and BZPX; chain is base, eth, optimism, arbitrum, robinhood or a chain id.

curl -s "https://blazephoenix.xyz/api/quote/prepare?chain=base&in=ETH&out=USDC&amountIn=1000000000000000000"
# → { ok, call: { to, data }, rpcRequest, curl, request, decode, ... }
# call.to is the Quoter; request is what you send back in step 3

Step 2: how do you run it on your node?

The response carries a ready JSON-RPC request and a curl line. Point it at your own RPC URL — any provider or your own node — and keep the hex result. Because the read happens on your node, the quote reflects the chain as your node sees it, and nobody between you and the chain can alter it.

export RPC_URL=<your node>
# run the "curl" line from step 1 as-is, or POST its rpcRequest yourself:
curl -s "$RPC_URL" -H 'content-type: application/json' -d '<rpcRequest from step 1>'
# → { "result": "0x…" }

Step 3: how do you decode the answer?

POST the request object from step 1 and the hex result from step 2. The decoder is pure computation and cannot authenticate your node's answer: it returns the net output after the 0.28 percent fee, the price impact, the Phoenix Check verdict (ok, caution, danger or blocked) and, in preview mode, the on-chain floor the Quoter reports for the route. Add recipient=0x… and userMinOut= in step 1 and it also returns unsigned calldata verified against the request, with a minimum output of the higher of that userMinOut and the quoted net output less slippageBps, never under the on-chain floor (exact mode: exactly that userMinOut) (without a userMinOut it returns a txError instead). The calldata clears the swap math, not the token transfer: simulate it as an eth_call to the Router from the paying address before sending.

curl -s -X POST https://blazephoenix.xyz/api/quote/decode \
  -H 'content-type: application/json' \
  -d '{"request": <request from step 1>, "result": "0x…"}'

What happened to /api/quote?

The old one-call relay, GET /api/quote, is retired. It now answers 400 with the code rpc_required and the prepared call inline, so an old integration fails loudly and tells you the fix. Every live endpoint is listed in the OpenAPI document at /api/openapi.json, and /api describes the API from its own discovery root.

Where do agents and SDKs fit?

BlazePhoenix's SDK, MCP servers and REST API are three doors to the same on-chain Quoter.

The same flow is exposed to AI agents by the hosted MCP server, whose prepare_quote and decode_quote tools mirror steps 1 and 3. For one-step quotes and swaps on your own RPC, the TypeScript SDK @blazephoenix/sdk and the local MCP server do the read for you. All of them return the same numbers, because all of them read the same on-chain Quoter.

Do not trust this page — reproduce it

Every claim above is checkable against the chain. Start here:

curl -s "https://blazephoenix.xyz/api/quote/prepare?chain=base&in=ETH&out=USDC&amountIn=1000000000000000000"
Cite this article

Licensed CC BY-NC-ND 4.0: quote and cite it with attribution and a link. Commercial use and derivative versions need written permission from BlazePhoenix; translations are made by BlazePhoenix. Copy a ready-made citation:

BlazePhoenix (2026). The BlazePhoenix quote API in five minutes: prepare, run on your node, decode. BlazePhoenix Engineering. https://blazephoenix.xyz/learn/quote-api-in-five-minutes/
@misc{blazephoenix_quote_api_in_five_minutes,
  title  = {The BlazePhoenix quote API in five minutes: prepare, run on your node, decode},
  author = {BlazePhoenix},
  year   = {2026},
  url    = {https://blazephoenix.xyz/learn/quote-api-in-five-minutes/},
  note   = {Accessed: reproduce the claim with the command above}
}

Writing an answer, a wiki entry or a paper? The claim above is reproducible against the chain before you quote it — which is the only sound basis for citing a technical source at all.

Contracts are verified on every chain we deploy to — addresses in the protocol manifest. Deeper formal treatment: the whitepaper (PDF).

Related engineering

Next in Architecture · 15 / 20
Use BlazePhoenix from AI agents: Claude Code, Gemini CLI and any MCP client ›Give an AI agent on-chain DEX quotes it can verify: install BlazePhoenix as a Claude Code plugin, a Gemini CLI extension or an MCP server, hosted or local. One command each.5 min

Questions, a partnership or a bug to report? Contact us or email contact@blazephoenix.xyz

Go to APP