Choreograph: AI-Powered Gas Optimization API

Save 60-99% on transaction costs through intelligent cross-chain routing

What We Built

A production-ready API that analyzes gas costs across Ethereum, Base, Arbitrum, and Polygon in real-time, then recommends the optimal chain for any transaction using ML-enhanced confidence scoring.

Live API: https://choreograph-metamask-api.fly.dev

How It Works

Your Transaction → Choreograph API → Cost Analysis → ML Scoring → Recommendation ↓ [Blocknative Gas Prices] [Real-time ETH Pricing] [ML Confidence Algorithm] [All-chain Comparison]

Input: Transaction details (amount, current chain, priority)

Output: Best chain recommendation with savings breakdown and ML confidence score

Key Feature: Compares all chains against all chains, not just Ethereum vs L2s. If you're on Polygon and Base is cheaper, we'll recommend Base.

Real Example

Current: Ethereum transaction costs $0.0321
Recommended: Base transaction costs $0.0016
Savings: $0.03 (95.1%)
ML Confidence: 95%

ML Confidence Scoring

Our lightweight ML engine adjusts confidence based on learned patterns:

Time-of-Day Patterns:

Low traffic hours (0-6 UTC): +8% confidence boost
Medium traffic (6-12, 18-24 UTC): +5% confidence boost
High traffic (12-18 UTC): +2% confidence boost

Volatility Analysis:

Calculates cost variance across chains
Reduces confidence when markets are volatile
Higher stability = higher confidence

Extreme Savings Detection:

Savings >90%: +5% confidence boost
Very clear cost advantage = higher certainty

Result: Confidence scores range from 65% to 95%, giving you transparency on recommendation certainty.

Test the API

Quick Test (30 seconds)

curl -X POST https://choreograph-metamask-api.fly.dev/api/v1/route \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100,
    "current_chain": "ethereum",
    "tx_type": "transfer",
    "priority": "cost"
  }'

Expected Response:

{
  "recommended_chain": "base",
  "current_chain": "ethereum",
  "current_cost_usd": 0.0321,
  "recommended_cost_usd": 0.0016,
  "savings_usd": 0.0305,
  "savings_percent": 95.1,
  "confidence": 0.95,
  "costs": {
    "ethereum": 0.0321,
    "base": 0.0016,
    "arbitrum": 0.0019,
    "polygon": 4.5916
  },
  "reasoning": [
    "Cost priority: base saves $0.03",
    "base is 95.1% cheaper"
  ],
  "eth_price_usd": 4372.92
}

API Parameters

Parameter	Type	Options	Description
amount	float	0.001-1000	Transaction value in USD
current_chain	string	ethereum, base, arbitrum, polygon	Current blockchain
tx_type	string	transfer, swap, erc20_transfer, nft_mint, contract_interaction	Transaction type
priority	string	cost, speed, reliability, balanced	User preference

Try Different Scenarios

1. Small transaction on expensive chain:

curl -X POST https://choreograph-metamask-api.fly.dev/api/v1/route \
  -H "Content-Type: application/json" \
  -d '{"amount": 10, "current_chain": "ethereum", "tx_type": "transfer", "priority": "cost"}'

2. Large transaction (reliability matters):

curl -X POST https://choreograph-metamask-api.fly.dev/api/v1/route \
  -H "Content-Type: application/json" \
  -d '{"amount": 50000, "current_chain": "polygon", "tx_type": "swap", "priority": "reliability"}'

3. Speed-critical transaction:

curl -X POST https://choreograph-metamask-api.fly.dev/api/v1/route \
  -H "Content-Type: application/json" \
  -d '{"amount": 500, "current_chain": "arbitrum", "tx_type": "transfer", "priority": "speed"}'

4. Starting from L2:

curl -X POST https://choreograph-metamask-api.fly.dev/api/v1/route \
  -H "Content-Type: application/json" \
  -d '{"amount": 100, "current_chain": "base", "tx_type": "transfer", "priority": "cost"}'

Integration Example (Python)

import requests

def get_routing_recommendation(amount_usd, current_chain, priority='cost'):
    response = requests.post(
        'https://choreograph-metamask-api.fly.dev/api/v1/route',
        json={
            'amount': amount_usd,
            'current_chain': current_chain,
            'tx_type': 'transfer',
            'priority': priority
        }
    )
    return response.json()

