Seneschal Data API

Endpoints (33 live)

• GET /v1/q/cheapest-flashloan — Finds the cheapest flashloan option on the network. (0.001 USDC on Base)
• GET /v1/q/xmr/fee — Single-fact: recommended Monero per-byte fee in piconero (also exposed per-kB for convenience). (0.001 USDC on Base)
• GET /v1/q/base-fee — Single-fact: what does Ethereum mainnet gas cost RIGHT NOW? Returns the latest block’s base fee + blob base fee AND the consensus-computed next-block projection (not a guess — the protocol’s own EIP-1559/4844 arithmetic), straight from eth_feeHistory. Fields: {block, base_fee_gwei, blob_base_fee_gwei, gas_used_ratio, next_base_fee_gwei, next_blob_base_fee_gwei}. Bulk per-block history: /v1/premium/fee-history.csv ($0.05, up to 1024 blocks/call). (0.001 USDC on Base)
• GET /v1/q/zec/pools — Single-fact: ZEC supply by value pool (transparent/sprout/sapling/orchard/ironwood/lockbox) + NU6.3 "Ironwood" migration readout — pool balance, Orchard remainder, and migration % once the quantum-recoverable Ironwood pool is live (mainnet target ~2026-07-21). The turnstile makes cross-pool flows public; this is the headline number. Sourced from a live operator-run zebra node. (0.001 USDC on Base)
• GET /v1/q/xmr/height — Single-fact: current Monero chain height + sync status. Sourced from a live operator-run monerod node. (0.001 USDC on Base)
• GET /v1/q/zec/mempool — Single-fact: Zcash mempool count + bytes. (0.001 USDC on Base)
• GET /v1/q/block-value — Single-fact: network-wide percentile block value (proposer payment, ETH) across ALL winning slots in the window — the "is it worth bundling?" number, independent of builder. Returns {value_eth, median_eth, max_eth, samples}. (0.001 USDC on Base)
• GET /v1/q/recent-liquidations — Single-fact: how many on-chain liquidations have we observed in the last `since_min` minutes, with what aggregate debt? Returns {count, total_debt_usd}. (0.001 USDC on Base)
• GET /v1/q/xmr/mempool — Single-fact: number of pending transactions in the Monero mempool right now. (0.001 USDC on Base)
• GET /v1/q/xmr/last-block — Single-fact: timestamp + age of the most recent Monero block, plus hash, difficulty, and size. (0.001 USDC on Base)
• GET /v1/q/proposer-payment — Single-fact: what did the proposer of the latest block ACTUALLY get paid (priority fees + direct coinbase transfers — the value that reaches the validator, not the noisy block-value proxy)? Returns {block, proposer_payment_eth, builder, tx_count} plus a 1h aggregate {samples, mean_eth, median_eth, p90_eth, max_eth}. Per-block history export: /v1/premium/builder-bids.csv ($0.05, CSV or JSONL). (0.001 USDC on Base)
• GET /v1/q/zec/height — Single-fact: current Zcash chain height + verification progress + best block hash. Sourced from a live operator-run zebra node. (0.001 USDC on Base)
• GET /v1/q/zec/last-block — Single-fact: timestamp + age of the most recent Zcash block, plus hash, difficulty, and size. (0.001 USDC on Base)
• GET /v1/q/at-risk-count — Single-fact: how many borrowers have HF < max_hf and debt >= min_debt_usd right now? Returns {count, total_debt_usd}. (0.001 USDC on Base)
• POST /v1/private/topup-1 — Add $1.00 of credit (1_000_000 atomic USDC) to an existing watch. Same body/response shape as /v1/private/topup. (1 USDC on Base)
• POST /v1/private/topup-5 — Add $5.00 of credit (5_000_000 atomic USDC) to an existing watch. Best value tier for high-volume receivers. Same body/response shape as /v1/private/topup. (5 USDC on Base)
• POST /v1/private/historical — One-off historical scan of a Zcash UFVK or Monero address+viewKey. Returns spendable + spent note totals and (optional) per-note breakdown. The view key streams to NFPT in-memory only — nothing is persisted to our DB. Body: { chain, address, viewKey, birthdayHeight?, toHeight?, includeNotes? }. (0.5 USDC on Base)
• POST /v1/private/topup — Add $0.10 of credit (100_000 atomic USDC) to an existing watch. Body: { watchId, watchToken }. Returns the post-top-up credit block. (0.1 USDC on Base)
• POST /v1/premium/private-relay — Private transaction relay: POST a LOCALLY-signed raw transaction and we forward it only to private block builders (Flashbots, Titan, our own rbuilder) — NEVER the public mempool — so it cannot be front-run. You keep custody: we only see signed bytes. Use for any sensitive tx: bounty/CTF claims (see the puzzle-risk feed), large approval revokes, first-touch interactions. Body: { raw_tx: "0x…" }. Returns per-builder accept/reject + the tx hash. Validate free first: GET /v1/private-relay/inspect. (0.5 USDC on Base)
• GET /v1/q/address-risk — Single-fact wallet-safety check: is address X a known approval-drainer (malicious spender harvesting ERC-20 approvals to transferFrom-drain them — the JaredFromSubway $7.5M pattern) or a honeypot/bait token? Returns {flagged, as, risk_score, risk_band, top_flags} from the same live mainnet scanner + scorer as the premium counter-MEV feed. Check before you approve. (0.001 USDC on Base)

+13 more endpoints.