API Reference

Every endpoint, every parameter, every price — generated live from the production catalog. No API key, no signup: call any URL and pay per request in USDC on Base via the x402 protocol.

250 endpointsUSDC on Base0 signup steps1 domain

⚡ Quickstart — your first paid call in 60 seconds

Carredge uses the x402 protocol: unpaid requests receive a machine-readable 402 Payment Required with an on-chain payment challenge. x402-aware clients settle in USDC and retry automatically — no keys, no invoices, no accounts.

Call any endpoint

Plain HTTP GET. No auth headers needed.

Read the 402 challenge

Exact price, payTo address and asset (USDC on Base).

Pay & retry

Your x402 client signs the transfer and resends with X-PAYMENT.

Get data

200 + full JSON payload. Settlement is on-chain.

# 1. Unpaid call → see the exact challenge
curl -i "https://api.carredge.com/v1/funding"

# HTTP/1.1 402 Payment Required
# X-PAYMENT-Requirements: {"accepts":[{"scheme":"exact","network":"base",
#   "maxAmountRequired":"10000","payTo":"0x7c07…","asset":"0x8335…"}]}

# 2. Pay with any x402 client and retry — data returns instantly
npx x402-fetch "https://api.carredge.com/v1/funding"

// x402 fetch wrapper (any EOA with USDC on Base)
import { wrappingFetch } from "x402-fetch";

const res = await wrappingFetch("https://api.carredge.com/v1/funding", {
  account: myBaseAccount,        // signs the USDC transfer
  maxAmountRequired: "10000",    // $0.01 in 6-decimals USDC
});
const funding = await res.json(); // done

# Python agents: pay via any x402 helper or wallet SDK
import requests

r = requests.get("https://api.carredge.com/v1/funding")
# r.status_code == 402 → challenge in headers
# sign the EIP-3009 transfer, then:
r2 = requests.get("https://api.carredge.com/v1/funding",
    headers={"X-PAYMENT": signed_payment_hex})

MCP-native agent? Point your client at https://api.carredge.com/mcp — 21 tools are discoverable and payable through the same protocol.

Moving value cross-chain? Carredge Swap runs on the same rail: free non-custodial widget for humans, and GET /v1/swap ($0.03/quote via x402) for agents — 26+ EVM chains, best route across 6 aggregators (Across, deBridge, THORChain, Mayan, Velora, KyberSwap), no KYC.

📈 Market Data & Trading 35 endpoints

Real-time and historical market intelligence: funding, yields, options IV, open interest, whales, prediction markets, equities and macro — normalized across venues in single calls.

GET /v1/yields $0.005 Try it →

Live DeFi stablecoin pool APYs from DeFiLlama, filterable by chain and TVL

Parameters

Name	Type	Required	Default	Description
?chain	string	no	—	EVM chain slug: ethereum, base, arbitrum, optimism, polygon, bsc…
?limit	number	no	25	Maximum number of results to return
?minTvl	number	no	1000000	Minimum pool TVL in USD (filters low-liquidity pools)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/yields?chain=base"

GET /v1/funding $0.01 Try it →

Perp funding rates from 5 exchanges (Binance, Bybit, Hyperliquid, dYdX, Kraken), normalized to 8h with cross-venue extremes and data hygiene

Parameters

No parameters — call it directly.

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/funding"

GET /v1/predictions $0.01 Try it →

Public prediction market data (Polymarket + Kalshi): prices, volume and YES+NO deviations

Parameters

Name	Type	Required	Default	Description
?limit	number	no	25	Maximum number of results to return
?minVolume	number	no	100000	Minimum 24h volume in USD

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/predictions"

GET /v1/sec-metrics $0.03 Try it →

US company financials from public XBRL data: revenue, net income and EPS (annual + quarterly) in one call

Parameters

Name	Type	Required	Default	Description
?ticker	string	yes		US stock ticker symbol, e.g. AAPL

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/sec-metrics?ticker=AAPL"

GET /v1/funding-history $0.03 Try it →

Normalized multi-exchange funding rate history (Binance+Bybit), up to 90 days — the only such dataset in this marketplace

Parameters

Name	Type	Required	Default	Description
?days	number	no	30	Lookback window in days for the scan (endpoint-specific max applies)
?exchange	string	no	all
?symbol	string	no	BTCUSDT	Gene symbol, e.g. BRCA1, TP53

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/funding-history?symbol=BTCUSDT"

GET /v1/options $0.03 Try it →

Normalized Deribit volatility surface: ATM IV per expiry, range and ATM greeks

Parameters

Name	Type	Required	Default	Description
?currency	string	no	BTC	Underlying asset: BTC or ETH

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/options?currency=BTC"

GET /v1/crypto-history $0.01 Try it →

Historical price series for any coin (CoinGecko): prices, market caps and volumes — daily or hourly granularity for backtesting and charting

Parameters

Name	Type	Required	Default	Description
?days	number	no	30	Lookback window in days for the scan (endpoint-specific max applies)
?ids	string	no	bitcoin	Comma-separated CoinGecko coin IDs, e.g. bitcoin,ethereum
?vs	string	no	usd

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/crypto-history?ids=bitcoin,ethereum"

GET /v1/open-interest $0.005 Try it →

Perp open interest (Binance+Bybit): current, 24h change and hourly series — trader-grade positioning data

Parameters

Name	Type	Required	Default	Description
?symbol	string	no	—	Gene symbol, e.g. BRCA1, TP53

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/open-interest?symbol=BTCUSDT"

GET /v1/market-pulse $0.01 Try it →

One call, full market pulse: price + 24h change + volume + cross-venue funding + open interest

Parameters

Name	Type	Required	Default	Description
?symbol	string	no	—	Gene symbol, e.g. BRCA1, TP53

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/market-pulse?symbol=BTCUSDT"

GET /v1/treasury $0.02 Try it →

US Treasury average interest rates by security type (official Fiscal Data): bills, notes, bonds, TIPS — monthly series

Parameters

Name	Type	Required	Default	Description
?months	string	no	—	Duration in months

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/treasury"

GET /v1/fear-greed $0.005 Try it →

Crypto Fear & Greed Index (alternative.me): current value, yesterday, 30-day history

Parameters

No parameters — call it directly.

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/fear-greed"

GET /v1/gas $0.005 Try it →

Multi-chain gas prices across 12 EVM networks (Ethereum, Base, Arbitrum, Optimism, Polygon, Blast, Berachain, Unichain, Sonic, Ink, Mode, HyperEVM) in gwei — one call

Parameters

No parameters — call it directly.

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/gas"

GET /v1/tvl $0.005 Try it →

DeFi TVL by chain and total (DeFiLlama): top 15 chains ranked

Parameters

Name	Type	Required	Default	Description
?chain	string	no	—	EVM chain slug: ethereum, base, arbitrum, optimism, polygon, bsc…

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/tvl?chain=base"

GET /v1/btc-stats $0.005 Try it →

Bitcoin network stats: recommended fees, mempool size, congestion — one call

Parameters

No parameters — call it directly.

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/btc-stats"

GET /v1/news $0.005 Try it →

Latest crypto news headlines (CoinDesk + Cointelegraph) as clean JSON — no scraping needed

Parameters

Name	Type	Required	Default	Description
?limit	string	no	—	Maximum number of results to return

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/news"

GET /v1/crypto-price $0.005 Try it →

Crypto prices with 24h change, volume and market cap (CoinGecko) — any coin, one call

Parameters

Name	Type	Required	Default	Description
?ids	string	no	—	Comma-separated CoinGecko coin IDs, e.g. bitcoin,ethereum

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/crypto-price?ids=bitcoin,ethereum"

GET /v1/nft-floor $0.005 Try it →

NFT collection floor price and stats (OpenSea): floor, supply, volume, holders

Parameters

Name	Type	Required	Default	Description
?collection	string	no	—

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/nft-floor?collection=boredapeyachtclub"

GET /v1/token-info $0.005 Try it →

ERC-20 token info from any EVM chain (name, symbol, decimals, total supply) — read directly on-chain

Parameters

Name	Type	Required	Default	Description
?address	string	no	—	EVM wallet or contract address (0x…)
?chain	string	no	—	EVM chain slug: ethereum, base, arbitrum, optimism, polygon, bsc…

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/token-info?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&chain=base"

GET /v1/whales $0.01 Try it →

Large on-chain token transfers (whale alerts) — what Whale Alert charges $29+/mo for, pay per call

Parameters

Name	Type	Required	Default	Description
?chain	string	no	—	EVM chain slug: ethereum, base, arbitrum, optimism, polygon, bsc…
?minUsd	string	no	—

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/whales?chain=base"

GET /v1/top-movers $0.005 Try it →

Top 10 crypto gainers and losers (24h) with price, volume and market cap — one call

Parameters

No parameters — call it directly.

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/top-movers"

GET /v1/market-global $0.005 Try it →

Global crypto market structure: total market cap, BTC/ETH dominance, ETH/BTC ratio, 24h change

Parameters

No parameters — call it directly.

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/market-global"

GET /v1/trader-pack $0.03 Try it →

THE trading agent one-call: price + funding + OI + sentiment + market structure + movers + options IV (replaces 7 separate calls)

Parameters

Name	Type	Required	Default	Description
?symbol	string	no	—	Gene symbol, e.g. BRCA1, TP53

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/trader-pack?symbol=BTCUSDT"

GET /v1/defi-scan $0.05 Try it →

THE DeFi one-call: wallet portfolio + risk score + top yields + network fees + actionable insights

Parameters

Name	Type	Required	Default	Description
?address	string	no	—	EVM wallet or contract address (0x…)
?chain	string	no	—	EVM chain slug: ethereum, base, arbitrum, optimism, polygon, bsc…

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/defi-scan?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&chain=base"

GET /v1/stock $0.01 Try it →

Real-time stock quote: price, change, market cap, 52-week range, volume (Yahoo Finance)

Parameters

Name	Type	Required	Default	Description
?symbol	string	no	—	Gene symbol, e.g. BRCA1, TP53

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/stock?symbol=AAPL"

GET /v1/trader-dashboard $0.05 Try it →

COMPLETE trader view: pulse + movers + vol surface + funding history — replaces 4-7 calls

Parameters

Name	Type	Required	Default	Description
?symbol	string	no	—	Gene symbol, e.g. BRCA1, TP53

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/trader-dashboard?symbol=BTCUSDT"

GET /v1/crypto-dd $0.05 Try it →

Full crypto due diligence: price + sentiment + market structure + OI + signals + verdict

Parameters

Name	Type	Required	Default	Description
?symbol	string	no	—	Gene symbol, e.g. BRCA1, TP53

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/crypto-dd?symbol=BTCUSDT"

GET /v1/yield-optimizer $0.05 Try it →

Best DeFi yields ranked by risk-adjusted net score (APY + TVL safety - risk penalty)

Parameters

No parameters — call it directly.

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/yield-optimizer"

GET /v1/fx $0.02 Try it →

FX rates for any pair (ECB reference): latest + 30-day history in one call

Parameters

Name	Type	Required	Default	Description
?from	string	no	—	Source value, unit, currency or text
?to	string	no	—	0x contract address the transaction targets

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/fx?from=USD&to=EUR"

GET /v1/macro $0.02 Try it →

US macro indicators in one call: CPI, unemployment, payrolls and earnings (BLS)

Parameters

No parameters — call it directly.

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/macro"

GET /v1/stock-history $0.01 Try it →

Historical daily stock prices (OHLCV) for any US ticker — up to 10 years of data with change %, min/max and the full series

Parameters

Name	Type	Required	Default	Description
?symbol	string	yes	—	Gene symbol, e.g. BRCA1, TP53
?days	number	no	90	Lookback window in days for the scan (endpoint-specific max applies)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/stock-history?symbol=AAPL"

GET /v1/stock-tokens $0.005 Try it →

Robinhood stock tokens on chain 4663: the complete catalog of ~194 tokenized equities and ETFs (AAPL, NVDA, SPY…) with ISIN, verifiable ERC-20 contract, live bid/ask and spread, daily high/low, share volume, on-chain mint/burn flow and halt status — searchable by symbol, name or ISIN. 30s cache, keyless

Parameters

Name	Type	Required	Default	Description
?limit	string	no	—	Maximum number of results to return
?q	string	no	—	Search query or free-text question

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/stock-tokens?q=AAPL"

GET /v1/stock-token $0.005 Try it →

Single stock token card by symbol or ISIN: live bid/ask with spread, daily range, 24h share volume, on-chain mint/burn volume, trading-halt status, verifiable ERC-20 contract on Robinhood Chain 4663 and upcoming cash-dividend corporate actions. 15s cache, keyless