# Example usage
recommendation = get_routing_recommendation(100, 'ethereum')
print(f"Recommended chain: {recommendation['recommended_chain']}")
print(f"Save ${recommendation['savings_usd']:.2f} ({recommendation['savings_percent']:.1f}%)")
print(f"ML Confidence: {recommendation['confidence']*100:.0f}%")

Integration Example (JavaScript/TypeScript)

async function getRoutingRecommendation(
  amountUsd, 
  currentChain,
  priority = 'cost'
) {
  const response = await fetch(
    'https://choreograph-metamask-api.fly.dev/api/v1/route',
    {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        amount: amountUsd,
        current_chain: currentChain,
        tx_type: 'transfer',
        priority: priority
      })
    }
  );
  return response.json();
}

// Example usage
const rec = await getRoutingRecommendation(100, 'ethereum');
console.log(`Recommended: ${rec.recommended_chain}`);
console.log(`Save $${rec.savings_usd.toFixed(2)} (${rec.savings_percent.toFixed(1)}%)`);
console.log(`ML Confidence: ${(rec.confidence * 100).toFixed(0)}%`);

Test the MetaMask Snap (Optional)

We built a consumer-facing MetaMask Snap that shows gas recommendations before transaction confirmation.

Prerequisites

MetaMask Flask (developer version of MetaMask)
Download: https://metamask.io/flask/

Installation Steps

1. Install MetaMask Flask

Install MetaMask Flask browser extension
Create a new test wallet (don't use real funds initially)

2. Get Test ETH (for Sepolia testnet)

Copy your wallet address
Visit: https://www.alchemy.com/faucets/ethereum-sepolia
Request test ETH (free)
Wait 1-2 minutes for funds to arrive

3. Install Choreograph Snap

Visit: http://localhost:8081 (you'll need to run our Snap server locally - see below)
Click "Connect Snap"
Approve permissions in MetaMask Flask
Wait for "Installation complete" message

4. Run the Snap Server (Required)

# Contact us for the Snap source code
git clone [snap-repo-url]
cd choreograph-snap
npm install
npm run serve
# Server will start on http://localhost:8081

5. Test a Transaction

In MetaMask Flask, click "Send"
Enter any address (or use your own secondary address)
Enter amount: 0.001 ETH
Click "Next"
Before confirming, you'll see our recommendation panel with:
- Current chain cost
- Recommended chain
- Potential savings
- ML confidence score
- Reasoning

What You'll See

⚡ Choreograph Gas Optimizer Current chain: ethereum Current cost: $0.0377 Recommended: base Recommended cost: $0.0008 Potential savings: $0.0369 (97.9%) Confidence: 95% Reasoning: • Cost priority: base saves $0.04 • base is 97.9% cheaper

Testing on Mainnet

Warning: Only test with small amounts you're comfortable losing ($0.50-1.00)

Switch MetaMask Flask to Ethereum Mainnet
Initiate a small transaction
Review the recommendation (real mainnet gas prices)
Note: The Snap shows recommendations but doesn't execute cross-chain routing (yet)

Technical Details

Data Sources

Gas prices: Blocknative API (mempool-based estimates) + RPC node fallback
ETH pricing: CoinGecko API (real-time, refreshed every 5 minutes)
Supported chains: Ethereum (mainnet + Sepolia), Base, Arbitrum, Polygon

Performance

Response time: <500ms average
Uptime: 99.9% (Fly.io infrastructure)
Rate limits: None currently (will add if needed)
Caching: ETH price cached for 5 minutes, gas prices fetched fresh each request

Smart Routing Logic

Avoids chain switches for savings <$2 AND <10% (prevents bridge friction for minimal gains)
Prioritizes Ethereum for reliability when priority='reliability' and savings <50%
Balances cost vs speed based on user priority
Compares ALL chains against ALL chains (not just Ethereum vs L2s)

ML Confidence Algorithm

Base confidence: 70%
Time-of-day adjustments: +2% to +8%
Volatility penalty: -5% when cross-chain costs highly variable
Extreme savings boost: +5% when savings >90%
Priority alignment: +10% for cost priority, +18% for reliability
Final range: 65-95%

API Health Check

curl https://choreograph-metamask-api.fly.dev/health

Response:

{
  "service": "Choreograph MetaMask Routing API",
  "status": "healthy",
  "version": "1.0.0"
}

About Choreograph

AI-powered infrastructure to optimize blockchain transaction costs. Currently validating with launch customers.

Current Status:

✅ Production API deployed and operational
✅ Proven 60-99% savings across real transactions
✅ ML-enhanced confidence scoring
🔄 Seeking B2B integration partners

Contact

Telegram: @boggsss