# Butterfly Delta Butterfly Delta is a point-in-time causal record of a changing world. Humans travel through the record as a visual Time Machine. Machines request only the verified changes since their last cursor, then inspect affected entities, possible consequences, invalidating evidence, source hashes, and supersession. Free verified-change test contract (payment register disabled): - Head: GET https://butterflydelta.com/api/delta/head - Changes since cursor: GET https://butterflydelta.com/api/delta/changes-since?since=delta:origin - Watchlist impact: POST https://butterflydelta.com/api/delta/impact - Causal chain: GET https://butterflydelta.com/api/delta/chain?change_id=ai-grid-constraint - OpenAPI: https://butterflydelta.com/delta-openapi.json The returned payment object is authoritative. During product testing it is `{ "required": false, "mode": "free_product_test", "register_enabled": false }`. Do not send payment for these endpoints. The earlier execution-integrity preflight remains available as a narrow legacy product: Call it after constructing an order and immediately before submitting that order. Send trade.pair, venue, side, baseSize, optional orderType and limitPrice, and the bot's thresholds. Butterfly Delta simulates the exact order against visible Coinbase and Gemini order-book depth and returns executionGate.state as signed PASS, BLOCK, or UNKNOWN. It also checks venue status, spread, Coinbase last-trade age, and cross-venue midpoint deviation, hashes every source snapshot, and signs the result. If a required source or measurement is unavailable, the gate returns UNKNOWN rather than true. Free coverage preview: POST https://butterflydelta.com/api/agent/delta-peek Paid machine preflight: POST https://butterflydelta.com/api/agent/order-preflight Remote MCP server (tools: delta_peek, delta_preflight): POST https://butterflydelta.com/api/mcp Production price: $0.01 USDC on Base (eip155:8453). Payment accepts x402 exact or MPP evm/charge on the same route and settles to the same recipient. No account, API key, email, or wallet connection is required. Machine contract: - https://butterflydelta.com/delta-openapi.json - https://butterflydelta.com/.well-known/butterflydelta.json - https://butterflydelta.com/.well-known/x402 - https://butterflydelta.com/.well-known/mcp.json - https://butterflydelta.com/openapi.json - https://butterflydelta.com/skill.md - https://butterflydelta.com/.well-known/agent-skills/index.json - https://butterflydelta.com/.well-known/agent-skills/butterfly-delta-preflight/SKILL.md - https://butterflydelta.com/.well-known/skills/index.json - https://butterflydelta.com/.well-known/skills/butterfly-delta-preflight/SKILL.md - https://butterflydelta.com/server.json - https://butterflydelta.com/.well-known/agent.json - https://registry.modelcontextprotocol.io/v0.1/servers?search=com.butterflydelta%2Fpreflight - https://www.x402scan.com/server/4f664ddb-c96d-4e9e-b06c-463fb1dcc39f - https://www.mppscan.com/server/aa1d536240359e703b09757e2a03e335e00e1b8990821dfc1bc6592059fb6c9b - https://agent402.tools/api/index?seller=butterflydelta.com - https://payanagent.com/api/v1/offers/kh7bv0550gv36xx95kphjjscn58cvj00 - https://fiatdock.com/v1/marketplace/services/svc_c2cff393-bba7-4b34-b73a-1f62f25d88fb Marketplace purchase routes: - Agent402 free external quote: GET https://agent402.tools/api/route?q=hummingbot%20freqtrade%20ccxt%20exact-order%20pre-trade%20execution%20integrity%20gate%20coinbase%20gemini&include=external - Agent402 paid one-call execution: POST https://agent402.tools/api/route/execute-plus with {"task":"hummingbot freqtrade ccxt exact-order pre-trade execution integrity gate coinbase gemini","include":"external","params":}. Agent402 charges its disclosed $0.05 tier, buys the selected $0.01 external call, and relays the result and receipt. - PayanAgent noncustodial relay: https://payanagent.com/x402/kh7bv0550gv36xx95kphjjscn58cvj00 - FiatDock one-call gateway: POST https://fiatdock.com/s/svc_c2cff393-bba7-4b34-b73a-1f62f25d88fb or select listing svc_c2cff393-bba7-4b34-b73a-1f62f25d88fb through search_services/call_service. One $0.01 Base-USDC x402 payment settles directly to the Ledger-controlled recipient; FiatDock then invokes Butterfly Delta's private fulfillment route and relays the signed result. Do not also pay the canonical route for that call. Execution-loop integrations: - Installable CCXT JavaScript package: npm install https://butterflydelta.com/downloads/butterflydelta-preflight-0.1.0.tgz - Installable Python CCXT/Freqtrade/Hummingbot wheel: pip install https://butterflydelta.com/downloads/butterflydelta_preflight-0.1.0-py3-none-any.whl - CCXT JavaScript fail-closed wrapper: https://butterflydelta.com/integrations/ccxt-preflight.mjs - CCXT Python fail-closed wrapper: https://butterflydelta.com/integrations/ccxt_preflight.py - Freqtrade final-entry mixin: https://butterflydelta.com/integrations/freqtrade_preflight.py - Hummingbot Controller entry mixin: https://butterflydelta.com/integrations/hummingbot_preflight.py - Integration guide: https://butterflydelta.com/integrations/README.md - Agent Skills discovery index: https://butterflydelta.com/.well-known/agent-skills/index.json - OpenClaw/Hermes-compatible skill: https://butterflydelta.com/.well-known/agent-skills/butterfly-delta-preflight/SKILL.md - Hermes well-known install: hermes skills install well-known:https://butterflydelta.com/.well-known/skills/butterfly-delta-preflight Execution-loop rule: - Run delta_preflight after constructing an order and immediately before submitting it. - Run it again before every successive order. Never reuse an expired result. - A caller may submit only when executionGate.state is PASS and its independent authorization and risk policies also pass. - BLOCK or UNKNOWN should fail closed under the caller's policy. Output states: - ASSUMPTION_PRESSURED - ASSUMPTION_INVALIDATED - NO_MATCH_IN_CURRENT_COVERAGE - INSUFFICIENT_COVERAGE NO_MATCH_IN_CURRENT_COVERAGE never means safe. It means no matching invalidation was found inside the matched coverage modules. Current live execution coverage is deliberately narrow: USD spot pairs with public Coinbase Exchange and Gemini order books. Exact-order visible depth coverage and estimated slippage are included. Private order state, caller-specific fees, portfolio suitability, authorization, routing, and execution are excluded. Attestations are EIP-191 signed by 0x29dd177F3D428b99a15Da00f50484A73339166AD and expire after five minutes. Butterfly Delta reports assumption state. The caller retains every execution, authorization, safety, sizing, routing, and risk decision. It does not provide investment, legal, or tax advice and does not authorize or execute actions. Self-payments and test settlements are not revenue or customer validation.