Parameters

Name	Type	Required	Default	Description
?symbol	string	yes	—	Gene symbol, e.g. BRCA1, TP53
?isin	string	no	—	ISIN of a tokenized security, e.g. US0378331005 (Apple) — alternative to symbol for stock tokens

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/stock-token?symbol=AAPL"

GET /v1/stock-tokens-hot $0.01 Try it →

Most active Robinhood stock tokens ranked by real on-chain mint/burn USD volume — the token flow actually hitting chain 4663, not the underlying equity tape — with live bid/ask per token. No 24h % change is provided because the upstream API exposes no open/previous-close (no fabricated data). 60s cache

Parameters

Name	Type	Required	Default	Description
?limit	string	no	—	Maximum number of results to return

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/stock-tokens-hot?limit=10"

GET /v1/fx-history $0.01 Try it →

Historical FX rates from the European Central Bank: any date or date range, any currency pair — official reference rates

Parameters

Name	Type	Required	Default	Description
?base	string	no	USD	Base value, color or currency
?date	string	no	—	Date in YYYYMMDD format (BOE summary)
?end	string	no	—	Range end (date, timestamp or price)
?start	string	no	—	Range start (date, timestamp or price)
?symbols	string	no	—	Comma-separated list of trading pair symbols

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/fx-history?base=USD&date=2026-01-15&end=2026-01-31&start=2026-01-01&symbols=EUR"

GET /v1/edge $0.01 Try it →

Net edge calculator: funding carry, cross-exchange spread, prediction-market arb, impermanent loss and Kelly sizing

Parameters

Name	Type	Required	Default	Description
?type	string	no		Sub-type selector for the dataset

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/edge?type=funding"

🛡️ Compliance & Risk 7 endpoints

KYC-grade screening at API speed: OFAC sanctions, EU VAT validation, fraud scoring and full business verification — what legacy vendors charge $1.35+ per check for.

GET /v1/sanctions $0.05 Try it →

OFAC SDN sanctions screening: check person or entity against US Treasury sanctions list — what competitors charge €0.10+ for

Parameters

Name	Type	Required	Default	Description
?name	string	no	—	Name to look up: a medication (rxnorm/rxterms), person (sanctions, orcid) or company
?strict	string	no	—

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/sanctions?name=vitalik.eth"

GET /v1/vat-check $0.05 Try it →

EU VAT number validation via VIES: verify if VAT is registered, get company name and address — mandatory for EU B2B

Parameters

Name	Type	Required	Default	Description
?country	string	no	—	ISO country code, e.g. US, DE, ES
?vatNumber	string	no	—	EU VAT number including country prefix

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/vat-check?country=IE&vatNumber=IE6388047V"

GET /v1/compliance-scan $0.10 Try it →

Full compliance scan: sanctions + wallet risk + contract analysis + domain/SSL — what competitors charge $1.35+ for

Parameters

No parameters — call it directly.

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/compliance-scan"

GET /v1/company-risk $0.03 Try it →

Company risk assessment: SEC filings + DNS + SSL + WHOIS + domain age — aggregated risk score with verdict

Parameters

No parameters — call it directly.

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/company-risk"

GET /v1/fraud-score $0.05 Try it →

Aggregate fraud risk score: SSL + DNS + WHOIS + IP reputation + email validation + wallet analysis — what Fingerprint charges $0.10-$1.00 for

Parameters

No parameters — call it directly.

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/fraud-score"

GET /v1/business-verify $0.10 Try it →

Full business verification: SEC + OFAC sanctions + domain + fraud score → VERIFIED/PARTIAL/REJECT verdict — what Middesk charges $0.50-$5.00 for

Parameters

No parameters — call it directly.

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/business-verify"

GET /v1/gleif $0.01 Try it →

Company identity via LEI (Legal Entity Identifier) from the Global LEI Foundation: search by legal name or exact LEI code, with registration status, country, legal form and direct corporate parent — keyless official data

Parameters

Name	Type	Required	Default	Description
?q	string	yes	—	Search query or free-text question
?limit	number	no	10	Maximum number of results to return

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/gleif?q=Apple"

⛓️ Web3 & On-Chain 30 endpoints

Wallet analysis, contract inspection, transaction explanations and portfolio snapshots read directly from the chain across EVM networks.

GET /v1/ens $0.005 Try it →

ENS name resolution (.eth to address) via public Ethereum RPC

Parameters

Name	Type	Required	Default	Description
?name	string	no	—	Name to look up: a medication (rxnorm/rxterms), person (sanctions, orcid) or company

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/ens?name=vitalik.eth"

GET /v1/wallet $0.02 Try it →

Full wallet portfolio for any address on Base or Ethereum: native balance, all tokens, USD values, token count

Parameters

Name	Type	Required	Default	Description
?address	string	no	—	EVM wallet or contract address (0x…)
?chain	string	no	—	EVM chain slug: ethereum, base, arbitrum, optimism, polygon, bsc…

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/wallet?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&chain=base"

GET /v1/wallet-risk $0.02 Try it →

Wallet risk score (0-100) with verdict and risk factors: age, activity, contract status — what ChainVerdict charges $0.10 for

Parameters

Name	Type	Required	Default	Description
?address	string	no	—	EVM wallet or contract address (0x…)
?chain	string	no	—	EVM chain slug: ethereum, base, arbitrum, optimism, polygon, bsc…

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/wallet-risk?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&chain=base"

GET /v1/contract $0.02 Try it →

Smart contract analysis: verified? proxy? compiler? implementation? risk level with factors

Parameters

Name	Type	Required	Default	Description
?address	string	no	—	EVM wallet or contract address (0x…)
?chain	string	no	—	EVM chain slug: ethereum, base, arbitrum, optimism, polygon, bsc…

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/contract?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&chain=base"

GET /v1/tx $0.01 Try it →

Transaction breakdown: status, method called, token transfers decoded, fees, timestamps

Parameters

Name	Type	Required	Default	Description
?chain	string	no	—	EVM chain slug: ethereum, base, arbitrum, optimism, polygon, bsc…
?hash	string	no	—

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/tx?chain=base&hash=0xb8f6cf533f9c33f61baf9b996f5b9e4325ab6ac4698d8468b490811efa782685"

GET /v1/airdrop-check $0.05 Try it →

Wallet airdrop eligibility: activity + age + risk + current yield opportunities — one call

Parameters

No parameters — call it directly.

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/airdrop-check"

GET /v1/new-pairs $0.005 Try it →

Brand-new liquidity pools (GeckoTerminal) with age, FDV, liquidity, buys/sells and price change — filter by freshness in minutes; the degen entry point before checking /v1/rug-check

Parameters

Name	Type	Required	Default	Description
?chain	string	no	—	EVM chain slug: ethereum, base, arbitrum, optimism, polygon, bsc…
?limit	string	no	—	Maximum number of results to return
?maxAgeMin	string	no	—

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/new-pairs?chain=base&maxAgeMin=60"

GET /v1/token-holders $0.01 Try it →

Top token holders with supply concentration, contract/scam flags and on-chain labels (Blockscout) — the rug radar: top-10 above 50% is the classic setup

Parameters

Name	Type	Required	Default	Description
?address	string	no	—	EVM wallet or contract address (0x…)
?chain	string	no	—	EVM chain slug: ethereum, base, arbitrum, optimism, polygon, bsc…
?limit	string	no	—	Maximum number of results to return

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/token-holders?address=0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed&chain=base"

GET /v1/wallet-age $0.01 Try it →

Wallet age on any EVM chain: first outbound transaction found by binary search of the nonce over public RPC — anti-sybil and airdrop eligibility, no explorer needed

Parameters

Name	Type	Required	Default	Description
?address	string	no	—	EVM wallet or contract address (0x…)
?chain	string	no	—	EVM chain slug: ethereum, base, arbitrum, optimism, polygon, bsc…

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/wallet-age?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&chain=ethereum"

GET /v1/wallet-pnl $0.02 Try it →

Estimated wallet PnL: token flows from Blockscout transfers, current prices, and OHLCV-derived entry prices for top positions → unrealized PnL and win rate (clearly labeled ESTIMATED)

Parameters

Name	Type	Required	Default	Description
?address	string	no	—	EVM wallet or contract address (0x…)
?chain	string	no	—	EVM chain slug: ethereum, base, arbitrum, optimism, polygon, bsc…
?transfers	string	no	—

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/wallet-pnl?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&chain=ethereum"

GET /v1/copy-trades $0.02 Try it →

Recent decoded transaction feed of any wallet: method, target, value and arguments — point it at a proven wallet (check /v1/wallet-pnl first) and mirror its moves

Parameters

Name	Type	Required	Default	Description
?address	string	no	—	EVM wallet or contract address (0x…)
?chain	string	no	—	EVM chain slug: ethereum, base, arbitrum, optimism, polygon, bsc…
?limit	string	no	—	Maximum number of results to return

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/copy-trades?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&chain=ethereum"

GET /v1/depeg $0.005 Try it →

Stablecoin peg health: live price vs $1 for the major stables with deviation in basis points, alerts above threshold and net mint/burn flows — systemic risk in one call

Parameters

Name	Type	Required	Default	Description
?thresholdBps	string	no	—

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/depeg"

GET /v1/liquidation-levels $0.01 Try it →

Liquidation ladder for perp assets: live open interest and mark price (Hyperliquid) with estimated USD liquidation clusters per price move — clearly labeled statistical ESTIMATE

Parameters

Name	Type	Required	Default
?asset	string	no	—
?avgLeverage	string	no	—
?levels	string	no	—

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/liquidation-levels?asset=BTC"

GET /v1/stablecoin-flows $0.01 Try it →

Aggregate stablecoin flows: total circulating, net 24h/7d mint-burn flows and the biggest movers — the whale-scale macro signal

Parameters

Name	Type	Required	Default	Description
?limit	string	no	—	Maximum number of results to return

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/stablecoin-flows"

GET /v1/lp-positions $0.02 Try it →

Liquidity-provider positions: V2 pair detection on any wallet (or ?pair= for a single pool) with reserves, share, underlying amounts and USD values — the Moralis premium feature

Parameters

Name	Type	Required	Default	Description
?address	string	no	—	EVM wallet or contract address (0x…)
?chain	string	no	—	EVM chain slug: ethereum, base, arbitrum, optimism, polygon, bsc…
?limit	string	no	—	Maximum number of results to return
?pair	string	no	—

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/lp-positions?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&chain=ethereum&pair=0xB4e16d0168e52d35CaCD2c6185b44281Ec28C9Dc"

GET /v1/impermanent-loss-live $0.01 Try it →

Live impermanent loss for a real pool: reserves read from the chain, the full IL curve, and a personalized section (price change, fees earned, your LP amount) — same engine as /v1/il-calc

Parameters

Name	Type	Required	Default	Description
?chain	string	no	—	EVM chain slug: ethereum, base, arbitrum, optimism, polygon, bsc…
?days	string	no	—	Lookback window in days for the scan (endpoint-specific max applies)
?feeApr	string	no	—
?lpAmount	string	no	—
?pair	string	no	—
?priceChangePercent	string	no	—

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/impermanent-loss-live?chain=ethereum&pair=0xB4e16d0168e52d35CaCD2c6185b44281Ec28C9Dc&priceChangePercent=25"

GET /v1/pt-yt-rates $0.01 Try it →

Pendle markets live: PT implied APY, LP aggregated APY, fees, yield range and liquidity per market — fixed-yield rates without keys

Parameters

Name	Type	Required	Default	Description
?chain	string	no	—	EVM chain slug: ethereum, base, arbitrum, optimism, polygon, bsc…
?limit	string	no	—	Maximum number of results to return
?market	string	no	—

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/pt-yt-rates?chain=base"

GET /v1/trending-crypto $0.005 Try it →

Trending coins (CoinGecko): the most searched tokens of the last 24h with rank, price, change and market cap — the social-demand hook

Parameters

No parameters — call it directly.

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/trending-crypto"

GET /v1/snapshot-proposals $0.005 Try it →

DAO governance proposals (Snapshot): latest proposals by space with state, votes, scores and deadlines — for voting agents

Parameters

Name	Type	Required	Default	Description
?limit	string	no	—	Maximum number of results to return
?space	string	no	—
?state	string	no	—	2-letter US state abbreviation, e.g. CA or TX

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/snapshot-proposals?space=valleybio.eth"

GET /v1/farcaster-feed $0.01 Try it →

Recent Farcaster casts of any fid (hub.pinata.cloud): text, timestamps and embeds — the on-chain social graph for agents

Parameters

