DEX Data & Agent Utilities

Endpoints (62 live)

• GET /random — Cryptographically secure randomness for agents that are deterministic or sandboxed. Two modes: raw bytes (?bytes=1..1024, default 32, clamped) returning hex and base64url; or uniform integers (?min= and ?max= together, optional ?count=1..1000) rejection-sampled so there is no modulo bias. Errors: 400 bad_bytes for a non-integer, bad_range when max is not greater than min, range_too_large. Generated server-side, and the response says so - if nobody may have seen it, generate it yourself. (0.01 USDC on Base)
• GET /edgar/insiders — Ownership changes for one issuer SINCE a cursor: Forms 3/4/5 (Section 16 officers, directors) and Schedules 13D/13G (5%+ holders), amendments included. Returns the FILING-level change and its document URL; share counts inside each Form 4 are NOT parsed and not claimed. Requires ?since=YYYY-MM-DD AND ?ticker= or ?cik=. Optional ?forms=4, ?limit=1..200. Errors: 400 missing_since|missing_issuer, 404 unknown_ticker, 502 edgar_unavailable. AN EMPTY DELTA IS CHARGED. 8-K: /edgar/events. (0.1 USDC on Base)
• GET /lei — Legal Entity Identifier lookup from the GLEIF golden copy, searchable by NAME - knowing the LEI already is the hard part. Returns records[] with lei, legalName, status, jurisdiction, legalAddress and a lapsed flag; LAPSED and RETIRED entities are returned, not hidden - a filtered record and no record look identical. Requires ?q=<legal name, max 200> or ?lei=<20 chars>. Errors: 400 missing_query|bad_lei, 404 no_match, 502 lei_unavailable. Sanctions screening is /sanctions. (0.03 USDC on Base)
• GET /edgar/events — Form 8-K material events for one issuer SINCE a cursor, each item code decoded to the title SEC prints (2.02 Results of Operations, 5.02 Departure of Directors, 1.05 Cybersecurity Incidents). Requires ?since=YYYY-MM-DD AND ?ticker= or ?cik=. Optional ?items=1.01,5.02 (matches ANY), ?limit=1..200. Errors: 400 missing_since|missing_issuer|bad_items, 404 unknown_ticker|unknown_cik, 502 edgar_unavailable, 503 rate_limited_locally. AN EMPTY DELTA IS CHARGED. Every form: /edgar/filings. (0.1 USDC on Base)
• GET /edgar/filings — Every SEC filing by one issuer SINCE a cursor - a delta, not a dump. Requires ?since=YYYY-MM-DD AND ?ticker= or ?cik= (cik wins if both). Optional ?forms=10-K,8-K (also matches /A), ?limit=1..200. Errors: 400 missing_since|missing_issuer|bad_since|bad_ticker|bad_cik|bad_limit, 404 unknown_ticker|unknown_cik, 502 edgar_unavailable, 503 rate_limited_locally. AN EMPTY DELTA IS CHARGED: nothing-changed is the answer you bought. 8-K with decoded items: /edgar/events. Ownership: /edgar/insiders. (0.1 USDC on Base)
• GET /treasury — US Treasury par yield curve, every constant maturity from 1 month to 30 years for a published business day. Returns curve[] with tenor, months and percent, spreads (2s10s, 3m10y, 5s30s) and an explicit inversion flag - the real question is whether the curve is inverted, not what fourteen numbers are. A tenor Treasury did not publish is null, never zero. Pass ?latest=1 OR ?date=YYYY-MM-DD, not both. Errors: 400 conflicting_params|bad_latest|bad_date, 404 no_curve with the available range. (0.03 USDC on Base)
• GET /polygon/scan — Ranked cross-DEX arbitrage spreads across every liquid pair on Polygon PoS (QuickSwap, SushiSwap and Uniswap v3). Returns opportunities[] with pair, grossSpreadBps, buyAt, sellAt, optimalTradeSizeUsd, capturable. GROSS, before gas and MEV. Optional ?minSpreadBps=20 (default 10), minVenueTvlUsd, limit. Send one param: a bare call skips the free tier. Errors: 400 bad_min_spread. Scans EVERY pair; for one known pair use /route. Chain-pinned; bare /scan = BSC. (0.01 USDC on Base)
• GET /polygon/price — Spot token price in USD on Polygon PoS, read from QuickSwap, SushiSwap and Uniswap v3 pools at call time. Returns priceUsd, the routed pair, backing liquidityUsd, confidence and blockNumber. Requires ?symbol=TICKER (e.g. WMATIC) or ?token=0xADDRESS. Errors: 400 missing_symbol|unknown_token, 404 no_reliable_price when pools are too thin, 502 upstream_read_failed. Depth is /liquidity; a size-aware quote is /slippage. Chain-pinned; bare /price = BSC. (0.01 USDC on Base)
• GET /avalanche/scan — Ranked cross-DEX arbitrage spreads across every liquid pair on Avalanche C-Chain (Trader Joe, Pangolin and Uniswap v3). Returns opportunities[] with pair, grossSpreadBps, buyAt, sellAt, optimalTradeSizeUsd, capturable. GROSS, before gas and MEV. Optional ?minSpreadBps=20 (default 10), minVenueTvlUsd, limit. Send one param: a bare call skips the free tier. Errors: 400 bad_min_spread. Scans EVERY pair; for one known pair use /route. Chain-pinned; bare /scan = BSC. (0.01 USDC on Base)
• GET /base/liquidity — Per-venue USD liquidity and TVL for a pair on Base across BaseSwap, SushiSwap and Uniswap v3. Returns totalTvlUsd, venueCount, deepestVenue and venues[] with each venue share and reserves. Requires ?pair=SYM/SYM (e.g. WETH/USDC). Errors: 400 bad_pair (malformed, or a ticker unknown on this chain), 404 no_pools, 502 upstream_read_failed. Raw pool numbers are /reserves; a one-word verdict is /risk; price is /price. Chain-pinned; bare /liquidity = BSC. (0.01 USDC on Base)
• GET /v4hooks — Uniswap v4 hook capability scan on Base mainnet. Decodes all 14 permission bits from the hook address per v4-core Hooks.sol, flags swap custody, fee-taking and EIP-1967 upgradeability, and verifies source by Basescan/Sourcify/Blockscout consensus. Returns custodyClass PASSIVE|FLOW_CONTROL|FEE_TAKING|SWAP_CUSTODY|OPAQUE, flags[], riskFlags[] and verificationState. Requires ?address=0x + 40 hex. Errors: 400 invalid_address, 502 analysis_failed. Capability analysis - it never outputs SAFE. (0.01 USDC on Base)
• GET /avalanche/reserves — Raw AMM pool state for a pair on Avalanche C-Chain: v2 reserves and v3 concentrated liquidity across Trader Joe, Pangolin and Uniswap v3. Returns pools[] with venue, surface, feeBps, reserveA, reserveB, price and tvlUsd at a stated blockNumber. Requires ?pair=SYM/SYM (e.g. WAVAX/USDC). Errors: 400 bad_pair, 404 no_pools, 502 upstream_read_failed. For USD depth already computed use /liquidity. This is the underlying numbers. Chain-pinned; bare /reserves = BSC. (0.01 USDC on Base)
• GET /call — Cross-DEX price, liquidity and gross arbitrage spread for ONE BSC pair in a single call, across PancakeSwap v2/v3, Biswap and ApeSwap. Returns pricesByVenue[], bestBuy, bestSell, midSpreadBps, crossDex (grossSpreadBps, grossUsd, optimalInput) and liquidity at a stated blockNumber. Requires ?pair=SYM/SYM (first symbol is USD-priceable); optional ?fee= pins one v3 tier. Errors: 400 bad_pair|bad_fee, 404 no_pools, 502 upstream_read_failed. Split views: /price, /liquidity, /route. (0.01 USDC on Base)
• GET /sanctions — OFAC screening against the Treasury SDN and Consolidated lists - 19,600+ parties, 40,000+ names including aliases. Returns match, riskLevel, matches[] with score, matchedName, matchedOn and programs, plus screened and notScreened naming what was NOT checked (EU, UK OFSI, UN). Word order does not matter: OFAC stores people SURNAME, Given. Requires ?name= (max 200); optional ?minScore, ?type, ?limit. Errors: 400 missing_name|unsearchable_name, 503 sanctions_list_unavailable - never a false clear. (0.01 USDC on Base)
• GET /route — Cheapest venue to buy and richest to sell ONE pair on BSC / BNB Chain across PancakeSwap v2/v3, Biswap, ApeSwap. Returns buyAt and sellAt (venue, price, tvlUsd), midSpreadBps, grossSpreadBps, optimalInput, venuesConsidered. Requires ?pair=SYM/SYM (e.g. WBNB/USDT). Errors: 400 bad_pair, 404 not_routable, 502 upstream_read_failed. Ranks venues for one pair; to rank EVERY pair use /scan. Execution at a size is /slippage. Bare = BSC; also /polygon /arbitrum /avalanche /optimism /base. (0.01 USDC on Base)
• GET /polygon/risk — Pre-trade depth verdict for a pair on Polygon PoS: is this market thin enough to hurt you. Returns depthClass DEEP|MODERATE|SHALLOW|VERY_THIN, totalTvlUsd, venueCount, topVenueShare, midSpreadBps, flags. Requires ?pair=SYM/SYM (e.g. WMATIC/USDC). Errors: 400 bad_pair, 404 no_pools, 502 upstream_read_failed. Depth only - NOT a contract audit or honeypot check. Per-venue detail is /liquidity. Chain-pinned; bare /risk = BSC. (0.01 USDC on Base)
• GET /optimism/risk — Pre-trade depth verdict for a pair on OP Mainnet: is this market thin enough to hurt you. Returns depthClass DEEP|MODERATE|SHALLOW|VERY_THIN, totalTvlUsd, venueCount, topVenueShare, midSpreadBps, flags. Requires ?pair=SYM/SYM (e.g. WETH/USDC). Errors: 400 bad_pair, 404 no_pools, 502 upstream_read_failed. Depth only - NOT a contract audit or honeypot check. Per-venue detail is /liquidity. Chain-pinned; bare /risk = BSC. (0.01 USDC on Base)
• GET /optimism/reserves — Raw AMM pool state for a pair on OP Mainnet: v2 reserves and v3 concentrated liquidity across SushiSwap and Uniswap v3 fee tiers. Returns pools[] with venue, surface, feeBps, reserveA, reserveB, price and tvlUsd at a stated blockNumber. Requires ?pair=SYM/SYM (e.g. WETH/USDC). Errors: 400 bad_pair, 404 no_pools, 502 upstream_read_failed. For USD depth already computed use /liquidity. This is the underlying numbers. Chain-pinned; bare /reserves = BSC. (0.01 USDC on Base)
• GET /arbitrum/price — Spot token price in USD on Arbitrum One, read from SushiSwap and Uniswap v3 fee tiers pools at call time. Returns priceUsd, the routed pair, backing liquidityUsd, confidence and blockNumber. Requires ?symbol=TICKER (e.g. ARB) or ?token=0xADDRESS. Errors: 400 missing_symbol|unknown_token, 404 no_reliable_price when pools are too thin, 502 upstream_read_failed. Depth is /liquidity; a size-aware quote is /slippage. Chain-pinned; bare /price = BSC. (0.01 USDC on Base)
• GET /polygon/liquidity — Per-venue USD liquidity and TVL for a pair on Polygon PoS across QuickSwap, SushiSwap and Uniswap v3. Returns totalTvlUsd, venueCount, deepestVenue and venues[] with each venue share and reserves. Requires ?pair=SYM/SYM (e.g. WMATIC/USDC). Errors: 400 bad_pair (malformed, or a ticker unknown on this chain), 404 no_pools, 502 upstream_read_failed. Raw pool numbers are /reserves; a one-word verdict is /risk; price is /price. Chain-pinned; bare /liquidity = BSC. (0.01 USDC on Base)

+42 more endpoints.