ETH$3,850.00BTC$71,40014 gweiblock#21,458,920[dev]
Developers

The Routescore API & MCP server.

Power plans include a keyed REST API and a one-line MCP server: call cover quotes and the what-if simulator from your own stack, or drop Routescore tools straight into Claude, Cursor, and your agents. Read-only public snapshots and account exports live below.

Power
Public API + MCP

Call Routescore from your own stack

Get started
  1. Generate a key in Account → Developer → API & MCP (Power tier).
  2. Send it as Authorization: Bearer rs_live_… to any endpoint below, or
  3. Drop the MCP config into your client to expose the same tools to your agent.
POST

MEV cover quote

/api/public/v1/quote/mev

Premium + expected/CVaR loss for sandwich protection on a swap.

POST

Bridge refund quote

/api/public/v1/quote/bridge

Cover pricing for cross-chain bridge execution failure.

POST

LRT slashing quote

/api/public/v1/quote/lrt

Slashing cover pricing for an LRT position given AVS exposure.

POST

What-if scenario

/api/public/v1/scenario/simulate

Monte-Carlo expected premium vs refund/loss over a horizon.

GET

Detector manifest

/api/public/v1/benchmark/manifest

Latest public detector run: version hash + eligible universe.

GET

Whoami

/api/public/v1/me

Verify your key works and see its plan tier.

REST quick-start
curl -X POST https://routescore.io/api/public/v1/quote/mev \
  -H "Authorization: Bearer rs_live_..." \
  -H "Content-Type: application/json" \
  -d '{"notional_usd": 10000, "asset_pair": "USDC/ETH"}'
MCP config (Claude / Cursor)
{
  "mcpServers": {
    "routescore": {
      "command": "npx",
      "args": ["-y", "@routescore/mcp"],
      "env": { "ROUTESCORE_API_KEY": "rs_live_..." }
    }
  }
}

Ships as @routescore/mcp. Rate limits apply per key (X-RateLimit-* headers).

Trust envelope
{
  "score_state": "partial",
  "source_freshness": {
    "state": "partial",
    "checked_at": "2026-06-21T00:00:00.000Z",
    "sources": [
      { "name": "routescore_backend", "freshness_state": "fresh" },
      { "name": "bridge_risk_labels", "freshness_state": "unknown" }
    ]
  },
  "methodology_version": "routescore-public-api-v0.1",
  "confidence_band": { "low": null, "high": null, "unit": "bps" },
  "caveats": [
    "Modeled, point-in-time decision support. Not an execution guarantee.",
    "Unsupported or stale inputs widen uncertainty instead of hiding risk."
  ],
  "commercial_disclosure": {
    "paid_placement": false,
    "score_influenced_by_partner": false
  }
}
API posture

Quotes and scenarios are modeled, point-in-time, user-controlled decision support — not investment advice. The export surfaces below are read-only. Routescore does not custody assets, execute transactions, or recommend financial actions. API and MCP responses include score state, source freshness, methodology version, caveats, confidence, and commercial disclosure so downstream tools can keep the trust contract visible. Known limitations are published at /limitations.

Public

Public read-only surfaces

GET

Public snapshot list

/api/snapshot/list

Lists available public detector and benchmark snapshots with freshness metadata.

GET

Public snapshot payload

/api/snapshot/{scanner}

Returns an allowlisted public scanner payload, such as mev_loss_index, stablecoins, bridges, or oracle_map.

GET

Supported-token prices

/api/token-prices?symbols=ETH,USDC,WBTC

Prices only the supported launch token universe. This is not a universal token pricing API.

GET

Route score quote race

/api/route-score?from=0x...&to=0x...&amount=1000000&chainId=1

Returns supported route quote comparison data with rate limits and short cache windows.

Authenticated

User-owned exports

GET

Account export

/api/account/export

Authenticated JSON export containing account, saved wallets, and hash-recorded journal records.

GET

Journal CSV export

/api/journal/export

Authenticated CSV export for durable hash-recorded journal entries.

GET/POST

Alert threshold rules

/api/account/alert-rules

Power-tier public-detector threshold rules. Not wallet-specific alert monitoring.

GET/POST

Detector refresh requests

/api/detector/refresh

Power-tier queue for supported public detector snapshots. Not a contractual freshness guarantee.

Scenario artifact shape
{
  "generated_at": "2026-06-19T00:00:00.000Z",
  "source": "routescore",
  "coverage": {
    "mode": "supported",
    "not_included": ["unsupported tokens", "wallet-specific MEV reconstruction"]
  },
  "scenario": {
    "kind": "stress_test",
    "modeled": true,
    "point_in_time": true,
    "not_investment_advice": true
  }
}
What this unlocks
  • Copy scenario JSON into a notebook or internal memo.
  • Export journal and wallet records for personal archives.
  • Build public detector dashboards from snapshot endpoints.
  • Call quotes & what-if from your own agents via the API / MCP (Power).
Read tutorials