Name	Type	Required	Default	Description
?fid	string	no	—
?limit	string	no	—	Maximum number of results to return

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/farcaster-feed?fid=3"

GET /v1/smart-money $0.01 Try it →

Smart-money radar: large on-chain transfers per token (Blockscout) enriched with 24h momentum, liquidity (DexScreener) and honeypot flags (GoPlus) → HOT_FLOW / WATCH / AVOID verdicts

Parameters

Name	Type	Required	Default	Description
?chain	string	no	—	EVM chain slug: ethereum, base, arbitrum, optimism, polygon, bsc…
?limit	string	no	—	Maximum number of results to return
?minUsd	string	no	—

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/smart-money?chain=base&minUsd=50000"

GET /v1/onchain-portfolio $0.05 Try it →

Complete onchain portfolio: tokens + NFTs + yield opportunities + network fees — replaces 4-5 calls

Parameters

No parameters — call it directly.

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/onchain-portfolio"

GET /v1/trade-solana $0.03 Try it →

Solana swap engine (Jupiter, keyless): quote + ready-to-sign swap transaction with the Carredge platform fee embedded (1% default, 0-300 bps override) — SOL, USDC and any routed token, no API key, no custody

Parameters

Name	Type	Required	Default	Description
?user	string	yes	—	Solana public key that will sign and execute the swap transaction (base64 tx is built for this key)
?amount	string	no	—	Amount in base units (USD, tokens, shares…)
?enrich	string	no	—	Set to 1 to enrich the quote with DexScreener token cards (logo, socials, liquidity) for both mints
?feeBps	string	no	—	Optional fee override in basis points. Swap: 0-50, default 10 bps for API agents. trade-solana: 0-300 (platform fee embedded via Jupiter platformFeeBps), default 100 = 1%
?inputMint	string	no	—	Solana mint address of the input token (e.g. So11111111111111111111111111111111111111112 for SOL)
?outputMint	string	no	—	Solana mint address of the output token (e.g. EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v for USDC)
?slippageBps	string	no	—	Slippage tolerance in basis points (trade-solana: 0-3000 default 50; memecoin: 0-5000 default 300)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/trade-solana?user=4CqM4L9atJ1adqz9CXEtXeeyHTyG4FLSdezi26T2jZWv&amount=100000000&feeBps=100&inputMint=So11111111111111111111111111111111111111112&outputMint=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

GET /v1/memecoin $0.03 Try it →

Memecoin buy engine: Zora coins on Base (Uniswap V4 with the Carredge trade-referrer embedded — the protocol pays us, not you), Solana pre-graduation LaunchLab coins (bonding-curve buys via Jupiter or the Raydium Transaction API with the Carredge referrer fee embedded) and Robinhood Chain 4663 early positioning — contract verification, graduation detection, live quote and ready-to-sign transaction

Parameters

Name	Type	Required	Default	Description
?address	string	no	—	EVM wallet or contract address (0x…)
?amount	string	no	—	Amount in base units (USD, tokens, shares…)
?amountLamports	string	no	—
?amountWei	string	no	—	Exact wei amount to spend (alternative to amount= USD, for memecoin buys)
?chain	string	no	—	EVM chain slug: ethereum, base, arbitrum, optimism, polygon, bsc…
?feeBps	string	no	—	Optional fee override in basis points. Swap: 0-50, default 10 bps for API agents. trade-solana: 0-300 (platform fee embedded via Jupiter platformFeeBps), default 100 = 1%
?recipient	string	no	—	0x address that receives the output token on the destination chain (defaults to depositor)
?side	string	no	—	Direction: long or short / buy or sell
?slippageBps	string	no	—	Slippage tolerance in basis points (trade-solana: 0-3000 default 50; memecoin: 0-5000 default 300)
?user	string	no	—	Solana public key that will sign and execute the swap transaction (base64 tx is built for this key)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/memecoin?address=0x1350e3788413094a61480f9cf9d24b37866a0dd7&amount=10&chain=base&feeBps=10"

GET /v1/hot $0.01 Try it →

Hot tokens leaderboard, live: trending Solana/Base/Robinhood Chain tokens, Zora top gainers, fresh Base pools and the most active Robinhood stock tokens — each with full token card (logo, socials, explorer links, price, 24h change, volume, liquidity), interleaved across chains. 60s cache, keyless sources

Parameters

Name	Type	Required	Default	Description
?limit	string	no	—	Maximum number of results to return

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/hot?limit=10"

GET /v1/bet/odds $0.01 Try it →

Live on-chain sports betting odds from the Azuro protocol (keyless): games by sport with league, teams and start time plus the main markets (1X2/moneyline, totals, handicaps) with decimal odds per outcome and the Azuro gameId/conditionId needed to quote and place bets

Parameters

Name	Type	Required	Default	Description
?environment	string	no	—	Azuro environment: PolygonUSDT (default) or GnosisXDAI
?gameState	string	no	—	prematch (default) or live
?limit	string	no	—	Maximum number of results to return
?marketsPerGame	string	no	—	Markets to return per game, 1-20 (default 8)
?sport	string	no	—	Sport slug: football, basketball, mma, hockey, baseball, tennis, cricket, table-tennis, cs2… (aliases: soccer, nhl, ufc)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/bet/odds?limit=3&sport=football"

GET /v1/bet/quote $0.03 Try it →

On-chain bet quote (Azuro, Polygon USDT): live odds for one outcome, protocol min/max bet, potential payout and a ready-to-sign EIP-712 typedData with the Carredge affiliate embedded in clientData — the user signs with their own wallet and pays the standard relayer fee (no sponsorship); Carredge never holds funds

Parameters

Name	Type	Required	Default	Description
?amount	string	yes	—	Amount in base units (USD, tokens, shares…)
?conditionId	string	yes	—	Azuro condition (market) id from /v1/bet/odds
?outcomeId	string	yes	—	Azuro outcome id from /v1/bet/odds
?environment	string	no	—	Azuro environment: PolygonUSDT (default) or GnosisXDAI

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/bet/quote?amount=10&conditionId=300610060000000000311152010000000000012768900408&outcomeId=7047"

GET /v1/bet/submit $0.05 Try it →

Submit a user-signed bet to the Azuro Relayer: validates the EIP-712 signature format, live market state and protocol bet limits, then forwards the order for on-chain execution (the bettor pays the standard relayer fee — no sponsorship) — returns the Azuro orderId to track. The user signs; Carredge is middleware and never holds funds or places bets itself

Parameters

Name	Type	Required	Default	Description
?bettor	string	yes	—	0x address that signed the typed data — it will own the AzuroBet NFT
?signature	string	yes	—	eth_signTypedData_v4 output: 0x + 130 hex chars
?amountRaw	string	no	—	Bet size in raw token units (from /v1/bet/quote)
?conditionId	string	no	—	Azuro condition (market) id from /v1/bet/odds
?environment	string	no	—	Azuro environment: PolygonUSDT (default) or GnosisXDAI
?expiresAt	string	no	—	Quote expiry in unix seconds (from /v1/bet/quote)
?minOdds	string	no	—	Worst acceptable odds in raw units (from /v1/bet/quote — protects against odds moving)
?nonce	string	no	—	Random nonce from /v1/bet/quote (part of the signature)
?outcomeId	string	no	—	Azuro outcome id from /v1/bet/odds
?relayerFeeAmount	string	no	—	Raw relayer fee from the quote, paid by the bettor (per Azuro gas-info; 0 today — never sponsored)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/bet/submit?bettor=0x7c078DA9DEFf3398e81Ac6323fC95A47941F2a0C&signature=0xababababababababababababababababababababababababababababababababababababababababababababababababababababababababababababababababab&amountRaw=10000000&conditionId=300610060000000000311152010000000000012768900408&environment=PolygonUSDT&outcomeId=7047"

GET /v1/swap $0.03 Try it →

Multi-aggregator swap quote: Across + deBridge + THORChain + Mayan race cross-chain routes (route-dependent), Velora + KyberSwap race same-chain routes, all with the Carredge fee embedded — returns the best net amountOut with ready-to-sign calldata plus every alternative. You execute on-chain yourself, Carredge never holds funds

Parameters

Name	Type	Required	Default	Description
?amount	string	yes	—	Amount in base units (USD, tokens, shares…)
?depositor	string	yes	—	0x address that will sign and execute the swap transaction
?fromChain	string	yes	—	Origin chain id (numeric EVM), e.g. 8453 Base, 1 Ethereum, 10 Optimism, 42161 Arbitrum
?fromToken	string	yes	—	Input token contract address on the origin chain (0x0000…0000 for native ETH)
?toChain	string	yes	—	Destination chain id (numeric EVM) — must differ from fromChain
?toToken	string	yes	—	Output token contract address on the destination chain (0x0000…0000 for native ETH)
?feeBps	string	no	—	Optional fee override in basis points. Swap: 0-50, default 10 bps for API agents. trade-solana: 0-300 (platform fee embedded via Jupiter platformFeeBps), default 100 = 1%
?recipient	string	no	—	0x address that receives the output token on the destination chain (defaults to depositor)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/swap?amount=10000000&depositor=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&fromChain=8453&fromToken=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&toChain=10&toToken=0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85"

GET /v1/swap/compare $0.03 Try it →

Side-by-side swap comparison across every live aggregator for one route (Across, deBridge, THORChain, Mayan, Velora, KyberSwap — route-dependent): net amountOut, our fee, protocol costs and fill time ranked best-first, with the full quotes — same price as /v1/swap, one call

Parameters

Name	Type	Required	Default	Description
?amount	string	yes	—	Amount in base units (USD, tokens, shares…)
?depositor	string	yes	—	0x address that will sign and execute the swap transaction
?fromChain	string	yes	—	Origin chain id (numeric EVM), e.g. 8453 Base, 1 Ethereum, 10 Optimism, 42161 Arbitrum
?fromToken	string	yes	—	Input token contract address on the origin chain (0x0000…0000 for native ETH)
?toChain	string	yes	—	Destination chain id (numeric EVM) — must differ from fromChain
?toToken	string	yes	—	Output token contract address on the destination chain (0x0000…0000 for native ETH)
?feeBps	string	no	—	Optional fee override in basis points. Swap: 0-50, default 10 bps for API agents. trade-solana: 0-300 (platform fee embedded via Jupiter platformFeeBps), default 100 = 1%
?recipient	string	no	—	0x address that receives the output token on the destination chain (defaults to depositor)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/swap/compare?amount=10000000&depositor=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&fromChain=8453&fromToken=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&toChain=10&toToken=0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85"

🔐 On-Chain Security 12 endpoints

The checks that stop an agent from losing money: honeypot detection with real buy/sell simulation, taxes, approvals scanning, proxy detection, verified sources and a composite contract audit — what GoPlus, TokenSniffer and revoke.cash charge for, pay per call.

GET /v1/contract-audit $0.05 Try it →

Composite smart-contract audit v2: verified source (Sourcify+Blockscout), proxy detection via EIP-1967/1167 storage slots, honeypot simulation, taxes, LP lock and holder concentration → score 0-100 with severity-ranked findings

Parameters

No parameters — call it directly.

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/contract-audit?address=0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2&chain=ethereum"

GET /v1/token-security $0.02 Try it →

Token security report for any ERC-20 (GoPlus intelligence): honeypot detection, buy/sell taxes, holder concentration, LP lock, owner powers and a 0-100 risk score with flagged risks

Parameters

Name	Type	Required	Default	Description
?address	string	no	—	EVM wallet or contract address (0x…)
?chain	string	no	—	EVM chain slug: ethereum, base, arbitrum, optimism, polygon, bsc…

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/token-security?address=0x940181a94A35A4569E4529A3CDfB74e38FD98631&chain=base"

POST /v1/simulate-tx $0.01 Try it →

Transaction simulation before signing: would it revert (with the decoded revert reason), gas estimate, native-balance check and decoded call — Tenderly-grade simulation, keyless. POST JSON body or query params

Parameters

Name	Type	Required	Default	Description
chain	string	no	—	EVM chain slug: ethereum, base, arbitrum, optimism, polygon, bsc…
data	string	no	—	Raw input for the operation: 0x-hex calldata (decode/simulate) or JSON payload (transform endpoints)
sender	string	no	—	0x address that would sign the transaction (optional — omit for a state-only check)
to	string	no	—	0x contract address the transaction targets
value	string	no	—	ETH value attached to the transaction, in wei (decimal or 0x-hex; default 0)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i -X POST "https://api.carredge.com/v1/simulate-tx?chain=base&data=0xa9059cbb000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa960450000000000000000000000000000000000000000000000000000000000000001&sender=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&to=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&value=100" \
  -H 'Content-Type: application/json' \
  -d '{...}'

