--- name: x402-endpoints.onrender.com description: x402-endpoints.onrender.com provides three skills focused on token safety assessment and DEX market intelligence: a token safety scorer for EVM fungible tokens, a DEX-CEX spread checker for arbitrage evaluation, and a new DEX pair discovery tool with bundled safety metadata. Together they support pre-trade risk screening and opportunity discovery workflows across major EVM chains and Solana. host: x402-endpoints.onrender.com --- # x402-endpoints.onrender.com This host serves agents that need to evaluate token risk and detect market inefficiencies before committing to trades. It covers two distinct use cases: (1) safety-gating — checking whether a token is a honeypot or has abusive taxes before swapping or recommending it — and (2) opportunity scanning — finding newly launched pools or price discrepancies between DEX and CEX venues. It does not provide order execution, streaming price feeds, historical OHLCV data, or NFT/wallet reputation scoring. ## When to use this host Use this host when an agent needs to screen EVM fungible tokens for honeypot or tax risk before swapping (check-token-safety), discover newly launched DEX pools with instant risk flags (fetch-new-dex-pairs), or evaluate DEX-CEX price discrepancies for potential arbitrage (fetch-dex-cex-spread). Do not use this host for: NFT contract safety, wallet reputation scoring, Solana safety checks (GoPlus is EVM-only), historical OHLCV or candlestick data (use a dedicated price API), real-time streaming price feeds, or as a definitive trade execution signal — gas costs, slippage, and withdrawal delays are not accounted for. For established token price feeds or historical pool data, route to a dedicated OHLCV or market data API instead. ## Capabilities ### Token Safety Screening Assesses the risk profile of EVM fungible token contracts by returning safety scores, honeypot status, tax rates, holder counts, and liquidity context. Foundational gate before any swap or investment action. - **`check-token-safety`** — Returns a 0-100 safety score, honeypot status, buy/sell tax estimates, holder count, liquidity, and market context for a token contract on Base or other EVM chains. ### DEX Market Discovery Discovers newly created DEX liquidity pools on a given chain and optionally bundles per-pair GoPlus safety metadata in a single call, enabling rapid screening of freshly launched tokens. - **`fetch-new-dex-pairs`** — Returns the most recently created DEX liquidity pools on a given chain, with optional per-pair GoPlus safety metadata including honeypot status, tax rates, and risk flags. ### DEX-CEX Arbitrage Detection Compares live DEX prices against major CEX venues (Binance, Bybit) for a given ticker, returning gross and net spread percentages, assumed fees, a profitability flag, and recommended arbitrage direction. - **`fetch-dex-cex-spread`** — Returns live DEX vs CEX price comparison for a given coin ticker, including gross/net spread percentage, assumed fees, profitability flag, and recommended arbitrage direction. ## Workflows ### New Pair Discovery with Safety Gate *Use when an agent needs to surface recently launched DEX pools and then perform a deeper, standalone safety audit on any pair that passes an initial interest threshold.* 1. **`fetch-new-dex-pairs`** — Retrieve the most recently created DEX pairs on a target chain with lightweight safety metadata to identify candidates worth investigating further. 2. **`check-token-safety`** — Run a full safety check on the contract address of any candidate pair to obtain a detailed safety score, honeypot verdict, and tax estimates before acting on the token. ### Arbitrage Opportunity Screening with Safety Validation *Use when an agent needs to evaluate whether a DEX-CEX spread opportunity is worth pursuing and wants to confirm the DEX-side token is not a honeypot or high-tax trap before acting.* 1. **`fetch-dex-cex-spread`** — Identify tokens with a profitable gross spread between a DEX and major CEX venues, capturing the pair URL and DEX chain for the candidate token. 2. **`check-token-safety`** — Validate the DEX-side token contract on the identified chain to confirm it is not a honeypot and does not carry abusive buy/sell taxes that would negate the apparent spread profit. ## Skill reference ### `check-token-safety` **Base Token Safety Check** — Returns a 0-100 safety score, honeypot status, buy/sell tax estimates, holder count, liquidity, and market context for a token contract on Base or other EVM chains. *Use when:* Use when an agent needs to assess the risk of a token before swapping, investing, or recommending it — specifically to detect honeypots, high taxes, or low liquidity on Base, Ethereum, BSC, Polygon, Arbitrum, Optimism, or Avalanche. *Not for:* Do not use for NFT contract safety checks or wallet reputation scoring; this endpoint is scoped to fungible token contracts only. **Inputs:** - `token` (string, required) — Token contract address in 0x hex format (40 hex chars). - `chain` (string) — Chain to query: base | ethereum | bsc | polygon | arbitrum | optimism | avalanche. Defaults to base. **Returns:** Returns safety_score=100, rating='safe', honeypot=false, buy/sell tax 0%, no flags, plus market data (price, liquidity, volume, DEX pair URL) and source attribution from GoPlus, Honeypot.is, and DexScreener. **Example:** `GET https://x402-endpoints.onrender.com/crypto/token-safety?token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&chain=base` --- ### `fetch-dex-cex-spread` **DEX-CEX Spread Checker** — Returns live DEX vs CEX price comparison for a given coin ticker, including gross/net spread percentage, assumed fees, profitability flag, and recommended arbitrage direction. *Use when:* Use when an agent needs to detect price discrepancies between a DEX (e.g. Raydium on Solana) and major CEX venues (Binance, Bybit) for a specific token, to evaluate potential arbitrage opportunities before executing trades. *Not for:* Do not use for real-time streaming price feeds or as a definitive arbitrage execution signal; the response ignores gas costs, slippage, and withdrawal delays and is not financial advice. **Inputs:** - `symbol` (string) — Coin ticker to query, e.g. 'ETH', 'WBTC', 'ARB'. Defaults to 'ETH'. **Returns:** Returns DEX price from Raydium, CEX prices from Binance and Bybit, gross/net spread percentages, a profitability flag, and a recommended arbitrage direction string for the queried token. **Example:** `GET https://x402-endpoints.onrender.com/crypto/dex-cex-spread?symbol=ETH` --- ### `fetch-new-dex-pairs` **New DEX Pairs with Safety Check** — Returns the most recently created DEX liquidity pools on a given chain, with optional per-pair GoPlus safety metadata including honeypot status, tax rates, and risk flags. *Use when:* Use when an agent needs to discover freshly launched token pairs on a specific blockchain (Base, Ethereum, BSC, Polygon, Arbitrum, Solana, etc.) and wants an instant risk screen — honeypot check, open-source status, and safety score — bundled in a single call. *Not for:* Do not use for established token price feeds or historical pool data; use a dedicated price or OHLCV API instead. Not suitable for Solana safety checks — GoPlus safety is EVM-only. **Inputs:** - `chain` (string) — Blockchain to query for new pairs. Accepted values: base | ethereum | bsc | polygon | arbitrum | solana and others. Defaults to 'base'. - `limit` (integer) — Maximum number of new pairs to return. Range: 1–15. Defaults to 5. - `safety` (boolean) — When true, bundles a GoPlus security check per pair (EVM chains only), adding honeypot status, tax percentages, open-source flag, and risk flags. Defaults to true. **Returns:** Returns up to 15 newly created DEX pools with pool address, price, liquidity, FDV, 24h volume, creation timestamp, and a per-pair GoPlus safety object containing honeypot status, tax rates, open-source flag, and risk flags. **Example:** `GET https://x402-endpoints.onrender.com/crypto/new-pairs?chain=base&limit=5&safety=true` ---