# Swift Bot Labs Toolbox

> 62 small deterministic utility APIs for agents and scripts, paid per call with x402 (USDC on Base, exact scheme, pay-to 0x2481E29895b43e87e547a50fB0BB5aa1E70585EB). No account or API key. Failed calls are not charged.

Usage: request a tool URL; the first answer is HTTP 402 with a PAYMENT-REQUIRED header (base64 JSON, x402 v2). Sign a USDC transferWithAuthorization for exactly the amount and retry with the PAYMENT-SIGNATURE header. GET tools read query parameters; POST tools read a JSON object body. Successful responses: {"ok":true,"tool":...,"result":{...},"payment":{...}}.
MCP: POST JSON-RPC to https://x402-toolbox.swiftbotlab.workers.dev/mcp (stateless streamable HTTP). tools/call without _meta["x402/payment"] returns the PaymentRequired object.

OpenAPI: https://x402-toolbox.swiftbotlab.workers.dev/openapi.json

## DNS & e-mail

- [GET /v1/dns/lookup](https://x402-toolbox.swiftbotlab.workers.dev/v1/dns/lookup): $0.005 - DNS lookup for any record type over DNS-over-HTTPS. Params: name*, type
- [GET /v1/dns/mx](https://x402-toolbox.swiftbotlab.workers.dev/v1/dns/mx): $0.005 - Mail servers (MX) of a domain, sorted, with the mail provider. Params: domain*
- [GET /v1/dns/reverse](https://x402-toolbox.swiftbotlab.workers.dev/v1/dns/reverse): $0.005 - Reverse DNS (PTR) for an IPv4 or IPv6 address, with forward confirmation. Params: ip*
- [GET /v1/dns/spf](https://x402-toolbox.swiftbotlab.workers.dev/v1/dns/spf): $0.008 - SPF record check: full include tree, DNS lookup count, problems. Params: domain*
- [GET /v1/dns/dmarc](https://x402-toolbox.swiftbotlab.workers.dev/v1/dns/dmarc): $0.005 - DMARC record check and parsed policy. Params: domain*
- [GET /v1/email/validate](https://x402-toolbox.swiftbotlab.workers.dev/v1/email/validate): $0.005 - E-mail address check: syntax, MX, disposable, role, free provider, typos. Params: email*
- [GET /v1/email/security](https://x402-toolbox.swiftbotlab.workers.dev/v1/email/security): $0.02 - E-mail security audit of a domain: MX, SPF, DMARC, DKIM, MTA-STS, TLS-RPT, BIMI, grade. Params: domain*, dkimSelectors
- [GET /v1/domain/rdap](https://x402-toolbox.swiftbotlab.workers.dev/v1/domain/rdap): $0.01 - Domain registration data (RDAP/WHOIS): registrar, created, expires, age, status. Params: domain*

## Web

- [GET /v1/web/extract](https://x402-toolbox.swiftbotlab.workers.dev/v1/web/extract): $0.01 - Fetch a web page and return clean main text and Markdown plus title and metadata. Params: url*, format, mode, maxChars
- [GET /v1/web/metadata](https://x402-toolbox.swiftbotlab.workers.dev/v1/web/metadata): $0.008 - Page metadata for link previews and SEO: title, description, OpenGraph, Twitter card, JSON-LD, favicon. Params: url*
- [GET /v1/web/links](https://x402-toolbox.swiftbotlab.workers.dev/v1/web/links): $0.008 - All links on a page, absolute, de-duplicated, split into internal and external. Params: url*, filter, limit
- [GET /v1/web/headers](https://x402-toolbox.swiftbotlab.workers.dev/v1/web/headers): $0.005 - HTTP status, response headers, redirect chain, timing and a security-header audit. Params: url*, method
- [GET /v1/web/robots](https://x402-toolbox.swiftbotlab.workers.dev/v1/web/robots): $0.005 - Is a URL allowed for a crawler by robots.txt? Rules, crawl-delay and sitemaps. Params: url*, userAgent
- [GET /v1/web/sitemap](https://x402-toolbox.swiftbotlab.workers.dev/v1/web/sitemap): $0.008 - Read a sitemap.xml (or a site's default sitemap): URLs with lastmod, child sitemaps. Params: url*, limit
- [POST /v1/html/extract](https://x402-toolbox.swiftbotlab.workers.dev/v1/html/extract): $0.005 - Convert HTML you already have to clean text / Markdown and extract its metadata and links. Params: html*, baseUrl, format, mode, maxChars
- [GET /v1/url/parse](https://x402-toolbox.swiftbotlab.workers.dev/v1/url/parse): $0.003 - Parse, normalize and clean a URL (components, query params, punycode, tracking params removed). Params: url*

## EVM

- [GET /v1/evm/address](https://x402-toolbox.swiftbotlab.workers.dev/v1/evm/address): $0.003 - Validate an EVM address and return its EIP-55 checksum form. Params: address*
- [GET /v1/evm/contract](https://x402-toolbox.swiftbotlab.workers.dev/v1/evm/contract): $0.005 - Is an address a contract or a wallet? Code size, EIP-1967 proxy implementation/admin/beacon, EIP-7702 delegation. Params: address*, chain
- [GET /v1/evm/selector](https://x402-toolbox.swiftbotlab.workers.dev/v1/evm/selector): $0.003 - Function selector and event topic for a Solidity signature. Params: signature*
- [GET /v1/evm/selector-lookup](https://x402-toolbox.swiftbotlab.workers.dev/v1/evm/selector-lookup): $0.005 - Reverse-lookup 4-byte function selectors and 32-byte event topics to signatures. Params: selectors*
- [POST /v1/evm/abi-encode](https://x402-toolbox.swiftbotlab.workers.dev/v1/evm/abi-encode): $0.003 - ABI-encode values (or full calldata for a function signature). Params: signature, types, values*
- [POST /v1/evm/abi-decode](https://x402-toolbox.swiftbotlab.workers.dev/v1/evm/abi-decode): $0.003 - ABI-decode calldata, return data or log data with known types or a signature. Params: data*, signature, types
- [POST /v1/evm/calldata-decode](https://x402-toolbox.swiftbotlab.workers.dev/v1/evm/calldata-decode): $0.005 - Decode unknown transaction calldata: find the function signature and decode the arguments. Params: data*
- [GET /v1/evm/tx](https://x402-toolbox.swiftbotlab.workers.dev/v1/evm/tx): $0.01 - Explain an EVM transaction: status, fee, decoded method, ERC-20/721 transfers. Params: hash*, chain
- [GET /v1/evm/token](https://x402-toolbox.swiftbotlab.workers.dev/v1/evm/token): $0.005 - ERC-20 token metadata: name, symbol, decimals, total supply (on-chain). Params: address*, chain
- [GET /v1/evm/balance](https://x402-toolbox.swiftbotlab.workers.dev/v1/evm/balance): $0.005 - Native and ERC-20 balances of an address. Params: address*, chain, tokens
- [GET /v1/evm/gas](https://x402-toolbox.swiftbotlab.workers.dev/v1/evm/gas): $0.003 - Current gas price, base fee and priority fee on an EVM chain. Params: chain
- [GET /v1/evm/ens](https://x402-toolbox.swiftbotlab.workers.dev/v1/evm/ens): $0.005 - ENS: resolve a name to an address, or an address to its primary name (verified). Params: name, address
- [GET /v1/evm/units](https://x402-toolbox.swiftbotlab.workers.dev/v1/evm/units): $0.003 - Exact conversion between wei, gwei, ether or any token decimals. Params: value*, from, to
- [POST /v1/evm/verify-message](https://x402-toolbox.swiftbotlab.workers.dev/v1/evm/verify-message): $0.003 - Recover the signer of an EIP-191 personal_sign message and check it against an address. Params: message*, signature*, address, messageEncoding

## x402

- [GET /v1/x402/check](https://x402-toolbox.swiftbotlab.workers.dev/v1/x402/check): $0.01 - Probe an x402 endpoint: alive? what does it charge, on which chain, to whom? Is its 402 valid?. Params: url*, method
- [GET /v1/x402/search](https://x402-toolbox.swiftbotlab.workers.dev/v1/x402/search): $0.01 - Search the x402 Bazaar catalogs for paid APIs by keyword, with prices. Params: query*, network, maxPriceUsd, limit

## IP & CIDR

- [GET /v1/ip/info](https://x402-toolbox.swiftbotlab.workers.dev/v1/ip/info): $0.003 - Parse and classify an IPv4/IPv6 address (private, loopback, CGNAT, documentation, ...). Params: ip*
- [GET /v1/ip/cidr](https://x402-toolbox.swiftbotlab.workers.dev/v1/ip/cidr): $0.003 - Subnet calculator for an IPv4/IPv6 CIDR block. Params: cidr*
- [POST /v1/ip/contains](https://x402-toolbox.swiftbotlab.workers.dev/v1/ip/contains): $0.003 - Which of these IPs fall inside which CIDR ranges (allowlist / blocklist check). Params: cidrs*, ips*
- [GET /v1/ip/split](https://x402-toolbox.swiftbotlab.workers.dev/v1/ip/split): $0.003 - Split a CIDR block into smaller subnets. Params: cidr*, newPrefix*, limit
- [POST /v1/ip/aggregate](https://x402-toolbox.swiftbotlab.workers.dev/v1/ip/aggregate): $0.003 - Merge / summarize a list of CIDRs into the smallest equivalent set. Params: cidrs*
- [GET /v1/ip/range](https://x402-toolbox.swiftbotlab.workers.dev/v1/ip/range): $0.003 - Convert an IP range (start - end) to the minimal list of CIDR blocks. Params: start*, end*

## Data & text

- [POST /v1/json/validate](https://x402-toolbox.swiftbotlab.workers.dev/v1/json/validate): $0.003 - Validate JSON data against a JSON Schema (draft 2020-12 / draft-07). Params: schema*, data*, formats
- [POST /v1/json/format](https://x402-toolbox.swiftbotlab.workers.dev/v1/json/format): $0.003 - Parse, pretty-print, minify or canonicalize JSON (sorted keys); locate syntax errors. Params: json*, mode, indent, sortKeys
- [POST /v1/json/query](https://x402-toolbox.swiftbotlab.workers.dev/v1/json/query): $0.003 - Extract values from JSON with a JSON Pointer or a dotted path (a.b[0].c, items[*].id). Params: json*, path, paths
- [POST /v1/json/diff](https://x402-toolbox.swiftbotlab.workers.dev/v1/json/diff): $0.003 - Structural diff of two JSON documents as JSON-Patch-style operations. Params: a*, b*
- [POST /v1/csv/to-json](https://x402-toolbox.swiftbotlab.workers.dev/v1/csv/to-json): $0.003 - CSV / TSV to JSON (RFC 4180 quoting, delimiter auto-detect, type inference). Params: csv*, delimiter, header, inferTypes
- [POST /v1/json/to-csv](https://x402-toolbox.swiftbotlab.workers.dev/v1/json/to-csv): $0.003 - JSON array of objects to CSV (nested objects flattened to dot.keys). Params: json*, delimiter, flatten
- [POST /v1/text/stats](https://x402-toolbox.swiftbotlab.workers.dev/v1/text/stats): $0.003 - Text statistics: words, sentences, reading time, readability, top keywords. Params: text*, top
- [POST /v1/text/diff](https://x402-toolbox.swiftbotlab.workers.dev/v1/text/diff): $0.003 - Line diff of two texts as a unified diff with added/removed counts. Params: a*, b*, context
- [POST /v1/text/transform](https://x402-toolbox.swiftbotlab.workers.dev/v1/text/transform): $0.003 - Slugify and case conversion (camel, snake, kebab, title, constant ...), trim, dedupe lines. Params: text*, op*

## Encode & hash

- [POST /v1/hash](https://x402-toolbox.swiftbotlab.workers.dev/v1/hash): $0.003 - Hash text or bytes: SHA-1/2/3, Keccak-256, MD5, RIPEMD-160, BLAKE2/3. Params: data*, inputEncoding, algorithm, outputEncoding
- [POST /v1/hmac](https://x402-toolbox.swiftbotlab.workers.dev/v1/hmac): $0.003 - HMAC (SHA-256/384/512/1, MD5), e.g. to check a webhook signature. Params: message*, key*, keyEncoding, algorithm, expected
- [POST /v1/encode](https://x402-toolbox.swiftbotlab.workers.dev/v1/encode): $0.003 - Convert between UTF-8, hex, base64, base64url, base32, base58; URL and HTML escaping. Params: data*, from, to
- [GET /v1/uuid](https://x402-toolbox.swiftbotlab.workers.dev/v1/uuid): $0.003 - Generate UUIDs (v4 random, v7 time-ordered) or parse/validate one. Params: uuid, version, count
- [POST /v1/jwt/decode](https://x402-toolbox.swiftbotlab.workers.dev/v1/jwt/decode): $0.003 - Decode a JWT and check its times; optionally verify an HS256/384/512 signature. Params: token*, secret, secretEncoding
- [GET /v1/random](https://x402-toolbox.swiftbotlab.workers.dev/v1/random): $0.003 - Cryptographically secure random bytes, tokens and passwords. Params: kind, length, encoding, symbols, count

## Convert

- [GET /v1/convert/units](https://x402-toolbox.swiftbotlab.workers.dev/v1/convert/units): $0.003 - Convert between units: length, mass, volume, area, speed, time, data, pressure, energy, power, temperature, angle. Params: value*, from*, to*
- [GET /v1/time/convert](https://x402-toolbox.swiftbotlab.workers.dev/v1/time/convert): $0.003 - Convert a time between time zones and formats (ISO, unix, RFC 2822), with DST-aware offsets. Params: time, from, to
- [GET /v1/time/diff](https://x402-toolbox.swiftbotlab.workers.dev/v1/time/diff): $0.003 - Duration between two dates/times, calendar difference and business days. Params: start*, end, tz
- [GET /v1/cron/next](https://x402-toolbox.swiftbotlab.workers.dev/v1/cron/next): $0.003 - Explain a cron expression and list its next run times in any time zone. Params: expression*, tz, count, from
- [GET /v1/color](https://x402-toolbox.swiftbotlab.workers.dev/v1/color): $0.003 - Colour conversion (hex, RGB, HSL) and WCAG contrast ratio between two colours. Params: color*, against
- [GET /v1/convert/currency](https://x402-toolbox.swiftbotlab.workers.dev/v1/convert/currency): $0.005 - Currency conversion with official ECB euro reference rates (30 fiat currencies). Params: amount, from*, to*

## Validate & parse

- [GET /v1/semver](https://x402-toolbox.swiftbotlab.workers.dev/v1/semver): $0.003 - Semantic versions: parse, compare, sort, and check against npm-style ranges. Params: versions*, range, compareTo
- [GET /v1/iban/validate](https://x402-toolbox.swiftbotlab.workers.dev/v1/iban/validate): $0.003 - Validate an IBAN: country length, mod-97 check digits, formatted output. Params: iban*
- [GET /v1/user-agent](https://x402-toolbox.swiftbotlab.workers.dev/v1/user-agent): $0.003 - Parse a User-Agent: browser, engine, OS, device type, and known bots / AI crawlers. Params: ua*