GET /v1/approvals $0.02 Try it →

Active ERC-20 approvals for any wallet: token, spender and amount (unlimited flagged) with a live allowance() check — the revoke.cash scan, pay per call

Parameters

Name	Type	Required	Default	Description
?address	string	no	—	EVM wallet or contract address (0x…)
?chain	string	no	—	EVM chain slug: ethereum, base, arbitrum, optimism, polygon, bsc…
?days	string	no	—	Lookback window in days for the scan (endpoint-specific max applies)
?limit	string	no	—	Maximum number of results to return

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/approvals?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&chain=ethereum&days=7"

GET /v1/honeypot-check $0.01 Try it →

Real honeypot simulation (honeypot.is): buy, sell and transfer executed on-chain with taxes and gas measured, risk verdict — know before the first buy, not after

Parameters

Name	Type	Required	Default	Description
?address	string	no	—	EVM wallet or contract address (0x…)
?chain	string	no	—	EVM chain slug: ethereum, base, arbitrum, optimism, polygon, bsc…

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/honeypot-check?address=0x940181a94A35A4569E4529A3CDfB74e38FD98631&chain=base"

GET /v1/contract-source $0.005 Try it →

Full verified contract source code (Sourcify v2): files, compiler, license, match type — the Etherscan Pro feature, pay per call

Parameters

Name	Type	Required	Default	Description
?address	string	no	—	EVM wallet or contract address (0x…)
?chain	string	no	—	EVM chain slug: ethereum, base, arbitrum, optimism, polygon, bsc…

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/contract-source?address=0x4200000000000000000000000000000000000006&chain=base"

GET /v1/proxy-detect $0.005 Try it →

Proxy pattern detection via canonical storage slots and bytecode (EIP-1967, EIP-1167 clones, custom slots): implementation, admin, beacon — know what can be upgraded behind a contract

Parameters

Name	Type	Required	Default	Description
?address	string	no	—	EVM wallet or contract address (0x…)
?chain	string	no	—	EVM chain slug: ethereum, base, arbitrum, optimism, polygon, bsc…

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/proxy-detect?address=0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2&chain=ethereum"

GET /v1/address-security $0.01 Try it →

Address risk report (GoPlus): phishing, mixer, sanctioned, stealing attack, darkweb, honeypot-related and a dozen more flags with a 0-100 score and verdict — compliance screening at API speed

Parameters

Name	Type	Required	Default	Description
?address	string	no	—	EVM wallet or contract address (0x…)
?chain	string	no	—	EVM chain slug: ethereum, base, arbitrum, optimism, polygon, bsc…

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/address-security?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&chain=ethereum"

GET /v1/nft-security $0.01 Try it →

NFT collection security report (GoPlus): proxy, restricted approval, privileged minting, transfer-without-approval and mint-revoke flags — the wallet-drainer checklist

Parameters

Name	Type	Required	Default	Description
?address	string	no	—	EVM wallet or contract address (0x…)
?chain	string	no	—	EVM chain slug: ethereum, base, arbitrum, optimism, polygon, bsc…

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/nft-security?address=0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB&chain=ethereum"

GET /v1/phishing-check $0.005 Try it →

Phishing database check for any domain (GoPlus): is it a known phishing site — cheap, high-volume protection for agents navigating the web

Parameters

Name	Type	Required	Default	Description
?url	string	no	—	Target public URL (SSRF-guarded: private IPs and non-HTTP schemes are rejected)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/phishing-check?url=app.uniswap.org"

GET /v1/dapp-security $0.005 Try it →

Dapp security and audit report (GoPlus): known audits (firm, date, link), trust-list status and per-chain contract flags for any known dapp

Parameters

Name	Type	Required	Default	Description
?url	string	no	—	Target public URL (SSRF-guarded: private IPs and non-HTTP schemes are rejected)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/dapp-security?url=app.uniswap.org"

GET /v1/rug-check $0.02 Try it →

Composite rug check: honeypot simulation + taxes + liquidity depth + LP lock + holder concentration + GoPlus flags → score 0-100 with ranked reasons (RUG_LIKELY to OK)

Parameters

Name	Type	Required	Default	Description
?address	string	no	—	EVM wallet or contract address (0x…)
?chain	string	no	—	EVM chain slug: ethereum, base, arbitrum, optimism, polygon, bsc…

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/rug-check?address=0x940181a94A35A4569E4529A3CDfB74e38FD98631&chain=base"

🔒 Security & Domain Intel 13 endpoints

Evaluate any website or endpoint: certificates, headers, DNS, WHOIS, tech stack, page speed and trust scoring bundled into single audits.

GET /v1/ssl-check $0.005 Try it →

SSL/TLS certificate check for any domain: issuer, expiry date, days remaining, expiry alerts

Parameters

Name	Type	Required	Default	Description
?domain	string	no	—	Domain name to inspect, e.g. example.com

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/ssl-check?domain=github.com"

GET /v1/dns $0.005 Try it →

Full DNS records for any domain: A, AAAA, MX, TXT (SPF/DKIM), NS, CNAME — one call

Parameters

Name	Type	Required	Default	Description
?domain	string	no	—	Domain name to inspect, e.g. example.com

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/dns?domain=github.com"

GET /v1/whois $0.005 Try it →

Domain WHOIS lookup: registrar, creation date, expiration, age, name servers — one call

Parameters

Name	Type	Required	Default	Description
?domain	string	no	—	Domain name to inspect, e.g. example.com

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/whois?domain=github.com"

GET /v1/http-check $0.005 Try it →

Full URL health check: HTTP status + response headers + response time + SSL certificate — one call

Parameters

Name	Type	Required	Default	Description
?url	string	no	—	Target public URL (SSRF-guarded: private IPs and non-HTTP schemes are rejected)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/http-check?url=https://example.com"

GET /v1/security-headers $0.01 Try it →

Security header audit (A-F grade): HSTS, CSP, XSS, frame options, referrer policy — one call

Parameters

Name	Type	Required	Default	Description
?url	string	no	—	Target public URL (SSRF-guarded: private IPs and non-HTTP schemes are rejected)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/security-headers?url=https://example.com"

GET /v1/verify-url $0.01 Try it →

URL legitimacy check: SSL + domain heuristics + response time + risk score with verdict

Parameters

Name	Type	Required	Default	Description
?url	string	no	—	Target public URL (SSRF-guarded: private IPs and non-HTTP schemes are rejected)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/verify-url?url=https://example.com"

GET /v1/tech-stack $0.05 Try it →

Detect technology stack from any URL: CMS, frameworks, analytics, hosting, ecommerce, fonts — what Wappalyzer charges $$$ for

Parameters

Name	Type	Required	Default	Description
?url	string	no	—	Target public URL (SSRF-guarded: private IPs and non-HTTP schemes are rejected)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/tech-stack?url=https://example.com"

GET /v1/page-speed $0.02 Try it →

Measure page performance: TTFB, load time, HTML size, resource count, optimization checks, A-F grade

Parameters

Name	Type	Required	Default	Description
?url	string	no	—	Target public URL (SSRF-guarded: private IPs and non-HTTP schemes are rejected)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/page-speed?url=https://example.com"

GET /v1/ssl-certificate $0.02 Try it →

Detailed SSL certificate analysis: subject, issuer, SANs, key info, fingerprint, expiry timeline, chain validation

Parameters

Name	Type	Required	Default	Description
?domain	string	no	—	Domain name to inspect, e.g. example.com

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/ssl-certificate?domain=github.com"

GET /v1/site-audit $0.08 Try it →

THE all-in-one site audit: SSL + security headers + DNS + WHOIS + performance + meta tags + tech stack + robots — one call, A-F grade

Parameters

Name	Type	Required	Default	Description
?url	string	no	—	Target public URL (SSRF-guarded: private IPs and non-HTTP schemes are rejected)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/site-audit?url=https://example.com"

GET /v1/domain-intel $0.05 Try it →

Everything about a domain: DNS + WHOIS + SSL + security headers + robots + trust score

Parameters

Name	Type	Required	Default	Description
?domain	string	no	—	Domain name to inspect, e.g. example.com

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/domain-intel?domain=github.com"

GET /v1/api-health $0.03 Try it →

Complete API health: endpoint test + security headers + performance — HEALTHY/DEGRADED/UNHEALTHY

Parameters

Name	Type	Required	Default	Description
?url	string	no	—	Target public URL (SSRF-guarded: private IPs and non-HTTP schemes are rejected)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/api-health?url=https://example.com"

GET /v1/kev $0.01 Try it →

CISA Known Exploited Vulnerabilities catalog (1,700+ actively exploited CVEs, refreshed every 6h): filter by vendor or product, with dates, due dates and ransomware-use flags

Parameters

Name	Type	Required	Default	Description
?limit	number	no	25	Maximum number of results to return
?q	string	no	—	Search query or free-text question

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/kev?q=cisco"

🛠️ Developer Tools 45 endpoints

The utilities every coding agent reaches for daily: hashing, encoding, JWT, cron, validation, format conversion and package health checks.

GET /v1/shorturl $0.005 Try it →

Expand any short URL through its redirect chain to the final destination — one call

Parameters

Name	Type	Required	Default	Description
?url	string	no	—	Target public URL (SSRF-guarded: private IPs and non-HTTP schemes are rejected)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/shorturl?url=https://example.com"

GET /v1/qr $0.005 Try it →

Generate a QR code as base64 PNG for any text or URL — instant, no external service

Parameters

Name	Type	Required	Default	Description
?text	string	yes	—	Input text to process
?data	string	no		Raw input for the operation: 0x-hex calldata (decode/simulate) or JSON payload (transform endpoints)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/qr?text=hello+world&data=%7B%22a%22%3A%7B%22b%22%3A%5B1%2C2%2C3%5D%7D%7D"

GET /v1/package-check $0.005 Try it →

npm package health + vulnerability scan (OSV.dev) in one call: version, downloads, CVEs, verdict

Parameters

Name	Type	Required	Default	Description
?package	string	no	—	npm package name

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/package-check?package=express"

POST /v1/validate-json $0.005 Try it →

JSON schema validation with detailed error paths — deterministic utility for agents

Parameters

No parameters — call it directly.

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i -X POST "https://api.carredge.com/v1/validate-json" \
  -H 'Content-Type: application/json' \
  -d '{...}'

GET /v1/hash $0.001 Try it →

Multi-hash: SHA-256, SHA-1, MD5, SHA-512, Base64 and Hex for any text — one call, instant

Parameters

Name	Type	Required	Default	Description
?text	string	no	—	Input text to process

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/hash?text=hello+world"

GET /v1/base64 $0.001 Try it →

Base64 encode or decode with automatic JSON detection — one call

Parameters

Name	Type	Required	Default	Description
?data	string	no	—	Raw input for the operation: 0x-hex calldata (decode/simulate) or JSON payload (transform endpoints)
?mode	string	no	—

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/base64?data=%7B%22a%22%3A%7B%22b%22%3A%5B1%2C2%2C3%5D%7D%7D"

GET /v1/decode-jwt $0.005 Try it →

Decode JWT header+payload without verification: claims, expiry, warnings — one call

Parameters

Name	Type	Required	Default	Description
?token	string	no	—

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/decode-jwt?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"

GET /v1/cron $0.005 Try it →

Parse cron expression and get the next N execution times with human description

Parameters

Name	Type	Required	Default	Description
?expression	string	no	—
?runs	string	no	—

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/cron?expression=*/5+*+*+*+*"

GET /v1/csv2json $0.005 Try it →

Convert CSV text to JSON array with auto type detection — one call

Parameters

Name	Type	Required	Default	Description
?csv	string	no	—
?delimiter	string	no	—

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/csv2json?csv=name,age%0AAlice,30"

GET /v1/timestamp $0.001 Try it →

Unix timestamp converter: seconds/ms/ISO/relative time, with date arithmetic

Parameters

No parameters — call it directly.

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/timestamp"

GET /v1/uuid $0.001 Try it →

Generate up to 100 cryptographically random UUID v4s — instant

Parameters

Name	Type	Required	Default	Description
?count	string	no	—	Number of items to generate

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/uuid"

GET /v1/crypto-units $0.001 Try it →

Convert between wei/gwei/eth and sat/btc — every Web3 agent needs this

Parameters

No parameters — call it directly.

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/crypto-units?value=1&from=eth"

GET /v1/email-check $0.005 Try it →

Email validation: syntax + MX record + disposable detection with verdict

Parameters

Name	Type	Required	Default	Description
?email	string	no	—	Email address to validate or score

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/email-check?email=test@gmail.com"

