ADEX://API_REFERENCE

Terminal Data API

Public product selection serves 13 mainnets plus one explicit developer testnet, Sepolia. First-party ADEX contract/indexer endpoints are local developer-lab data until a verified public ADEX deployment exists.

Public network coverage

Mainnet chain keys are ethereum, base, bsc, arbitrum, optimism, polygon, avalanche, linea, mantle, sonic, zksync, solana and robinhood. sepolia is the only public developer-testnet selection. The internal registry may contain additional non-public development profiles, but they are not exposed in the product network selector.

The live capability matrix is shown at /developer. Transaction detail uses public JSON-RPC on every public network. Market/chart/trade sources are public and can be temporarily unavailable; ADEX preserves last-confirmed real data where possible. Holder coverage is source-dependent and is never upgraded from aggregate/count data to address rows unless an actual holder index returns those rows.

GET /api/status

Query parameter: chain. Returns family, chain label, mainnet/testnet mode, numeric chain ID where applicable, latest block/slot, RPC latency and online state from the configured public JSON-RPC endpoint.

GET /api/markets

Query parameters: kind and network. all-mainnet covers the 13 production networks only. Selecting sepolia is an explicit testnet request. Results contain only normalized real pool rows returned by public sources, with partial/source-sync state exposed when some networks are temporarily unavailable.

GET /api/token and GET /api/pair

Both endpoints accept a public chain key plus contract/pair address. Mainnet lookups prefer DEX Screener where supported and fall back to GeckoTerminal. Sepolia uses GeckoTerminal's Sepolia Testnet network profile. No fabricated pair is returned when a source has no data.

GET /api/ohlcv and GET /api/trades

These endpoints operate on a GeckoTerminal network identifier plus pool address. OHLCV and trade rows are cached from real upstream data. Requests are serialized and single-flight so temporary public-source limits trigger a cooldown while ADEX keeps serving the last confirmed real dataset where available.

OHLCV never generates synthetic bars. When the API has no real cached candles, the front-end may use a clearly labeled DEX Screener chart fallback on supported mainnets.

GET /api/tx

Required parameters: chain and a native transaction identifier. EVM networks use a 32-byte 0x transaction hash; Solana uses its base58 transaction signature. ADEX reads transaction/block data directly from the selected network's public JSON-RPC. EVM responses include receipt status, native value, nonce, gas, calculated fee, calldata bytes, created contract and log count; Solana responses include slot, status, signer/destination when parsed, fee, account count and instruction count.

GET /api/holders

Required parameters: chain and token contract/mint. Where Blockscout exposes a usable public holder index, ADEX returns up to 50 real holder address rows plus counters. GeckoTerminal holder analytics are used when returned by the public source. On the verified Ethereum/Base/BSC chain IDs, the no-key Honeypot token metadata endpoint can supply totalHolders as a count-only fallback when richer holder rows are unavailable.

HOLDER PRECISION IS EXPLICIT — count/aggregate data is never presented as a top-holder address list. Networks without a reliable no-key holder index remain marked limited/unavailable rather than receiving synthetic holder rows.

GET /api/wallet

Required parameters: chain and public address. Native balance is read from public JSON-RPC on every supported network. ERC-20 balance rows are added when the configured public index supports them. The endpoint never has access to wallet signing material.

GET /api/health

Read-only operational health for the running ADEX instance. It reports public cache freshness, provider cooldown state, local first-party index status, reorg-recovery mode/count, and the Sepolia deployment/index gate. It exposes no admin credentials, private keys or signing material and never sends a transaction.

POST /api/token-submissions

Public metadata-only moderation queue used by /submit-token. The endpoint accepts only ADEX public networks—mainnets plus Sepolia—and validates the token contract/mint for the selected chain. Requests are rate limited. Submitted values can supplement logo, website, X and Telegram links only after admin approval.

GET/POST /api/admin/submissions is admin-session protected and powers the moderation queue in /jaiguruji. Approved submissions are applied only by /api/token-info; they cannot modify prices, liquidity, volume, supply, holders, trades, market cap or security results.

GET /api/adex/deployment-plan

Query parameter: chain. At present only sepolia is accepted. The response includes chain metadata, Sepolia WETH9, compiled ADEXFactory/ADEXRouter ABI and bytecode, compiler settings and contract-report hashes/sizes. It explicitly reports that no server signer exists and wallet confirmation is required.

Mainnet chain keys return HTTP 403 with locked: true. This endpoint prepares browser-wallet deployment data; it does not sign or broadcast a transaction.

GET /api/adex/deployment-check