GET /v1/random $0.001 Try it →

Random generator: passwords, strings, numbers, hex, colors — cryptographically secure, up to 50 per call

Parameters

No parameters — call it directly.

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/random"

GET /v1/convert $0.001 Try it →

Universal unit converter: length, weight, temperature, data, speed, area, volume — any unit to any unit

Parameters

No parameters — call it directly.

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/convert?value=10&from=km&to=mi"

GET /v1/regex $0.001 Try it →

Test regex pattern against text: matches with groups, indices, and named capture groups

Parameters

No parameters — call it directly.

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/regex?pattern=%5Ba-z%5D%2B&text=hello+world"

GET /v1/diff $0.001 Try it →

Compare two texts line-by-line: additions, removals, identical check

Parameters

No parameters — call it directly.

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/diff?text1=hello&text2=world"

GET /v1/slugify $0.001 Try it →

Convert any text to a URL-safe slug: accents removed, special chars stripped, consistent separators

Parameters

No parameters — call it directly.

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/slugify?text=Hello+World"

GET /v1/color $0.001 Try it →

Color converter: hex ↔ RGB ↔ HSL with name, luminance, contrast ratios, dark/light detection

Parameters

Name	Type	Required	Default	Description
?color	string	no	—

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/color?color=%23ff5500&format=rgb"

GET /v1/lorem $0.001 Try it →

Lorem ipsum generator: paragraphs, sentences, or words — placeholder text for devs

Parameters

Name	Type	Required	Default	Description
?count	string	no	—	Number of items to generate
?type	string	no	—	Sub-type selector for the dataset

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/lorem?type=funding"

GET /v1/roman $0.001 Try it →

Roman numeral converter: number ↔ Roman (both directions, 1-3999)

Parameters

Name	Type	Required	Default	Description
?value	string	no	—	ETH value attached to the transaction, in wei (decimal or 0x-hex; default 0)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/roman?value=100"

GET /v1/morse $0.001 Try it →

Morse code encoder/decoder with auto-detection

Parameters

Name	Type	Required	Default	Description
?mode	string	no	—
?text	string	no	—	Input text to process

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/morse?text=hello+world"

GET /v1/json-path $0.005 Try it →

Query JSON with dot notation paths: extract nested values, array indexing — like simplified jq

Parameters

Name	Type	Required	Default	Description
?data	string	no	—	Raw input for the operation: 0x-hex calldata (decode/simulate) or JSON payload (transform endpoints)
?path	string	no	—	Dot-notation JSON path, e.g. user.addresses[0].city

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/json-path?data=%7B%22a%22%3A%7B%22b%22%3A%5B1%2C2%2C3%5D%7D%7D&path=a.b%5B1%5D"

GET /v1/schema-gen $0.005 Try it →

Generate JSON schema from sample data — automatically infer types, arrays, required fields

Parameters

Name	Type	Required	Default	Description
?data	string	no	—	Raw input for the operation: 0x-hex calldata (decode/simulate) or JSON payload (transform endpoints)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/schema-gen?data=%7B%22a%22%3A%7B%22b%22%3A%5B1%2C2%2C3%5D%7D%7D"

GET /v1/api-test $0.01 Try it →

Test any API endpoint: status code, response time, headers, body preview, JSON detection

Parameters

No parameters — call it directly.

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/api-test?url=https://api.github.com"

GET /v1/compare $0.005 Try it →

Compare two texts for similarity: Jaccard, Dice coefficient, shared words, similarity verdict

Parameters

Name	Type	Required	Default	Description
?text1	string	no	—
?text2	string	no	—

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/compare?text1=hello&text2=world"

GET /v1/markdown $0.005 Try it →

Convert Markdown to HTML (GFM support)

Parameters

Name	Type	Required	Default	Description
?markdown	string	no	—

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/markdown?markdown=%23+Title%0A%0AHello+**world**"

GET /v1/ics $0.01 Try it →

Parse iCal calendar files: events, dates, locations

Parameters

Name	Type	Required	Default	Description
?ics	string	no	—
?url	string	no	—	Target public URL (SSRF-guarded: private IPs and non-HTTP schemes are rejected)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/ics?url=https://example.com"

GET /v1/emoji $0.001 Try it →

Emoji lookup by name or keyword

Parameters

Name	Type	Required	Default	Description
?q	string	no	—	Search query or free-text question

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/emoji?q=us+elections"

GET /v1/validate-code $0.005 Try it →

Syntax validation for JSON, YAML, XML, SQL, regex, URL, email — with errors and warnings

Parameters

Name	Type	Required	Default	Description
?code	string	no	—	Required code/input for this endpoint (postal code, source code, key…)
?language	string	no	—	Language or format: json, yaml, xml, sql, regex, url, email…

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/validate-code?code=%7B%22a%22%3A1%7D&language=json"

GET /v1/event-logs $0.01 Try it →

Decoded-ready event logs for any contract on any supported EVM chain (eth_getLogs): topic filter, block range with adaptive window, clean JSON — the raw feed agents poll

Parameters

Name	Type	Required	Default	Description
?address	string	no	—	EVM wallet or contract address (0x…)
?chain	string	no	—	EVM chain slug: ethereum, base, arbitrum, optimism, polygon, bsc…
?fromBlock	string	no	—
?limit	string	no	—	Maximum number of results to return
?toBlock	string	no	—
?topic0	string	no	—

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/event-logs?address=0x4200000000000000000000000000000000000006&chain=base&topic0=0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"

GET /v1/gas-history $0.005 Try it →

Multi-chain gas history (eth_feeHistory): base fee per block in gwei for the last N blocks, priority-fee percentiles and gas-used ratio — fee trends and L2 spike detection without keys

Parameters

Name	Type	Required	Default	Description
?blocks	string	no	—	Number of recent blocks to sample (max 100 for gas-history)
?chain	string	no	—	EVM chain slug: ethereum, base, arbitrum, optimism, polygon, bsc…
?percentiles	string	no	—	Comma-separated priority-fee percentiles to report, e.g. 25,50,75

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/gas-history?blocks=20&chain=base"

GET /v1/abi $0.005 Try it →

Verified contract ABI (Sourcify → Blockscout) with selector and topic0 index computed locally: every function and event, ready to encode/decode calls

Parameters

Name	Type	Required	Default	Description
?address	string	no	—	EVM wallet or contract address (0x…)
?chain	string	no	—	EVM chain slug: ethereum, base, arbitrum, optimism, polygon, bsc…

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/abi?address=0x4200000000000000000000000000000000000006&chain=base"

GET /v1/selector $0.001 Try it →

Function/event signature ↔ selector lookup both ways: signature to selector (local keccak256) or hex to candidate signatures (OpenChain + 4byte)

Parameters

Name	Type	Required	Default	Description
?hex	string	no	—
?signature	string	no	—	eth_signTypedData_v4 output: 0x + 130 hex chars

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/selector?signature=transfer(address,uint256)"

GET /v1/repo-health $0.01 Try it →

GitHub repo health in one call: stars, issues, last release, activity verdict (ACTIVE/STALE/ARCHIVED)

Parameters

Name	Type	Required	Default	Description
?repo	string	no	—

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/repo-health?repo=ethereum/EIPs"

GET /v1/npm-stats $0.005 Try it →

npm package downloads (day/week/month/year) + latest version and description — adoption intelligence for any library

Parameters

Name	Type	Required	Default	Description
?package	string	yes	—	npm package name
?period	string	no	last-week	Download window: last-day, last-week, last-month, last-year

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/npm-stats?package=express&period=last-week"

GET /v1/json-xml $0.005 Try it →

Convert JSON to XML — arrays, nested objects and attributes handled with proper escaping

Parameters

Name	Type	Required	Default	Description
?data	string	yes	—	Raw input for the operation: 0x-hex calldata (decode/simulate) or JSON payload (transform endpoints)
?root	string	no	root

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/json-xml?data=%7B%22a%22%3A%7B%22b%22%3A%5B1%2C2%2C3%5D%7D%7D"

GET /v1/xml2json $0.005 Try it →

Convert XML to JSON in one call — attributes preserved with @_ prefix. RSS feeds, sitemaps, SOAP responses, API XML

Parameters

Name	Type	Required	Default	Description
?xml	string	yes	—

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/xml2json?xml=%3Croot%3E%3Citem%3Ehello%3C%2Fitem%3E%3C%2Froot%3E"

GET /v1/json2csv $0.005 Try it →

Convert a JSON array of objects to CSV — auto-detects columns, proper quoting and escaping. Spreadsheets-ready

Parameters

Name	Type	Required	Default	Description
?data	string	yes	—	Raw input for the operation: 0x-hex calldata (decode/simulate) or JSON payload (transform endpoints)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/json2csv?data=%7B%22a%22%3A%7B%22b%22%3A%5B1%2C2%2C3%5D%7D%7D"

GET /v1/json2yaml $0.005 Try it →

Convert JSON to clean YAML — configs, Kubernetes manifests, CI pipelines from JSON sources

Parameters

Name	Type	Required	Default	Description
?data	string	yes	—	Raw input for the operation: 0x-hex calldata (decode/simulate) or JSON payload (transform endpoints)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/json2yaml?data=%7B%22a%22%3A%7B%22b%22%3A%5B1%2C2%2C3%5D%7D%7D"

GET /v1/yaml2json $0.005 Try it →

Convert YAML to JSON — parse any YAML config into structured JSON for programmatic use

Parameters

Name	Type	Required	Default	Description
?data	string	yes	—	Raw input for the operation: 0x-hex calldata (decode/simulate) or JSON payload (transform endpoints)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/yaml2json?data=%7B%22a%22%3A%7B%22b%22%3A%5B1%2C2%2C3%5D%7D%7D"

GET /v1/md-text $0.005 Try it →

Markdown to clean plain text — strips all formatting, links and HTML, preserves line structure. Perfect for LLM input

Parameters

Name	Type	Required	Default	Description
?text	string	yes	—	Input text to process

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/md-text?text=hello+world"

GET /v1/iban $0.001 Try it →

IBAN validation per ISO 13616 (mod-97 checksum + per-country length). Fully local — the number never leaves the server

Parameters

Name	Type	Required	Default	Description
?iban	string	yes	—	IBAN to validate (spaces allowed)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/iban?iban=DE89370400440532013000"

GET /v1/luhn $0.001 Try it →

Card number validation: Luhn checksum (ISO/IEC 7812) + brand detection + length rules. Returns masked number only — for validation, never charges

Parameters

Name	Type	Required	Default	Description
?number	string	yes	—	Numeric input

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/luhn?number=4111111111111111"

GET /v1/fake-user $0.005 Try it →

Synthetic user profiles for testing and demos: name, email, phone, address and avatar — clearly fake, safe to use

Parameters

Name	Type	Required	Default	Description
?nat	string	no	—	Nationality for synthetic data: us, gb, es, de, fr, it, br, mx, au, ca…

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/fake-user?nat=us"

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/loan?principal=200000&annualRate=3.5&years=30"

GET /v1/health-calc $0.001 Try it →

Body calculator: BMI + category + healthy range, Mifflin-St Jeor BMR, TDEE for all activity levels and ideal weight. Computed locally

Parameters

Name	Type	Required	Default	Description
?activity	string	no	moderate	Specific ChEMBL activity id, e.g. CHEMBL1137723 (optional)
?age	string	no	—	Age in years
?height	string	no	—	Height in centimeters
?sex	string	no	—	male or female
?weight	string	no	—	Weight in kilograms

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/health-calc?activity=moderate&age=30&height=178&sex=male&weight=75"

📚 Content & Research 34 endpoints

Read and reason over the web: clean extraction, metadata, summaries, sentiment, fact verification and cross-source consensus.

GET /v1/extract $0.01 Try it →

Clean Markdown extraction from any public URL, plus title, description and metadata

Parameters

Name	Type	Required	Default	Description
?url	string	yes		Target public URL (SSRF-guarded: private IPs and non-HTTP schemes are rejected)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/extract?url=https://example.com"

GET /v1/meta-tags $0.005 Try it →

Extract OpenGraph, Twitter Card and SEO meta tags from any URL — social preview in one call

Parameters

Name	Type	Required	Default	Description
?url	string	no	—	Target public URL (SSRF-guarded: private IPs and non-HTTP schemes are rejected)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/meta-tags?url=https://example.com"

GET /v1/url-info $0.01 Try it →

Complete URL analysis: structure, meta tags, SSL, response info — everything in one call

Parameters

Name	Type	Required	Default	Description
?url	string	no	—	Target public URL (SSRF-guarded: private IPs and non-HTTP schemes are rejected)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/url-info?url=https://example.com"

GET /v1/sentiment $0.005 Try it →

Text sentiment analysis: score, label, matched words — no AI API needed, instant

Parameters

Name	Type	Required	Default	Description
?text	string	no	—	Input text to process

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/sentiment?text=hello+world"

GET /v1/summarize $0.005 Try it →

Extractive text summarization: top sentences by relevance, compression ratio

Parameters

Name	Type	Required	Default	Description
?sentences	string	no	—
?text	string	no	—	Input text to process

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/summarize?text=hello+world"

GET /v1/robots $0.005 Try it →

Parse robots.txt for any domain: sitemaps, user-agent rules, allow/disallow paths

Parameters

Name	Type	Required	Default	Description
?domain	string	no	—	Domain name to inspect, e.g. example.com

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/robots?domain=github.com"

GET /v1/wikipedia $0.005 Try it →

Wikipedia article summary for any topic: title, description, extract, thumbnail, coordinates

Parameters

Name	Type	Required	Default	Description
?lang	string	no	—
?topic	string	no	—	Topic to look up, e.g. quantum-computing

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/wikipedia?topic=blockchain"

GET /v1/dictionary $0.005 Try it →

Word definitions with phonetics, synonyms, examples and audio pronunciation

Parameters

Name	Type	Required	Default	Description
?word	string	no	—	Single word to look up

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/dictionary?word=serendipity"

GET /v1/search $0.01 Try it →

Web search results (DuckDuckGo): titles, URLs, snippets — what agents need for research

Parameters

Name	Type	Required	Default	Description
?limit	string	no	—	Maximum number of results to return
?q	string	no	—	Search query or free-text question

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/search?q=us+elections"

GET /v1/tables $0.01 Try it →

Extract HTML tables from any URL as structured JSON with headers and rows

Parameters

Name	Type	Required	Default	Description
?url	string	no	—	Target public URL (SSRF-guarded: private IPs and non-HTTP schemes are rejected)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/tables?url=https://example.com"

GET /v1/links $0.01 Try it →

Batch URL health checker: status codes, response times, broken link detection (up to 20)

Parameters

Name	Type	Required	Default	Description
?urls	string	no	—

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/links?urls=https://example.com,https://github.com"

GET /v1/text-stats $0.005 Try it →

Text analysis: word count, readability (Flesch), reading time, lexical diversity, grade level

Parameters

Name	Type	Required	Default	Description
?text	string	no	—	Input text to process

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/text-stats?text=hello+world"

GET /v1/pdf-text $0.02 Try it →

Extract text from PDF URL: papers, reports, invoices

Parameters

Name	Type	Required	Default	Description
?url	string	no	—	Target public URL (SSRF-guarded: private IPs and non-HTTP schemes are rejected)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/pdf-text?url=https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf"

GET /v1/rss $0.01 Try it →

Parse any RSS/Atom feed into clean JSON

Parameters

Name	Type	Required	Default	Description
?url	string	no	—	Target public URL (SSRF-guarded: private IPs and non-HTTP schemes are rejected)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/rss?url=https://example.com"

GET /v1/verify-fact $0.02 Try it →

Cross-reference a claim against Wikipedia, news, and web — verdict: SUPPORTED / PARTIAL / UNVERIFIED

Parameters

Name	Type	Required	Default	Description
?claim	string	no	—

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/verify-fact?claim=the earth is round"

GET /v1/consensus $0.02 Try it →

Check multiple data sources for agreement on a topic — consensus strength assessment

Parameters

Name	Type	Required	Default	Description
?sources	string	no	—
?topic	string	no	—	Topic to look up, e.g. quantum-computing

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/consensus?topic=blockchain"

GET /v1/content-analyze $0.03 Try it →

Full content breakdown: sentiment + summary + readability + word stats — replaces 3 calls

Parameters

Name	Type	Required	Default	Description
?text	string	no	—	Input text to process

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/content-analyze?text=hello+world"

GET /v1/on-this-day $0.01 Try it →

What happened on this day in history: curated events, births, deaths and holidays from Wikipedia — defaults to today

Parameters

Name	Type	Required	Default	Description
?day	string	no	—	Day of month 1-31 (defaults to today)
?month	string	no	—	Month number 1-12 (defaults to today)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/on-this-day?day=4&month=10"

GET /v1/games $0.005 Try it →

Steam store search: name, publisher, price/discount, Metacritic score and store URL

Parameters

Name	Type	Required	Default	Description
?q	string	yes	—	Search query or free-text question
?limit	number	no	8	Maximum number of results to return

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/games?q=us+elections"

GET /v1/news-web $0.005 Try it →

Web news search (Google News): headlines and links for any topic — pair with /v1/extract for full articles

Parameters

Name	Type	Required	Default	Description
?q	string	yes	—	Search query or free-text question
?limit	number	no	10	Maximum number of results to return

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/news-web?q=us+elections"

GET /v1/html-md $0.01 Try it →

Any public URL to clean Markdown — headings, links, images, code blocks, lists and tables converted (SSRF-guarded)

Parameters

Name	Type	Required	Default	Description
?url	string	yes	—	Target public URL (SSRF-guarded: private IPs and non-HTTP schemes are rejected)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/html-md?url=https://example.com"

GET /v1/ipos $0.01 Try it →

IPO calendar from Nasdaq: priced, upcoming, filed and withdrawn deals with price ranges and valuations, by month

Parameters

Name	Type	Required	Default	Description
?month	string	no	—	Month number 1-12 (defaults to today)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/ipos?month=10"

GET /v1/ocr $0.02 Try it →

OCR any image URL to text — runs locally with Tesseract (no external API, nothing leaves the server). Returns text, confidence and word count

Parameters

Name	Type	Required	Default	Description
?url	string	yes		Target public URL (SSRF-guarded: private IPs and non-HTTP schemes are rejected)
?lang	string	no	eng

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/ocr?url=https://tesseract.projectnaptha.com/img/eng_bw.png"

GET /v1/yt-info $0.005 Try it →

YouTube video metadata: title, channel, thumbnail and embed URL from any video link or ID

Parameters

Name	Type	Required	Default	Description
?url	string	yes	—	Target public URL (SSRF-guarded: private IPs and non-HTTP schemes are rejected)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/yt-info?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ"

GET /v1/hn $0.01 Try it →

Hacker News search: stories, comments and authors with points and discussion counts — tech trend intelligence

Parameters

Name	Type	Required	Default	Description
?q	string	yes	—	Search query or free-text question
?limit	number	no	15	Maximum number of results to return
?tags	string	no	story	Filter for HN search: story (default), comment, story_author, comment_author

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/hn?q=us+elections&tags=story"

GET /v1/arxiv $0.01 Try it →

arXiv paper search: title, authors, abstract, categories and PDF links — the frontier of research, structured

Parameters

Name	Type	Required	Default	Description
?q	string	yes	—	Search query or free-text question
?limit	number	no	10	Maximum number of results to return

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/arxiv?q=us+elections"

GET /v1/papers $0.01 Try it →

Academic papers via Crossref: search by keywords or resolve any DOI to full citation metadata with citation counts

Parameters

Name	Type	Required	Default	Description
?q	string	yes	—	Search query or free-text question
?doi	string	no	—	Digital Object Identifier, e.g. 10.1038/nature12373
?limit	number	no	10	Maximum number of results to return

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/papers?q=us+elections&doi=10.1038/nature12373"

GET /v1/stackoverflow $0.01 Try it →

Stack Overflow question search: score, answers, tags and links — programming solutions ranked by relevance

Parameters

Name	Type	Required	Default	Description
?q	string	yes	—	Search query or free-text question
?limit	number	no	10	Maximum number of results to return

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/stackoverflow?q=us+elections"

GET /v1/patents $0.01 Try it →

Worldwide patent search (Google Patents, keyless): title, publication number, inventor, assignee and filing/grant dates — PatentsView was retired in 2026, this covers US/EP/WO/JP/CN publications

Parameters

Name	Type	Required	Default	Description
?q	string	yes	—	Search query or free-text question
?limit	number	no	10	Maximum number of results to return

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/patents?q=blockchain"

GET /v1/wikidata $0.005 Try it →

Wikidata entity search by free text: entity id (Q…), label, short description, aliases and concept URI for people, places, companies, concepts — the structured backbone of Wikipedia, keyless

Parameters

Name	Type	Required	Default	Description
?q	string	yes	—	Search query or free-text question
?limit	number	no	8	Maximum number of results to return

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/wikidata?q=Nikola+Tesla"

GET /v1/nih-reporter $0.01 Try it →

NIH-funded research projects by keyword from RePORTER v2: project number, organization, principal investigator, award amount and dates — who gets the biomedical money, keyless

Parameters

Name	Type	Required	Default	Description
?q	string	yes	—	Search query or free-text question
?limit	number	no	10	Maximum number of results to return

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/nih-reporter?q=CRISPR"

GET /v1/ror $0.005 Try it →

Research organizations by name from the Research Organization Registry (ROR): type, country, city, founding year and website for universities, institutes and labs — keyless

Parameters

Name	Type	Required	Default	Description
?q	string	yes	—	Search query or free-text question
?limit	number	no	10	Maximum number of results to return

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/ror?q=MIT"

GET /v1/orcid $0.005 Try it →

Researchers by name in ORCID (public records only): ORCID iD, name variants and institution history — the standard researcher identifier, keyless

Parameters

Name	Type	Required	Default	Description
?q	string	yes	—	Search query or free-text question
?limit	number	no	8	Maximum number of results to return

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/orcid?q=John+Smith"

GET /v1/doaj $0.005 Try it →

Open-access journal articles from DOAJ by keyword: title, journal, year, DOI, full-text link, abstract snippet and keywords — fully legal OA papers, keyless

Parameters

Name	Type	Required	Default	Description
?q	string	yes	—	Search query or free-text question
?limit	number	no	10	Maximum number of results to return

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/doaj?q=machine+learning"

🌍 World Data 54 endpoints

Structured real-world data: weather, earthquakes, holidays, geocoding, sports scores, TV, music, clinical trials, FDA recalls and more.

GET /v1/holidays $0.005 Try it →

Public holidays for any country and year (official data) — perfect for scheduling agents

Parameters

Name	Type	Required	Default	Description
?country	string	no	—	ISO country code, e.g. US, DE, ES
?year	string	no	—	Year in YYYY format

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/holidays?country=DE&year=2026"

GET /v1/ip-info $0.005 Try it →

IP geolocation with ISP, hosting/proxy detection and risk flags

Parameters

Name	Type	Required	Default	Description
?ip	string	no	—

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/ip-info?ip=8.8.8.8"

GET /v1/barcode $0.01 Try it →

UPC/EAN barcode to product name, brand, nutrition, ingredients, allergens (Open Food Facts)

Parameters

Name	Type	Required	Default	Description
?code	string	no	—	Required code/input for this endpoint (postal code, source code, key…)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/barcode?code=5901234123457"

GET /v1/isbn $0.005 Try it →

ISBN to book title, authors, publisher, cover, subjects (Open Library)

Parameters

Name	Type	Required	Default	Description
?isbn	string	no	—	Book ISBN (10 or 13 digits)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/isbn?isbn=9780134685991"

GET /v1/tv $0.005 Try it →

TV show info: rating, seasons, episodes, network, status, summary (TVMaze)

Parameters

Name	Type	Required	Default	Description
?q	string	no	—	Search query or free-text question

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/tv?q=us+elections"

GET /v1/music $0.005 Try it →

Music artist lookup: genre tags, country, active years (MusicBrainz)

Parameters

Name	Type	Required	Default	Description
?artist	string	no	—	Artist name for music lookup

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/music?artist=daft+punk"

GET /v1/sports $0.01 Try it →

Live sports scores: NBA, NFL, MLB, NHL, soccer, UFC (ESPN)

Parameters

Name	Type	Required	Default	Description
?league	string	no	—	Sports league: nba, nfl, mlb, nhl, soccer or ufc

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/sports?league=nba"

GET /v1/geocode $0.005 Try it →

Forward/reverse geocoding: address to coords or coords to address (OpenStreetMap)

Parameters

Name	Type	Required	Default	Description
?lat	string	no	—	Latitude in decimal degrees
?lon	string	no	—	Longitude in decimal degrees
?q	string	no	—	Search query or free-text question

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/geocode?lat=41.3874&lon=2.1686&q=Barcelona"

GET /v1/earthquakes $0.01 Try it →

Real-time earthquake data from USGS: magnitude, location, depth, tsunami alert, significance

Parameters