Sepolia-only read-only verification for a deployed Factory and Router. Required parameters: factory and router. Optional public parameters are feeSetter, factoryTx and routerTx. Mainnet requests are rejected.

The verifier checks Factory runtime bytecode exactly against the current compiled artifact. Router runtime contains constructor immutables, so ADEX reads the compiler-declared immutable-reference offsets from the matching Hardhat build info, masks only those bytes in both runtimes, and compares the remaining runtime hash byte-for-byte. The Router's Factory and wrapped-native immutable values are then independently checked through on-chain getters.

When deployment transaction hashes are supplied, their receipts must succeed and their created contract addresses must match the submitted Factory/Router addresses. This endpoint never signs or broadcasts a transaction.

GET /api/adex/verification-bundle

Sepolia-only read-only downloads generated from the exact Hardhat build-info behind the current ADEX artifacts. Query file=manifest, factory, router or readme to download the bundle manifest, Factory Standard JSON input, Router Standard JSON input or verification instructions.

The generated manifest records compiler identity/settings, source names, exact build-info files, raw-byte and hex-string bytecode hashes, constructor schema, Sepolia WETH and Router immutable-reference metadata. Mainnet requests return HTTP 403 and the endpoint never contains signing material or sends a transaction.

GET /api/adex/source-status

Sepolia-only public source-verification status for a deployed contract address. ADEX reads the no-key Blockscout smart-contract index and reports full/partial verification state, compiler version, optimizer settings, verification time and changed-bytecode status.

The deploy lab treats the source-verification gate as PASS only when both Factory and Router are fully verified and neither is flagged as changed bytecode. This endpoint is read-only; mainnet requests return HTTP 403.

First-party ADEX index APIs

/api/adex/status, /api/adex/pools, /api/adex/quote, /api/adex/swaps, /api/adex/ohlcv and /api/adex/liquidity accept an optional scope. The default scope=local preserves the chain-31337 developer lab. scope=sepolia reads a separate Sepolia snapshot after a verified public deployment manifest has been indexed.

If the Sepolia snapshot does not exist, the API returns an explicit unconfigured/not-ready state instead of falling back to local data. Local and Sepolia SQLite/JSON files are separate, so testnet events can never overwrite or masquerade as local simulation history. Public index startup validates compiled Factory/Router runtime identity and Router Factory/WETH immutables before creating its database.

The Sepolia indexer is started with npm run indexer:sepolia:once or npm run indexer:sepolia:watch after saving the deploy lab's copied manifest as data/adex-sepolia-deployment.json. Pair token metadata is discovered from the actual on-chain ERC-20 contracts. The deploy manifest defaults to a six-block confirmation lag. The indexer stores the last canonical block hash and a deployment fingerprint. A deployment-identity mismatch fails closed; a public canonical reorg is recorded and automatically recovered by clearing only that deployment namespace and replaying from indexedFromBlock. /api/adex/status?scope=sepolia exposes deployment validation, runtime hashes, indexed block, chain head, confirmations, canonical hash, reorg-recovery mode/count and the most recent recovery record.

/api/adex/readiness remains the gate/evidence endpoint and does not enable transactions by itself. The read-only developer dashboard at /developer/sepolia-index visualizes the Sepolia scoped status, deployment-validation evidence, first-party pools, swaps and liquidity events once that snapshot exists.

Pons / Robinhood Chain

GET /api/pons/launches builds the Pons V2 launch board directly from the official Pons Factory on Robinhood Chain. It reads TokenLaunched and PoolGraduated events, resolves each Factory launch record, and batches token/curve state through the canonical Multicall3 contract. No paid API key is required.

GET /api/pons/token?address=0x… verifies whether a token belongs to Pons V2 and returns its bonding curve, quote asset, reserves, graduation threshold/progress, exact Factory graduation phase, fee policy, buyback configuration and public links.

The Pons board maps the Factory lifecycle to New (NotGraduated), Migrating (Swept, or the curve's own readyToGraduate signal) and Migrated (PoolCreated). A Rescued phase is kept separate instead of being presented as migrated.

GET /api/pons/trades?address=0x… indexes the token's actual Pons V2 bonding curve CurveBuy/CurveSell events from Robinhood public RPC and returns settled fills plus effective-price OHLCV candles. New/Migrating tokens use those real curve candles inline; migrated tokens can switch to public DEX OHLCV. GMGN is kept as an external token analytics/trading deep-link rather than embedded, so ADEX needs no paid GMGN API and does not depend on a blocked third-party iframe.

IDENTITY RULE — tokens are keyed by chain plus contract address. Symbol alone is never treated as sufficient identity.