Name	Type	Required	Default	Description
?limit	string	no	—	Maximum number of results to return
?minMagnitude	string	no	—

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/earthquakes"

GET /v1/weather-history $0.01 Try it →

Historical weather for any location and date range: temp, precipitation, wind (Open Meteo archive)

Parameters

No parameters — call it directly.

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/weather-history?lat=41.3874&lon=2.1686&start=2026-01-01&end=2026-01-31"

GET /v1/trials $0.01 Try it →

Search clinical trials by condition: phase, status, enrollment, sponsor (ClinicalTrials.gov)

Parameters

Name	Type	Required	Default	Description
?condition	string	no	—
?limit	string	no	—	Maximum number of results to return
?phase	string	no	—
?status	string	no	—

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/trials?condition=diabetes"

GET /v1/fda-recalls $0.05 Try it →

Search FDA safety recalls: device, drug, food. Class I/II/III severity, recalling firm, distribution — life safety data

Parameters

Name	Type	Required	Default	Description
?limit	string	no	—	Maximum number of results to return
?q	string	no	—	Search query or free-text question
?type	string	no	—	Sub-type selector for the dataset

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/fda-recalls?q=us+elections&type=drug&query=ibuprofen"

GET /v1/drug-events $0.05 Try it →

Search FDA adverse drug reactions: 20M+ reports. Filter by drug name or symptom — pharmacovigilance data

Parameters

Name	Type	Required	Default	Description
?drug	string	no	—
?limit	string	no	—	Maximum number of results to return
?symptom	string	no	—

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/drug-events"

GET /v1/weather $0.005 Try it →

Weather for any city in one call: current + 3-day forecast (Open-Meteo)

Parameters

Name	Type	Required	Default	Description
?q	string	no	—	Search query or free-text question

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/weather?q=Madrid"

GET /v1/timezone $0.001 Try it →

Current local time, UTC offset and DST status for any IANA timezone — plus instant conversion of any timestamp. Computed locally, zero latency

Parameters

Name	Type	Required	Default	Description
?zone	string	yes	—	IANA timezone, e.g. Europe/Madrid or America/New_York
?iso	string	no	—

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/timezone?zone=Europe/Madrid"

GET /v1/timezones $0.001 Try it →

All IANA timezones grouped by area (America, Europe, Asia…) — filterable. Computed locally

Parameters

Name	Type	Required	Default	Description
?area	string	no	—	Timezone area prefix: America, Europe, Asia, Africa, Australia, Pacific…

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/timezones?area=Europe"

GET /v1/moon $0.001 Try it →

Moon phase for any date: name, illumination %, moon age, days to next full/new moon. Computed locally

Parameters

Name	Type	Required	Default	Description
?date	string	no	—	Date in YYYYMMDD format (BOE summary)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/moon?date=2026-01-15"

GET /v1/sun $0.005 Try it →

Sunrise, sunset, daylight hours and max UV index for today — any city or coordinates

Parameters

Name	Type	Required	Default	Description
?city	string	no	—	City name, e.g. Barcelona
?lat	string	no	—	Latitude in decimal degrees
?lon	string	no	—	Longitude in decimal degrees

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/sun?city=Barcelona&lat=41.3874&lon=2.1686"

GET /v1/marine $0.005 Try it →

Sea conditions for coastal coordinates: wave height/direction/period, swell, sea temperature and 3-day forecast

Parameters

Name	Type	Required	Default	Description
?lat	string	yes	—	Latitude in decimal degrees
?lon	string	no	—	Longitude in decimal degrees

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/marine?lat=41.35&lon=2.20"

GET /v1/universities $0.01 Try it →

Universities for any country with their official domains — lead generation and verification agents: every domain is a real academic institution

Parameters

Name	Type	Required	Default	Description
?country	string	yes	—	ISO country code, e.g. US, DE, ES
?limit	number	no	25	Maximum number of results to return

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/universities?country=DE"

GET /v1/cities $0.01 Try it →

Cities of any country ranked by population with census year — clean structured geodata

Parameters

Name	Type	Required	Default	Description
?country	string	yes	—	ISO country code, e.g. US, DE, ES
?limit	number	no	25	Maximum number of results to return

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/cities?country=Spain"

GET /v1/currencies $0.005 Try it →

All 161 world currencies (ISO code, name, symbol) or lookup a single code. Computed locally from embedded data

Parameters

Name	Type	Required	Default	Description
?code	string	no	—	Required code/input for this endpoint (postal code, source code, key…)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/currencies?code=USD"

GET /v1/dial-code $0.005 Try it →

Country calling codes: country → dial codes, or reverse lookup +34 → countries. Computed locally

Parameters

Name	Type	Required	Default	Description
?country	string	yes	—	ISO country code, e.g. US, DE, ES
?code	string	no	—	Required code/input for this endpoint (postal code, source code, key…)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/dial-code?country=DE&code=+34"

GET /v1/name-stats $0.01 Try it →

Demographic intelligence for any first name: most likely countries with probabilities, estimated age and gender — 3 open datasets in one call

Parameters

Name	Type	Required	Default	Description
?name	string	yes	—	Name to look up: a medication (rxnorm/rxterms), person (sanctions, orcid) or company

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/name-stats?name=Alice"

GET /v1/eurostat $0.01 Try it →

European Union official statistics: GDP, inflation, unemployment, population and debt-to-GDP per country — Eurostat open data

Parameters

Name	Type	Required	Default	Description
?country	string	no	—	ISO country code, e.g. US, DE, ES
?indicator	string	no	gdp	World Bank indicator: population, gdp, gdp-per-capita, inflation, unemployment, life-expectancy, co2-emissions…
?limit	number	no	15	Maximum number of results to return

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/eurostat?country=DE&indicator=population"

GET /v1/carbon $0.005 Try it →

CO2 emissions for any country: per-capita tonnes, total Mt, year and share of global emissions — computed locally from embedded Our World in Data snapshot

Parameters

Name	Type	Required	Default	Description
?country	string	yes	—	ISO country code, e.g. US, DE, ES

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/carbon?country=DE"

GET /v1/airports $0.005 Try it →

Airport database: 6,064 airports worldwide — lookup by IATA/ICAO code, city or name, or list by country. Computed locally from embedded OpenFlights snapshot

Parameters

Name	Type	Required	Default	Description
?q	string	yes	—	Search query or free-text question
?country	string	no	—	ISO country code, e.g. US, DE, ES
?limit	number	no	10	Maximum number of results to return

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/airports?q=Madrid&country=DE"

GET /v1/weather-history-city $0.01 Try it →

Historical weather by city name: daily temperature, precipitation and wind for any date range (Open-Meteo archive) — geocoding included

Parameters

Name	Type	Required	Default	Description
?city	string	yes	—	City name, e.g. Barcelona
?end	string	no	—	Range end (date, timestamp or price)
?start	string	no	—	Range start (date, timestamp or price)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/weather-history-city?city=Barcelona&end=2026-01-31&start=2026-01-01"

GET /v1/country $0.005 Try it →

Complete country profile: population, capital, currencies, languages, borders, timezones, flag and coordinates — by name, ISO2 or ISO3

Parameters

Name	Type	Required	Default	Description
?code	string	yes	—	Required code/input for this endpoint (postal code, source code, key…)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/country?code=DE"

GET /v1/countries $0.005 Try it →

All world countries ranked by population, filterable by region — compact records with capital, currency and flag

Parameters

Name	Type	Required	Default	Description
?limit	number	no	50	Maximum number of results to return
?region	string	no	—

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/countries"

GET /v1/worldbank $0.01 Try it →

World Bank open data: population, GDP, inflation, unemployment, life expectancy, CO2 and more — time series with % change for any country

Parameters

Name	Type	Required	Default	Description
?country	string	yes	—	ISO country code, e.g. US, DE, ES
?indicator	string	no	population	World Bank indicator: population, gdp, gdp-per-capita, inflation, unemployment, life-expectancy, co2-emissions…
?years	number	no	10	Number of years of history to return

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/worldbank?country=DE&indicator=population&years=30"

GET /v1/air-quality $0.005 Try it →

Air quality for any city or coordinates: US and European AQI, PM2.5, PM10, ozone, NO2 and 24h forecast with health levels

Parameters

Name	Type	Required	Default	Description
?city	string	no	—	City name, e.g. Barcelona
?lat	string	no	—	Latitude in decimal degrees
?lon	string	no	—	Longitude in decimal degrees

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/air-quality?city=Barcelona&lat=41.3874&lon=2.1686"

GET /v1/elevation $0.005 Try it →

Elevation/altitude for any point on Earth (Copernicus DEM): meters and feet, 10m resolution

Parameters

Name	Type	Required	Default	Description
?lat	string	yes	—	Latitude in decimal degrees
?lon	string	no	—	Longitude in decimal degrees

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/elevation?lat=41.3874&lon=2.1686"

GET /v1/zipcode $0.005 Try it →

ZIP/postal code lookup for 70+ countries: place names, state and coordinates — clean structured geodata

Parameters

Name	Type	Required	Default	Description
?code	string	yes	—	Required code/input for this endpoint (postal code, source code, key…)
?country	string	no	us	ISO country code, e.g. US, DE, ES

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/zipcode?code=90210&country=us"

GET /v1/tides $0.005 Try it →

Tides and sea levels from NOAA CO-OPS: today's 6-minute tidal predictions or the latest observed water level at any US station, in feet or meters — keyless official data

Parameters

Name	Type	Required	Default	Description
?datum	string	no	—
?product	string	no	—	NOAA product: predictions (today's tides, 6-min steps) or water_level (latest observation)
?station	string	no	—	NOAA CO-OPS station id, e.g. 8410140 (Eastport, ME) or 9410230 (La Jolla, CA). Default 8410140
?units	string	no	—	Comma-separated unit list

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/tides?product=predictions&station=8410140"

GET /v1/vin $0.005 Try it →

Decode any VIN (11-17 chars) via NHTSA vPIC: make, model, year, manufacturing country and plant, engine specs, body class and GVWR — keyless official US vehicle data

Parameters

Name	Type	Required	Default	Description
?vin	string	yes	—	Vehicle Identification Number, 11-17 alphanumeric characters (no I, O or Q)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/vin?vin=1HGCM82633A004352"

GET /v1/recalls $0.005 Try it →

NHTSA safety recalls for any US vehicle by make, model and year: campaign numbers, affected components, consequences, remedy and park-it/do-not-drive flags

Parameters

Name	Type	Required	Default	Description
?make	string	yes	—	Vehicle make, e.g. ford, toyota, bmw
?model	string	yes	—	Vehicle model, e.g. mustang, camry
?year	string	yes	—	Year in YYYY format

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/recalls?make=ford&model=mustang&year=2020"

GET /v1/water $0.005 Try it →

USGS real-time streamflow and gage height for any US river monitoring station: discharge in ft3/s, latest reading time and location — keyless official data

Parameters

Name	Type	Required	Default	Description
?site	string	no	—	USGS station number (7-9 digits), e.g. 01646500 (Potomac River at Point of Rocks)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/water?site=01646500"

GET /v1/pubchem $0.005 Try it →

Chemical compound properties from PubChem: molecular formula, weight, IUPAC name and canonical SMILES by compound name (aspirin, caffeine, glucose…) — rate-limit-safe

Parameters

Name	Type	Required	Default	Description
?compound	string	yes	—	Chemical compound name, e.g. aspirin, caffeine, glucose

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/pubchem?compound=aspirin"

GET /v1/ev-chargers $0.005 Try it →

EV charging stations near any point via Open Charge Map (global database): location, operator, status, connector types and power per station. Needs a free OCM key configured server-side

Parameters

Name	Type	Required	Default	Description
?lat	string	yes	—	Latitude in decimal degrees
?dist	string	no	—	Search radius in kilometers (1-100, default 10)
?lon	string	no	—	Longitude in decimal degrees

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/ev-chargers?lat=41.3874&lon=2.1686"

GET /v1/energy $0.01 Try it →

US electricity retail prices from the EIA v2 API: cents per kWh by state and month (all sectors). Needs a free EIA key configured server-side

Parameters

Name	Type	Required	Default	Description
?state	string	no	—	2-letter US state abbreviation, e.g. CA or TX

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/energy?state=CA"

GET /v1/congress $0.01 Try it →

US Congress bills, roll-call votes and single-bill records from the official Congress.gov API v3: latest actions on bills by default, ?bill=hr1234 for one bill's full record, ?votes=1 for recent floor votes. Free CONGRESS_KEY configured server-side

Parameters

Name	Type	Required	Default	Description
?bill	string	no	—	Bill type+number for a single Congress bill record, e.g. hr1234, s25
?congress	string	no	—	Congress number for bill lookups, e.g. 119 (2025-2026). Default 119
?limit	number	no	12	Maximum number of results to return
?votes	string	no	—	Set to 1 to return recent roll-call votes instead of bills

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/congress?limit=5"

GET /v1/federal-register $0.005 Try it →

US Federal Register documents (rules, proposed rules, notices, presidential documents) straight from the official API: newest first, with ?q= full-text filtering, issuing agencies and PDF links — keyless

Parameters

Name	Type	Required	Default	Description
?limit	number	no	10	Maximum number of results to return
?q	string	no	—	Search query or free-text question

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/federal-register?q=artificial+intelligence"

GET /v1/boe $0.005 Try it →

Spanish legislation from the Boletín Oficial del Estado: the day's full summary by section (ministry, heading, every document with id and PDF), ?date=YYYYMMDD for any day, ?id=BOE-A-… for one document, ?q= filters the day's items. Source cited in every response (fuente: BOE)

Parameters

Name	Type	Required	Default	Description
?date	string	no	—	Date in YYYYMMDD format (BOE summary)
?id	string	no	—	Resource identifier (PDB entry id like 4HHB, or BOE document id like BOE-A-2024-12345)
?q	string	no	—	Search query or free-text question

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/boe?date=20261002&q=us+elections"

GET /v1/census $0.01 Try it →

US population by state or county from the Census Bureau 2023 ACS 5-year estimates (B01001_001E): ?state=CA, add ?county=FIPS for counties. Aggregate published totals only — nothing person-level. Free CENSUS_KEY configured server-side

Parameters

Name	Type	Required	Default	Description
?county	string	no	—	3-digit FIPS county code (combined with state), e.g. 061
?state	string	no	—	2-letter US state abbreviation, e.g. CA or TX

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/census?state=CA"

GET /v1/rxnorm $0.005 Try it →

RxNorm code for any medication by name (ibuprofen, metformin…) from the US National Library of Medicine, with normalized name and term type — the standard drug identifier for e-prescribing and analytics, keyless

Parameters

Name	Type	Required	Default	Description
?name	string	yes	—	Name to look up: a medication (rxnorm/rxterms), person (sanctions, orcid) or company

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/rxnorm?name=ibuprofen"

GET /v1/rxterms $0.005 Try it →

RxTerms drug card from the NLM: generic name, full display name, strength, dose form and route. Accepts ?name= (resolves the drug-level code automatically) or ?rxcui= directly — keyless

Parameters

Name	Type	Required	Default	Description
?name	string	yes	—	Name to look up: a medication (rxnorm/rxterms), person (sanctions, orcid) or company
?rxcui	string	no	—	Numeric RxNorm code, e.g. 197805 (ibuprofen 400 MG oral tablet)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/rxterms?name=ibuprofen"

GET /v1/food $0.005 Try it →

Food nutrition from USDA FoodData Central: description, brand, serving and per-100g energy/protein/fat/carbs/fiber/sodium by food name. 24h cache; FDC_KEY recommended (falls back to the rate-limited public DEMO_KEY)

Parameters

Name	Type	Required	Default	Description
?q	string	yes	—	Search query or free-text question
?limit	number	no	8	Maximum number of results to return

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/food?q=cheddar+cheese"

GET /v1/chembl $0.005 Try it →

Drug-like compounds from ChEMBL (EMBL-EBI) by ChEMBL ID or preferred name (aspirin, metformin): type, first-approval year, ATC codes, canonical SMILES and top measured bioactivities — keyless

Parameters

Name	Type	Required	Default	Description
?molecule	string	yes	—	ChEMBL id (CHEMBL25) or preferred compound name (aspirin)
?activity	string	no	—	Specific ChEMBL activity id, e.g. CHEMBL1137723 (optional)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/chembl?molecule=CHEMBL25&activity=moderate"

GET /v1/pdb $0.005 Try it →

Protein structures from the RCSB Protein Data Bank: ?id=4HHB returns the entry (title, method, resolution, deposition date, citation), ?q=hemoglobin searches titles across the archive — keyless

Parameters

Name	Type	Required	Default	Description
?id	string	yes	—	Resource identifier (PDB entry id like 4HHB, or BOE document id like BOE-A-2024-12345)
?q	string	no	—	Search query or free-text question

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/pdb?id=4HHB&q=us+elections"

GET /v1/usaspending $0.01 Try it →

US federal contract awards by agency or company name from USAspending.gov (2025-2026, contracts A-D, sorted by amount): award id, recipient, agency and dollars — follow the federal money, keyless

Parameters

Name	Type	Required	Default	Description
?q	string	yes	—	Search query or free-text question
?limit	number	no	10	Maximum number of results to return

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/usaspending?q=Lockheed"

GET /v1/ine $0.01 Try it →

Spanish official statistics by INE Tempus3 series code: ?serie=ipc-anual (national CPI headline inflation), ipc, ipc-mensual, ipc-ytd or any Tempus code (EPA, paro…). Fuente INE citada en cada respuesta (requisito de cita) — keyless

Parameters

Name	Type	Required	Default	Description
?nult	number	no	24	Number of latest values to return from the series (default 24)
?serie	string	no	—	INE Tempus3 series code or alias: ipc, ipc-anual, ipc-mensual, ipc-ytd

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/ine?nult=12&serie=ipc-anual"

GET /v1/ensembl $0.005 Try it →

Human genes by symbol from Ensembl: stable id, assembly, biotype, chromosome coordinates, strand, description and transcript list — ?species= for other organisms, keyless

Parameters

Name	Type	Required	Default	Description
?symbol	string	yes	—	Gene symbol, e.g. BRCA1, TP53
?species	string	no	—	Latin species name for Ensembl, e.g. human (default) or mus_musculus

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/ensembl?symbol=BRCA1"

GET /v1/nass $0.01 Try it →

US agricultural statistics from USDA NASS Quick Stats: national harvested-area record counts by commodity and year (?commodity=CORN&year=2025). Free NASS_KEY configured server-side

Parameters

Name	Type	Required	Default	Description
?commodity	string	no	—	NASS commodity name, e.g. CORN, SOYBEANS, WHEAT
?year	string	no	—	Year in YYYY format

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/nass?commodity=CORN&year=2025"

🤖 Agent Platform 14 endpoints

State and plumbing for autonomous agents: key-value storage, batch calls, webhooks, URL monitoring and health heartbeats.

GET /v1/agent-health $0.02 Try it →

Complete agent deployment health: SSL + HTTP + DNS + wallet risk + overall score — one call

Parameters

No parameters — call it directly.

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/agent-health"

GET /v1/monitor $0.01 Try it →

URL change detection: hash comparison between checks — know when a page changes

Parameters

Name	Type	Required	Default	Description
?keyword	string	no	—	Search keyword
?url	string	no	—	Target public URL (SSRF-guarded: private IPs and non-HTTP schemes are rejected)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/monitor?keyword=stablecoin&url=https://example.com"

GET /v1/store $0.01 Try it →

Store key-value state for your agent: context, session data (TTL-based)

Parameters

Name	Type	Required	Default	Description
?key	string	no	—	Storage key name
?ttl	string	no	—	Time-to-live in seconds before the entry expires
?value	string	no	—	ETH value attached to the transaction, in wei (decimal or 0x-hex; default 0)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/store?key=session&value=100"

GET /v1/retrieve $0.005 Try it →

Retrieve stored key-value state

Parameters

Name	Type	Required	Default	Description
?key	string	no	—	Storage key name

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/retrieve?key=session"

GET /v1/webhook $0.01 Try it →

Send POST to any URL: Slack, Discord, custom webhooks

Parameters

Name	Type	Required	Default	Description
?payload	string	no	—	JSON payload to deliver
?url	string	no	—	Target public URL (SSRF-guarded: private IPs and non-HTTP schemes are rejected)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/webhook?payload=%7B%22text%22%3A%22Alert%22%7D&url=https://example.com"

GET /v1/batch $0.05 Try it →

Execute up to 10 Carredge API calls in ONE paid request — saves per-call fees, instant aggregation

Parameters

Name	Type	Required	Default	Description
?calls	string	no	—	Comma-separated list of Carredge paths for batch execution

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/batch?calls=/v1/funding,/v1/gas"

GET /v1/watch $0.02 Try it →

Set up URL monitoring with webhook trigger: we watch for changes, you get notified

Parameters

No parameters — call it directly.

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/watch"

GET /v1/watch-status $0.005 Try it →

Check the status of a previously created watch

Parameters

Name	Type	Required	Default	Description
?id	string	no	—	Resource identifier (PDB entry id like 4HHB, or BOE document id like BOE-A-2024-12345)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/watch-status"

GET /v1/decode-calldata $0.005 Try it →

Decode raw transaction calldata: selector to function signature and typed arguments (OpenChain + 4byte) — understand what an agent is about to sign

Parameters

Name	Type	Required	Default	Description
?data	string	no	—	Raw input for the operation: 0x-hex calldata (decode/simulate) or JSON payload (transform endpoints)
?to	string	no	—	0x contract address the transaction targets

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/decode-calldata?data=0xa9059cbb000000000000000000000000dead0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001&to=EUR"

GET /v1/monitoring-suite $0.05 Try it →

Complete monitoring setup: change detection + link health + security + performance baseline

Parameters

Name	Type	Required	Default	Description
?url	string	no	—	Target public URL (SSRF-guarded: private IPs and non-HTTP schemes are rejected)

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/monitoring-suite?url=https://example.com"

POST /v1/duel/create $0.05 Try it →

Compose the createDuel transaction for GameEscrowV1 (Base): player A opens a 1v1 blackjack skill-duel — equal stakes escrowed in the contract, same provably-fair shoe for both players, winner takes the pot minus the on-chain rake, ties refund 100%. Carredge is middleware: it never signs, never plays, never holds funds outside the escrow. You sign the returned calldata with your own wallet

Parameters

No parameters — call it directly.

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i -X POST "https://api.carredge.com/v1/duel/create" \
  -H 'Content-Type: application/json' \
  -d '{...}'

POST /v1/duel/join $0.03 Try it →

Compose the joinDuel transaction: player B matches the escrow stake of an open duel and locks their own secret commitment. Both commitments close before any reveal — the shared shoe seed cannot be front-run. You sign; the contract escrows; Carredge never touches funds

Parameters

No parameters — call it directly.

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i -X POST "https://api.carredge.com/v1/duel/join" \
  -H 'Content-Type: application/json' \
  -d '{...}'

GET /v1/duel/state $0.01 Try it →

On-chain state of a duel from GameEscrowV1 (Base): phase (AwaitJoin/AwaitReveal/AwaitMovesCommit/AwaitMovesReveal/AwaitSettle/Settled), players, escrowed stake, phase deadlines, computed result and the exact next action for agents — the state machine a dueling agent needs to play autonomously

Parameters

Name	Type	Required	Default	Description
?duelId	string	yes	—

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i "https://api.carredge.com/v1/duel/state?duelId=value"

POST /v1/arcade/play $0.005 Try it →

Agent Arcade: play a provably-fair game — dice, blackjack (deal/hit/stand), funding, candle, fear-greed or higher-lower. Base block hash + your salt = verifiable RNG; real market data (Binance, CoinGecko, alternative.me) is the referee. Win points, build streaks; top-3 weekly earns API-credit promo codes. Skill and glory only: NO money, no house, no edge

Parameters

Name	Type	Required	Default	Description
action	string	no	—	Blackjack action: deal, hit or stand
alias	string	no	—	Player alias, 2-24 chars (query-string alternative to body player.alias)
choice	string	no	—	Bet per game: dice over\|under\|seven · funding positive\|negative · candle green\|red · feargreed greed\|fear · higherlower higher\|lower
game	string	no	—	Arcade game: dice, blackjack, funding, candle, feargreed or higherlower
playerId	string	no	—
playId	string	no	—	Blackjack play id returned by action=deal (required for hit/stand)
salt	string	no	—	Your provably-fair input — any string chosen BEFORE the play; outcome = f(Base block hash, salt)
secret	string	no	—	Player secret — playerId = sha256(alias\|secret), never stored in clear; keep it safe

Example request

# Returns 402 + payment challenge. x402 clients pay and retry automatically.
curl -i -X POST "https://api.carredge.com/v1/arcade/play" \
  -H 'Content-Type: application/json' \
  -d '{
  "game": "dice",
  "choice": "seven",
  "salt": "my-salt-123",
  "player": { "alias": "bot-01", "secret": "my-agent-secret" }
}'

No endpoints match your search.
Try a shorter query, or reset.