Server definition
- Hash
- sha256:419f3cbb01c2f7494d9f63ef96761aaf5422f09c90987e2c775e6902c913d945
- What it is
- What a remote MCP server returned when asked what it offers: 131 tools
The blob, as servednamed by its sha256
{
"instructions": "Every tools/call is paid per call with x402 in _meta; initialize and tools/list are free. A call that ends with isError is not charged. Prepaid credits work over HTTP only for now. MCP tool calls are paid per call with x402.",
"tools": [
{
"description": "Use when an agent must receive a verification email (sign-up, login code, magic link) without a mailbox. Input: none. Output: address @inbox.1gateway.dev, id, one-time secret, read URL. Reads are free (header x-inbox-secret): sender, subject, text, with verification codes and confirmation links extracted. Receive only; 20 messages, 256 KB each, attachments dropped; deleted after 24 h. Some sites refuse new domains: not refunded. Example: GET /v1/agent/inbox Price: $0.01 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "agent_inbox",
"outputSchema": null
},
{
"description": "Use when an agent must receive a webhook or callback (payment, CI, form) but has no public server. Input: ttl_hours 1-168 (default 24). Output: public url https://1gateway.dev/h/…, id, one-time secret, read URL. Any method is stored (method, query, headers incl. signatures, body), answered 200. Reads free (header x-webhook-secret), ?wait=1-25 long-polls. Receive only; 50 requests, 64 KB each. Example: GET /v1/agent/webhook?ttl_hours=24 Price: $0.01 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"ttl_hours": {
"description": "Hours the URL stays live, 1-168 (default 24); the URL and every stored request are deleted after",
"type": "string"
}
},
"type": "object"
},
"name": "agent_webhook",
"outputSchema": null
},
{
"description": "Use when an agent needs vectors for search, RAG, clustering or dedup. Input: text (GET) or POST JSON {texts:[...]} with up to 32 strings of max 2000 chars each. Output: model, dims (1024), embeddings with index and vector; compare with cosine similarity. Multilingual (100+ languages, strong Korean). Not stored. Example: ?text=x402%20pay-per-call%20API Price: $0.003 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"text": {
"description": "One text to embed (1-2000 chars). For several, POST {\"texts\":[...]} (up to 32)",
"type": "string"
},
"texts": {
"description": "JSON array of up to 32 strings (alternative to text; POST JSON preferred)",
"type": "string"
}
},
"type": "object"
},
"name": "ai_embed",
"outputSchema": null
},
{
"description": "Use when an agent needs an image from a text prompt. Input: prompt (max 1000 chars), optional steps (1-8, default 4). Output: JSON with a 1024x1024 JPEG (base64), steps, model, safety verdicts. Prompt screened by blocklist + Llama Guard 3, image by a vision check; sexual, minor, deepfake or gore requests refused 422, not charged. Not stored. Example: ?prompt=isometric%20illustration%20of%20a%20tiny%20robot%20cafe Price: $0.02 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"prompt": {
"description": "What to draw (English works best). Sexual content, minors in suggestive scenes, real-person deepfakes and gore are refused (422, not charged)",
"type": "string"
},
"steps": {
"description": "Diffusion steps (default 4; more = finer detail, slower)",
"type": [
"number",
"string"
]
}
},
"required": [
"prompt"
],
"type": "object"
},
"name": "ai_image",
"outputSchema": null
},
{
"description": "Use when an agent must screen untrusted text (web page, email, tool output, RAG chunk) before an LLM reads it. Input: text (up to 20,000 chars, POST JSON or GET) or url. Output: JSON probability 0-1, verdict (injection >=0.7, suspicious >=0.35), attackTypes, spans with offsets, sanitizedText minus flagged spans, method (EN/KO rules + open-model classifier; rules only if the model is down). Heuristic, not a guarantee. Example: ?text=Ignore previous instructions Price: $0.005 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"text": {
"description": "Text to check (up to 20,000 characters). Required unless url is given; use POST JSON for long text",
"type": "string"
},
"url": {
"description": "Public http(s) page to fetch and check instead of text (SSRF-safe); give text or url, not both",
"type": "string"
}
},
"type": "object"
},
"name": "ai_prompt_injection",
"outputSchema": null
},
{
"description": "Use when an agent must turn audio into text (meetings, calls, voice notes). Input: POST a file (multipart 'file', raw body, JSON audioBase64) or url; mp3, wav, m4a, ogg, webm, flac, max 25 MB / 10 min. Output: text, language, timestamped segments, word count, duration; summary=true adds summary, key points, action items. $0.006 per started minute (+$0.004 summary), quoted before payment. Not stored. Example: POST {\"url\":\"https://.../call.mp3\"} Price: $0.006–$0.064 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"audioBase64": {
"description": "Audio bytes as base64 (alternative to url; max 25 MB decoded)",
"type": "string"
},
"language": {
"description": "Spoken language (default auto-detect)",
"enum": [
"auto",
"ko",
"en",
"ja",
"zh",
"es",
"fr",
"de"
],
"type": "string"
},
"summary": {
"description": "Add summary, key points and action items (+$0.004)",
"type": "boolean"
},
"url": {
"description": "Public http(s) URL of an audio file (mp3, wav, m4a, ogg, webm, flac; max 25 MB, 10 min)",
"type": "string"
}
},
"type": "object"
},
"name": "ai_transcribe",
"outputSchema": null
},
{
"description": "Use when an agent must translate text (replies, filings, contracts, transcripts). Input: text (max 1500 chars, GET or POST JSON), target code, optional source (else model-detected). Price: $0.003 up to 500 chars, $0.0045 for 501-1,500 (quoted before payment). Output: translatedText, source, model, fallback, cost fields. Keeps numbers and names. Allow a 60 s+ client timeout. Example: ?text=Hello%2C%20how%20are%20you%3F&target=ko Price: $0.003–$0.0045 USDC via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"source": {
"description": "Source language (optional; default auto: the model identifies it and the response says sourceDetected: true). A given source always wins",
"type": "string"
},
"target": {
"description": "Target language code",
"type": "string"
},
"text": {
"description": "Text to translate (1-1,500 chars). Up to 500 chars is $0.003; 501-1,500 chars is $0.0045. Empty or longer than 1,500 → 400 before payment (not charged)",
"type": "string"
}
},
"required": [
"text",
"target"
],
"type": "object"
},
"name": "ai_translate",
"outputSchema": null
},
{
"description": "Use when an agent needs spoken audio from short text (voice reply, narration, accessibility). Input: text (max 500 chars), lang (en, ko, ja, zh, es, fr; default en). Output: JSON with WAV audio (base64, mimeType given), voice, model, safety verdict. Fixed built-in voices, no voice cloning. Text screened by Llama Guard 3; unsafe 422, not charged. Not stored. Example: ?text=Hello%20from%201gateway&lang=en Price: $0.004 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"lang": {
"description": "Speech language (default en); one built-in voice per language",
"type": "string"
},
"text": {
"description": "Text to speak (1-500 chars). Empty or longer text → 400 before payment (not charged)",
"type": "string"
}
},
"required": [
"text"
],
"type": "object"
},
"name": "ai_tts",
"outputSchema": null
},
{
"description": "Use when an agent must understand a picture (screenshot, product photo, chart, scene). Input: url of a png, jpeg, webp or gif (max 5 MB), optional question (max 1000 chars), optional json=true for fields (objects, text, people count, colors...). Output: answer or fields, image info, model. Does not name people; exact text: /v1/convert/ocr. Not stored. Example: ?url=https://upload.wikimedia.org/wikipedia/commons/4/47/PNG_transparency_demonstration_1.png Price: $0.006 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"json": {
"description": "true returns structured fields instead of free text",
"type": "string"
},
"question": {
"description": "What to ask about the image (default: a detailed description)",
"type": "string"
},
"url": {
"description": "Public http(s) image URL (png, jpeg, webp, gif; max 5 MB). Bad or private URL → 400 before payment; non-image → 422, not charged",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "ai_vision",
"outputSchema": null
},
{
"description": "Use when an agent must price, time or route a transaction. Input: optional chain (base default, ethereum, arbitrum, monad, all). Output: JSON base fee, priority tiers (last 20 blocks), suggested maxFeePerGas, block fullness, typical cost of transfer, approve, DEX swap, mint, deploy in gas token (ETH, MON) and USD (Base adds L1 data fee); chain=all adds a compare table and the cheapest chain per action by USD. Example: ?chain=all Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "Chain (default base); all = the four compared. Bad value → 400 before payment (not charged)",
"type": "string"
}
},
"type": "object"
},
"name": "base_gas",
"outputSchema": null
},
{
"description": "Use when an agent, x402 test or CI job needs Base Sepolia gas now: one x402 call, no faucet login or mainnet history. Input: to (recipient address); sends 0.1 ETH (1 ETH: /v1/testnet/base-sepolia-eth/1). Output: JSON txHash (confirmed before settling), explorerUrl, amountEth, from, to. Daily limits (UTC): 5 ETH per address (both sizes), 20 overall; checked before payment. Test ETH has no monetary value. Example: ?to=0x000000000000000000000000000000000000dEaD Price: $0.05 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"to": {
"description": "Recipient address (EIP-55 checksum if mixed case). Bad input, caps reached or out of stock → 4xx/503 before payment (not charged)",
"type": "string"
}
},
"required": [
"to"
],
"type": "object"
},
"name": "base_sepolia_eth",
"outputSchema": null
},
{
"description": "Use when contract deploys, x402 tests or CI jobs need more Base Sepolia gas than a faucet gives: one x402 call, no faucet login or mainnet history. Input: to (recipient address); sends 1 Base Sepolia ETH. Output: JSON txHash (confirmed before settling), explorerUrl, amountEth, from, to. Daily limits (UTC): 5 ETH per address (both sizes), 20 overall; checked before payment. Test ETH has no monetary value. Example: ?to=0x000000000000000000000000000000000000dEaD Price: $0.50 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"to": {
"description": "Recipient address (EIP-55 checksum if mixed case). Bad input, caps reached or out of stock → 4xx/503 before payment (not charged)",
"type": "string"
}
},
"required": [
"to"
],
"type": "object"
},
"name": "base_sepolia_eth_1",
"outputSchema": null
},
{
"description": "Use when an agent must see who is buying or dumping a Base ERC-20 now (smart money, whales, who bought/sold). Input: token address, optional wallet, minutes (1-240), limit, min_usd, labels=1. Output: JSON signal (smart money vs retail), whale/shark/dolphin/fish flow buckets, who bought/sold, notable wallets, repeat traders, largest swaps, DEX netflow. On-chain only; address ≠ person. Example: ?address=0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed Price: $0.018 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "ERC-20 token contract on Base mainnet. EOA → 400, non-ERC-20 → 422 (not charged)",
"type": "string"
},
"labels": {
"description": "1 = entity labels + OFAC flags",
"type": "string"
},
"limit": {
"description": "Rows per list (default 10)",
"type": [
"number",
"string"
]
},
"min_usd": {
"description": "Min USD for largestTransfers",
"type": [
"number",
"string"
]
},
"minutes": {
"description": "Look-back minutes (default 60, max 240); busy tokens may be cut short (window.complete)",
"type": [
"number",
"string"
]
},
"wallet": {
"description": "Optional wallet to drill into (received/sent/net, DEX bought/sold)",
"type": "string"
}
},
"required": [
"address"
],
"type": "object"
},
"name": "base_token_flows",
"outputSchema": null
},
{
"description": "Use when an agent needs an ERC-20's basics before quoting, transferring or approving it. Input: address; chain (base default, ethereum, arbitrum, monad); optional holder (balance, share of supply) and spender (allowance, flags unlimited). Output: JSON block+time, name, symbol, decimals, totalSupply, known issuer if curated. Name/symbol are self-reported. EOA or non-ERC-20: 4xx, not charged. Example: ?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "ERC-20 token contract on the chosen chain (0x + 40 hex; mixed case must be a valid EIP-55 checksum). EOA → 400, non-ERC-20 contract → 422 (not charged)",
"type": "string"
},
"chain": {
"description": "EVM chain (default base)",
"type": "string"
},
"holder": {
"description": "Optional address whose token balance and share of total supply to include",
"type": "string"
},
"spender": {
"description": "Optional spender; with holder, adds allowance(holder, spender). Needs holder.",
"type": "string"
}
},
"required": [
"address"
],
"type": "object"
},
"name": "base_token_info",
"outputSchema": null
},
{
"description": "ERC-20 token risk scan: honeypot check, rug pull check, token safety / scam check. Use when vetting a token. Input: address, chain=base|ethereum|arbitrum. Output: JSON risk signals + evidence: honeypot test (buy/sell sim, taxes), rug-pull signals (owner, mint/pause/blacklist/fee fns, proxy, owner supply, pool depth), meme, notChecked. Signals, not a safe verdict. EOA: 400, free. Example: ?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 Price: $0.009 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "Token contract (EIP-55 checksum if mixed case). EOA or bad checksum → 400, not charged",
"type": "string"
},
"chain": {
"description": "EVM chain (default base); monad → 400",
"type": "string"
}
},
"required": [
"address"
],
"type": "object"
},
"name": "base_token_risk",
"outputSchema": null
},
{
"description": "Use when an agent wants a quick read on an ERC-20 before trading: token-risk scan plus a short AI verdict. Input: address; chain (base, ethereum, arbitrum). Output: JSON verdict (level = deterministic riskLevel, headline, top reasons citing fired signal ids, what to watch) + all risk signals, meme block, simulation, notChecked. Signals, not advice; not a safe verdict. Bad input/EOA: 400, not charged. Example: ?address=0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed Price: $0.011 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "Token contract on the chosen chain (EIP-55 checksum if mixed case). EOAs, bad checksums → 400 before payment (not charged)",
"type": "string"
},
"chain": {
"description": "EVM chain (default base); monad → 400",
"type": "string"
}
},
"required": [
"address"
],
"type": "object"
},
"name": "base_token_verdict",
"outputSchema": null
},
{
"description": "Use when an agent must confirm a transaction or payment landed: did it succeed, who paid whom, how much of which token. Input: hash; chain (base default, ethereum, arbitrum, monad). Output: JSON status (success/reverted), block+time, confirmations, from, to, native value, fee, decoded ERC-20 transfers with symbol and amount (first 25). Unknown or unmined hash: 404, not charged. Example: ?hash=0x284f8abed91b5631ee28bdb1ccfe78374e18c480cb2ab25f28e3bfac5210fe0b Price: $0.0045 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "EVM chain (default base)",
"type": "string"
},
"hash": {
"description": "Transaction hash on the chosen chain (0x + 64 hex). Unknown or not yet mined → 404 (not charged)",
"type": "string"
}
},
"required": [
"hash"
],
"type": "object"
},
"name": "base_tx",
"outputSchema": null
},
{
"description": "Use when an agent needs an EVM wallet's holdings in one call. Input: address; chain (base default, ethereum, arbitrum, monad); optional tokens (up to 20 ERC-20s; default: main stablecoins, WETH, BTC wrappers). Output: JSON block+time, native balance (ETH; MON on Monad), per-token symbol, decimals, raw and decimal balance, nonce, isContract. Chain state only, no prices. Bad input: 400, not charged. Example: ?address=0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1 Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "Wallet or contract (0x + 40 hex; mixed case must be a valid EIP-55 checksum). Bad input → 400 (not charged)",
"type": "string"
},
"chain": {
"description": "EVM chain (default base)",
"type": "string"
},
"tokens": {
"description": "Up to 20 comma-separated ERC-20 contract addresses on the chosen chain. Omit for the default set. A contract that is not an ERC-20 is listed with status not_an_erc20.",
"type": "string"
}
},
"required": [
"address"
],
"type": "object"
},
"name": "base_wallet_balances",
"outputSchema": null
},
{
"description": "Use when an agent must see who an EVM wallet deals with: counterparties ranked by ERC-20 transfers, earliest inbound sender, wallets the same funder also paid, tokens. Input: address, chain (base default, ethereum, arbitrum, monad), hours (1-24; Arbitrum 1-6, Monad 1-2), limit. Output: JSON counterparties with labels (contract/EOA, token, router/bridge, OFAC flag), first and shared funder. ERC-20 only. Example: ?address=0xd0b53D9277642d899DF5C87A3966A349A798F224 Price: $0.01 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "Wallet (or contract) on the chosen chain (example: Uniswap v3 WETH/USDC pool on Base, a busy contract; a quiet wallet returns 0 transfers, not an error)",
"type": "string"
},
"chain": {
"description": "EVM chain (default base)",
"type": "string"
},
"hours": {
"description": "Look-back in hours (default 6; max 24, Arbitrum max 6, Monad max 2 and default 2)",
"type": [
"number",
"string"
]
},
"limit": {
"description": "Counterparty rows (default 15)",
"type": [
"number",
"string"
]
}
},
"required": [
"address"
],
"type": "object"
},
"name": "base_wallet_related",
"outputSchema": null
},
{
"description": "Use when an agent researches drugs, diseases or biotech sponsors, or watches trial readouts. Input: condition, intervention (drug), sponsor or q (one or more), optional status, phase, limit, mode=catalysts with days (primary completion within N days, default 90). Output: JSON studies (NCT id, title, phases, status, enrollment, key dates, sponsor, conditions, interventions, countries, link). Example: ?condition=obesity&intervention=semaglutide&phase=3 Price: $0.01 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"condition": {
"description": "Disease or condition",
"type": "string"
},
"days": {
"description": "catalysts window in days (default 90)",
"type": [
"number",
"string"
]
},
"intervention": {
"description": "Drug, device or other intervention (alias drug)",
"type": "string"
},
"limit": {
"description": "Studies to return (default 10)",
"type": [
"number",
"string"
]
},
"mode": {
"description": "search (default, newest updates first) or catalysts (primary completion due soon, soonest first)",
"type": "string"
},
"phase": {
"description": "Comma list: early1, 1, 2, 3, 4",
"type": "string"
},
"q": {
"description": "Free-text search over study records",
"type": "string"
},
"sponsor": {
"description": "Lead sponsor or collaborator",
"type": "string"
},
"status": {
"description": "Comma list: recruiting, not_yet_recruiting, active, enrolling_by_invitation, completed, terminated, suspended, withdrawn",
"type": "string"
}
},
"type": "object"
},
"name": "clinical_trials",
"outputSchema": null
},
{
"description": "Use when an agent must read text from a scan, photo or screenshot: scanned PDFs (embedded page images) or PNG/JPEG/WebP up to 5 MB, Korean and English, tables kept as Markdown. Up to 3 pages per call. Input: url via GET, or POST a file (multipart 'file', raw body, or JSON contentBase64). Output: JSON markdown, pages with confidence, warnings. PDFs with selectable text: use /v1/convert/markdown. Example: ?url=<Tesseract eurotext.png sample> Price: $0.015 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"contentBase64": {
"description": "File bytes as base64 (MCP argument or POST JSON; alternative to url; max 5 MB decoded)",
"type": "string"
},
"url": {
"description": "Public http(s) URL of a PNG/JPEG/WebP image or a scanned PDF (≤ 5 MB). For uploads use POST.",
"type": "string"
}
},
"type": "object"
},
"name": "convert_ocr",
"outputSchema": null
},
{
"description": "Use when an agent must read a document as clean Markdown: web page, PDF, DOCX or Korean HWP/HWPX, tables kept. Input: url (http/https) via GET, or POST a file (multipart 'file', raw body, or JSON contentBase64+filename). Free-plan size cap → 413 before payment: HWP 48 KB, HWPX 100 KB XML. Output: JSON markdown, title, pages, sourceType, warnings. Price by detected type: HTML $0.0027, PDF/DOCX $0.0045, HWP/HWPX $0.009. Example: ?url=https://example.com/ Price: $0.0027–$0.009 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"contentBase64": {
"description": "Document bytes as base64 (alternative to url; max 10 MB decoded)",
"type": "string"
},
"filename": {
"description": "Original file name, e.g. report.hwp (helps detection)",
"type": "string"
},
"type": {
"description": "Optional expected type: html, text, pdf, docx, hwp, hwpx",
"type": "string"
},
"url": {
"description": "Public http(s) URL of a web page, PDF, DOCX, HWP or HWPX (max 10 MB)",
"type": "string"
}
},
"type": "object"
},
"name": "convert_to_markdown",
"outputSchema": null
},
{
"description": "Use when an agent needs US spot bitcoin or ether ETF holdings from official filings (IBIT, FBTC, GBTC, ETHA...). Input: asset (btc or eth), optional ticker. Output: JSON per fund coins held (reported or estimated), fair value USD, NAV/share, shares outstanding, sponsor fee, period end, change vs previous period, share of coins, filing link; totals. From 10-Q/10-K XBRL, not daily flows. Cached 12 h. Example: ?asset=btc Price: $0.0045 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"asset": {
"description": "btc (11 spot bitcoin ETFs) or eth (8 spot ether ETFs)",
"type": "string"
},
"ticker": {
"description": "One fund only (IBIT, FBTC, GBTC, BTC, ARKB, BITB, HODL, BRRR, EZBC, BTCO, BTCW; ETHA, FETH, ETHE, ETH, ETHW, EZET, QETH, TETH). Unknown: 400 before payment",
"type": "string"
}
},
"type": "object"
},
"name": "crypto_etf",
"outputSchema": null
},
{
"description": "Use when an agent compares one coin's perp basis on DEX venues only (Hyperliquid, dYdX v4, GMX v2, Lighter, Paradex; no CEX). Input: coin, optional venues. Output: JSON per venue mark, index/oracle, premium %, annualized funding, OI USD; max-min funding spread; carry pairs ranked by funding spread. Derived statistics, not investment advice; fees and risk ignored. Example: ?coin=BTC Price: $0.003 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"coin": {
"description": "Base symbol, e.g. BTC, ETH, SOL. Not listed on any selected venue → 404 (not charged)",
"type": "string"
},
"venues": {
"description": "Comma list of hyperliquid, dydx, gmx, lighter, paradex (default all)",
"type": "string"
}
},
"required": [
"coin"
],
"type": "object"
},
"name": "crypto_perp_basis",
"outputSchema": null
},
{
"description": "Use when an agent compares perpetual funding across venues for one coin (carry/crowding). Input: coin (e.g. BTC). Output: JSON venues ranked by annualized funding (DEX venues only: Hyperliquid, dYdX, GMX, Lighter, Paradex), normalized to per-hour and APR, max-min spread with short/long venue, consensus mean, Hyperliquid mark vs oracle and vs dYdX oracle basis. Derived figures only; cached 60 s. Unknown coin: 400, not charged. Example: ?coin=BTC Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"coin": {
"description": "Hyperliquid perp symbol (BTC, ETH, SOL). Not listed: 400 before payment (not charged); venues that do not list it are reported as unavailable",
"type": "string"
}
},
"required": [
"coin"
],
"type": "object"
},
"name": "crypto_perp_funding",
"outputSchema": null
},
{
"description": "Use when an agent scans every perp listed on Hyperliquid, dYdX v4, GMX v2, Lighter and Paradex for funding arbitrage or crowding. Input: optional sort (spread, funding, oi, volume), order, limit (1-50), venues, min_venues, min_oi_usd. Output: JSON rows per coin with each venue's annualized funding, OI USD, 24h volume, max-min funding spread with short/long venue, mean APR, totals, coverage. Example: ?sort=spread&min_oi_usd=1000000 Price: $0.008 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"description": "Rows returned (1-50, default 20)",
"type": [
"number",
"string"
]
},
"min_oi_usd": {
"description": "Only coins whose summed open interest >= this many USD",
"type": [
"number",
"string"
]
},
"min_venues": {
"description": "Only coins listed on at least this many selected venues (default 2)",
"type": [
"number",
"string"
]
},
"order": {
"description": "desc (default) or asc",
"type": "string"
},
"sort": {
"description": "Ranking: spread (max-min venue funding APR, default), funding (mean APR), oi (total USD), volume (total 24h USD)",
"type": "string"
},
"venues": {
"description": "Comma list of at least 2 of hyperliquid, dydx, gmx, lighter, paradex (default all)",
"type": "string"
}
},
"type": "object"
},
"name": "crypto_perp_screener",
"outputSchema": null
},
{
"description": "Use when an agent needs a major coin's USD price by ticker. Input: symbols, 1-5 of BTC, ETH, SOL, USDC, AERO, DEGEN, BONK, JUP, CBBTC, WETH. Output: per symbol priceUsd, confidence, DEX pool (Uniswap/Aerodrome on Base, Orca on Solana), depth, block or slot, and the token used (BTC = cbBTC, ETH = WETH). Onchain pools only, no exchange feed. Example: ?symbols=BTC,ETH Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"symbols": {
"description": "1-5 tickers, comma-separated (BTC, ETH, SOL, USDC, AERO, DEGEN, BONK, JUP, CBBTC, WETH; alias symbol). Unknown ticker → 400 before payment",
"type": "string"
}
},
"required": [
"symbols"
],
"type": "object"
},
"name": "crypto_price",
"outputSchema": null
},
{
"description": "Use when an agent needs a one-call crypto market snapshot before acting. Input: none. Output: JSON one-line summary; BTC, ETH, SOL price, 24 h change, funding APR, OI, volume; Crypto Fear & Greed value, label, 1 d/7 d change with attribution; OI-weighted perp funding with highest/lowest markets; onchain stablecoin supply and 24 h/7 d net mint or burn. Example: /v1/crypto/pulse Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "crypto_pulse",
"outputSchema": null
},
{
"description": "Use when an agent tracks stablecoin liquidity (mints/burns) as a market signal. Input: optional chain (all, ethereum, base), symbol (USDC). Output: JSON per token and chain totalSupply read onchain, change 24 h / 7 d (absolute and %), per-symbol sums, USD net change and direction, biggest movers, block numbers; peg=true adds Chainlink price, deviation bp and depeg status. Ethereum + Base only. Example: ?chain=all&peg=true Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "Chain filter (default all)",
"type": "string"
},
"peg": {
"description": "true adds peg rows: Chainlink price, deviation in bp vs $1 (EURC vs EUR/USD), feed age, ok/watch/depeg/stale",
"type": "string"
},
"symbol": {
"description": "Only this stablecoin (USDT, USDC, USDS, DAI, USDe, PYUSD, FDUSD, RLUSD, USD1, EURC)",
"type": "string"
}
},
"type": "object"
},
"name": "crypto_stablecoins",
"outputSchema": null
},
{
"description": "Use when an agent must check if a wallet's loans are near liquidation. Input: address, optional chain (base, ethereum, arbitrum, all). Output: JSON per chain Aave v3 collateral, debt, borrowing power, LTV, health factor and liquidation distance %; Compound v3 supplied/borrowed base asset and isLiquidatable; summary with the lowest health factor. Read from contracts. Example: ?address=0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1 Price: $0.003 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "EVM wallet (EIP-55 checksum if mixed case). Bad address → 400 before payment (not charged)",
"type": "string"
},
"chain": {
"description": "Chain to check (default all)",
"type": "string"
}
},
"required": [
"address"
],
"type": "object"
},
"name": "defi_health",
"outputSchema": null
},
{
"description": "Use when an agent compares ETH liquid staking tokens or checks one for a depeg. Input: optional token (wstETH, cbETH, rETH, weETH; comma list). Output: JSON per token exchange rate now, 7 and 30 days ago, apr7dPct and apr30dPct from rate growth, DEX market price in ETH and premiumPct vs the redemption rate. Read from Ethereum contracts and Uniswap pools, no yield API. Example: /v1/defi/staking Price: $0.003 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"token": {
"description": "Comma list of wstETH, cbETH, rETH, weETH (default all). Unknown token → 400 before payment (not charged)",
"type": "string"
}
},
"type": "object"
},
"name": "defi_staking",
"outputSchema": null
},
{
"description": "Use when an agent must compare DeFi lending rates. Input: chain (base, ethereum, arbitrum), optional protocol (aave-v3, compound-v3, morpho, moonwell) and asset (USDC, USDT, WETH, WBTC, cbBTC, wstETH…). Output: JSON per market supply/borrow APY, utilization, supplied/borrowed, TVL USD; chain=ethereum adds wstETH/cbETH/rETH staking rates (7-day APR). Read from contracts, no yield API. Example: ?chain=ethereum&asset=USDC Price: $0.0045 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"asset": {
"description": "Comma list of the chain's assets (Base: USDC, WETH, cbBTC, wstETH, cbETH, EURC; Ethereum: USDC, USDT, WETH, WBTC, cbBTC, wstETH; Arbitrum: USDC, USDT, WETH, WBTC, wstETH). Bad value → 400 before payment",
"type": "string"
},
"chain": {
"description": "Chain (default base). Moonwell is Base only; Morpho vaults Base and Ethereum. Bad value → 400 before payment",
"type": "string"
},
"protocol": {
"description": "Comma list of aave-v3, compound-v3, morpho, moonwell (default all on the chain). Bad value → 400 before payment (not charged)",
"type": "string"
}
},
"type": "object"
},
"name": "defi_yields",
"outputSchema": null
},
{
"description": "Use when an agent must decide whether to add or keep a dependency. Input: package, ecosystem (npm, PyPI, crates.io), optional version (default latest). Output: JSON flags (deprecated, yanked, outdated, vulnerable, no_license, no_release_2y), latest version, license, publish dates, maintainer count, downloads, repository, OSV advisories. Example: ?package=request&ecosystem=npm Price: $0.01 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"ecosystem": {
"description": "Registry (case-insensitive; pip/python, cargo/rust also accepted)",
"type": "string"
},
"package": {
"description": "Package name as in its registry (npm scopes allowed: @scope/name)",
"type": "string"
},
"version": {
"description": "Exact released version (default: latest); unknown version → 404, not charged",
"type": "string"
}
},
"required": [
"package",
"ecosystem"
],
"type": "object"
},
"name": "dev_package",
"outputSchema": null
},
{
"description": "Use when an agent needs the key facts of a document, not just its text: Korean HWP/HWPX, PDF, DOCX or web page. Input: url via GET, or POST a file (multipart 'file', raw body, or JSON contentBase64+filename). Output: fixed-schema JSON title, title_en, document_type, date, org, amounts, english_overview, tables (rows, header columns, merged cells, records). Bad input or model outage refused before payment. Example: ?url=https://example.com/ Price: $0.009 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"type": {
"description": "Optional expected type; a mismatch is rejected before payment (415, not charged)",
"type": "string"
},
"url": {
"description": "Public http(s) URL of a PDF, DOCX, HWP, HWPX or web page. For uploads use POST.",
"type": "string"
}
},
"type": "object"
},
"name": "docs_extract",
"outputSchema": null
},
{
"description": "Use when an agent must check a domain: does it resolve, who hosts its DNS and mail, is email authenticated, how old is it, when does it expire. Input: domain (e.g. example.com; URLs accepted). Output: JSON DNS records (A, AAAA, CNAME, MX, NS, TXT, CAA, SOA), mail provider, parsed SPF and DMARC, DNS provider, and RDAP registration (registrar, created, expires, age in days, status, DNSSEC). No contact data. Example: ?domain=google.com Price: $0.0045 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"domain": {
"description": "Public domain or hostname (punycode for IDNs, e.g. xn--...); a URL is reduced to its hostname. Internal/reserved names → 400 (not charged)",
"type": "string"
}
},
"required": [
"domain"
],
"type": "object"
},
"name": "domain_lookup",
"outputSchema": null
},
{
"description": "Use when an agent is about to email or sign up a contact. Input: email. Output: JSON verdict (deliverable, risky, undeliverable) with reasons, MX hosts, null MX, SPF and DMARC policy, disposable domain, role account, free provider. No SMTP probe, so the mailbox itself is not verified. Malformed address refused before payment. Example: [email protected] Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"email": {
"description": "Email address to check",
"type": "string"
}
},
"required": [
"email"
],
"type": "object"
},
"name": "email_check",
"outputSchema": null
},
{
"description": "Use when you need to convert an amount between currencies (USD↔KRW, EUR→JPY, ...) at the official ECB reference rate, today or on a past date. Input: from, to (1–10 comma-separated), amount (default 1), optional date (YYYY-MM-DD since 1999-01-04; weekends use the prior fixing). Output: JSON per target rate, inverse rate and converted result, the fixing date used. Source: ECB statistics; reference only. Example: ?from=USD&to=KRW,JPY&amount=250 Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"amount": {
"description": "Amount in the source currency (default 1)",
"type": [
"number",
"string"
]
},
"date": {
"description": "Fixing date YYYY-MM-DD from 1999-01-04 (default latest)",
"type": "string"
},
"from": {
"description": "Source currency, ISO 4217 (one of the 30 ECB reference currencies)",
"type": "string"
},
"to": {
"description": "1–10 comma-separated target currencies. Supported: EUR,USD,JPY,KRW,CNY,GBP,AUD,BRL,CAD,CHF,CZK,DKK,HKD,HUF,IDR,ILS,INR,ISK,MXN,MYR,NOK,NZD,PHP,PLN,RON,SEK,SGD,THB,TRY,ZAR",
"type": "string"
}
},
"required": [
"from",
"to"
],
"type": "object"
},
"name": "fx_convert",
"outputSchema": null
},
{
"description": "Use when you need a historical exchange-rate series or a period summary (e.g. USD/KRW over the last quarter). Input: symbols (1–10), base (default EUR), start and end (YYYY-MM-DD since 1999-01-04; default last 30 days; max 366 days). Output: JSON daily series of ECB fixings, and per currency first/last, % change, min/max with dates, average and daily volatility. Source: ECB statistics; reference only. Example: ?base=USD&symbols=KRW,JPY&start=2026-07-01&end=2026-09-30 Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"base": {
"description": "Base currency (default EUR)",
"type": "string"
},
"end": {
"description": "End date YYYY-MM-DD (default today; range ≤ 366 days)",
"type": "string"
},
"start": {
"description": "Start date YYYY-MM-DD (default end minus 30 days; earliest 1999-01-04)",
"type": "string"
},
"symbols": {
"description": "1–10 comma-separated currencies. Supported: EUR,USD,JPY,KRW,CNY,GBP,AUD,BRL,CAD,CHF,CZK,DKK,HKD,HUF,IDR,ILS,INR,ISK,MXN,MYR,NOK,NZD,PHP,PLN,RON,SEK,SGD,THB,TRY,ZAR",
"type": "string"
}
},
"required": [
"symbols"
],
"type": "object"
},
"name": "fx_history",
"outputSchema": null
},
{
"description": "Use when you need an official daily FX rate or currency conversion (USD, EUR, KRW, JPY, CNY, GBP + 24 more). Input: base (default EUR), optional symbols (comma list), date (YYYY-MM-DD, last ~90 days; weekends use the prior fixing), amount. Output: JSON rates for the fixing date, % change vs prior fixing, converted amounts, raw ECB EUR rates. Source: ECB statistics, updated each TARGET day ~16:00 CET; reference only. Example: ?base=USD&symbols=KRW,JPY&amount=100 Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"amount": {
"description": "Amount in base currency to convert",
"type": [
"number",
"string"
]
},
"base": {
"description": "Base currency, ISO 4217 (one of the 30 ECB reference currencies; default EUR)",
"type": "string"
},
"date": {
"description": "Fixing date YYYY-MM-DD within the last ~90 days (default latest)",
"type": "string"
},
"symbols": {
"description": "Comma-separated target currencies (default: all). Supported: EUR,USD,JPY,KRW,CNY,GBP,AUD,BRL,CAD,CHF,CZK,DKK,HKD,HUF,IDR,ILS,INR,ISK,MXN,MYR,NOK,NZD,PHP,PLN,RON,SEK,SGD,THB,TRY,ZAR",
"type": "string"
}
},
"type": "object"
},
"name": "fx_rates",
"outputSchema": null
},
{
"description": "Use when an agent needs price history for a Hyperliquid perp or HIP-3 market (xyz:TSLA). Input: coin, interval (1m-1M, default 1h), limit (1-500, default 100), optional start/end (ISO date or unix). Output: JSON candles (time, open, high, low, close, volume, trades) plus summary: change %, high/low, volume, annualized realized volatility. Unknown coin: 400, not charged. Example: ?coin=ETH&interval=1h&limit=24 Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"coin": {
"description": "Hyperliquid perp symbol (BTC, ETH, kPEPE) or HIP-3 dex:COIN (xyz:TSLA). Not listed or delisted: 400 before payment (not charged)",
"type": "string"
},
"end": {
"description": "End time: ISO date/time or unix seconds/ms (default now)",
"type": "string"
},
"interval": {
"description": "Candle interval (default 1h)",
"type": "string"
},
"limit": {
"description": "Number of candles, newest last (1-500, default 100)",
"type": [
"number",
"string"
]
},
"start": {
"description": "Start time: ISO date/time or unix seconds/ms (default end - limit x interval)",
"type": "string"
}
},
"required": [
"coin"
],
"type": "object"
},
"name": "hl_candles",
"outputSchema": null
},
{
"description": "Use when hunting crowded perps: which markets have funding far from their own normal and where open interest is jumping. Input: optional limit (1-50, default 10), min_oi_usd (default 1,000,000). Output: as_of, fundingExtremes ranked by |z| (current 1h funding vs the coin's last 7 days), oiMovers24h and oiMovers1h (open-interest % change), each with funding APR and OI USD. Example: ?limit=10 Price: $0.006 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"description": "Rows per list (1-50, default 10)",
"type": [
"number",
"string"
]
},
"min_oi_usd": {
"description": "Skip markets with open interest below this many USD (default 1,000,000)",
"type": [
"number",
"string"
]
}
},
"type": "object"
},
"name": "hl_extremes",
"outputSchema": null
},
{
"description": "Use when an agent judges whether a perp's funding is unusually high or low, or tracks open-interest build-up. Input: coin (e.g. BTC), hours (24-720, default 168). Output: current 1h funding and APR, 24h/7d/30d average APR, current percentile and z-score vs 7d and 30d, share of positive hours, downsampled series, open interest now and change 1h/24h/7d (from our 5-minute snapshots). Example: ?coin=BTC&hours=168 Price: $0.004 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"coin": {
"description": "Hyperliquid perp symbol (BTC, ETH, SOL, HYPE, kPEPE). Not listed → 400 before payment",
"type": "string"
},
"hours": {
"description": "Window of the returned series in hours (24-720, default 168); statistics always cover 7 and 30 days",
"type": [
"number",
"string"
]
}
},
"required": [
"coin"
],
"type": "object"
},
"name": "hl_funding_history",
"outputSchema": null
},
{
"description": "Use when hunting Hyperliquid funding extremes or carry trades with filters. Ranked by funding, OI, volume, basis, premium or 24h change. Input: optional sort, order, limit (1-50), min_oi_usd, min_volume_usd, funding (positive/negative), min_abs_apr. Output: rows (1h + annualized funding, OI, volume, basis, premium), top/bottom 5. Plain funding list: /v1/crypto/hyperliquid/markets?sort=funding. Example: ?sort=funding&min_abs_apr=20&limit=20 Price: $0.009 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"funding": {
"description": "Funding sign filter (positive = longs pay shorts)",
"type": "string"
},
"limit": {
"description": "Rows returned (1-50, default 20)",
"type": [
"number",
"string"
]
},
"min_abs_apr": {
"description": "Only markets whose |annualized Hyperliquid funding| >= this percent",
"type": [
"number",
"string"
]
},
"min_oi_usd": {
"description": "Only markets with open interest >= this many USD",
"type": [
"number",
"string"
]
},
"min_volume_usd": {
"description": "Only markets with 24h notional volume >= this many USD",
"type": [
"number",
"string"
]
},
"order": {
"description": "desc (highest first, default) or asc",
"type": "string"
},
"sort": {
"description": "Ranking field (default funding = 1h funding rate; arb_spread is retired and sorts by funding)",
"type": "string"
}
},
"type": "object"
},
"name": "hl_funding_screener",
"outputSchema": null
},
{
"description": "Use when an agent sizes leverage on a Hyperliquid perp or checks how close typical positions are to liquidation. Input: coin, optional leverages (e.g. 5,10,20). Output: JSON mark, max leverage, maintenance margin, long/short liquidation price and distance % per leverage, whether the 24 h range exceeds it, 24 h high/low, OI USD, funding APR and crowded side. Estimates, not a live liquidation feed. Example: ?coin=BTC Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"coin": {
"description": "Hyperliquid perp symbol (BTC, ETH, kPEPE) or HIP-3 dex:COIN (xyz:TSLA). Not listed or delisted: 400 before payment (not charged)",
"type": "string"
},
"leverages": {
"description": "Comma-separated leverages 1-100 (default 2,3,5,10,20,25,40,50 up to the coin's max)",
"type": "string"
}
},
"required": [
"coin"
],
"type": "object"
},
"name": "hl_liquidations",
"outputSchema": null
},
{
"description": "Use when an agent lists what trades on Hyperliquid or ranks every perp by funding rate. Input: optional dex (main, xyz, flx...), sort (oi, volume, leverage, name, funding, funding_neg, funding_abs; funding sorts default to dex=main), limit (1-200). Output: JSON without dex: core and HIP-3 totals and every dex; with dex: each market's funding (hourly % and APR), mark, OI, volume, 24 h change, max leverage, OI cap use. Example: ?sort=funding&limit=20 Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"dex": {
"description": "HIP-3 dex name (xyz, flx, vntl, km...) or main for core perps; omit for the dex overview. Unknown dex: 400 before payment",
"type": "string"
},
"limit": {
"description": "Markets returned with dex (1-200, default 50)",
"type": [
"number",
"string"
]
},
"sort": {
"description": "Market order (default oi). funding = highest funding first, funding_neg = most negative, funding_abs = largest |funding|; funding sorts use dex=main when dex is omitted",
"type": "string"
}
},
"type": "object"
},
"name": "hl_markets",
"outputSchema": null
},
{
"description": "Use when an agent sizes a Hyperliquid market order or compares liquidity. Input: coin (perp or HIP-3 xyz:TSLA), optional sizes_usd (up to 5, default 1000,10000,100000), levels (0-20). Output: JSON best bid/ask, spread bps, depth USD within 0.1/0.5/1/2%, imbalance, per size buy/sell average fill, worst price and slippage bps vs mid, top levels. Cached 3 s. Example: ?coin=BTC&sizes_usd=1000,10000 Price: $0.0036 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"coin": {
"description": "Hyperliquid perp symbol (BTC, ETH, kPEPE) or HIP-3 dex:COIN (xyz:TSLA). Not listed or delisted: 400 before payment (not charged)",
"type": "string"
},
"levels": {
"description": "Book levels per side to return (0-20, default 10)",
"type": [
"number",
"string"
]
},
"sizes_usd": {
"description": "1-5 comma-separated order notionals in USD, 10 to 50,000,000 (default 1000,10000,100000)",
"type": "string"
}
},
"required": [
"coin"
],
"type": "object"
},
"name": "hl_orderbook",
"outputSchema": null
},
{
"description": "Hyperliquid funding for one perpetual futures market: current and predicted funding rate, open interest and basis. Use when an agent monitors a perp position or funding carry. Input: coin (e.g. BTC, kPEPE). Output: JSON as_of, cache_age_s, 1h + annualized funding, OI coin/USD, mark/oracle/mid, basis %, premium, 24h volume and change, HL predicted funding, next funding time (cross-venue: /v1/crypto/perp/funding). Unknown coin: 400, not charged. Example: ?coin=BTC Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"coin": {
"description": "Hyperliquid perp symbol, case-insensitive (BTC, ETH, SOL, HYPE, kPEPE). Not listed or delisted → 400 before payment (not charged)",
"type": "string"
}
},
"required": [
"coin"
],
"type": "object"
},
"name": "hl_perp_metrics",
"outputSchema": null
},
{
"description": "Use when an agent checks a Hyperliquid account: its own risk, a whale or a copy-trade target. Input: address (0x...), optional orders (0-50). Output: JSON account value, positions with leverage, PnL, liquidation price and distance, cross margin ratio, riskLevel, net exposure, spot balances, open orders, last-24h fills and realized PnL. Cached 10 s. Example: ?address=0x5b5d51203a0f9079f8aeb098a6523a13f298c060 Price: $0.005 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "Hyperliquid account (EVM) address. Malformed: 400 before payment (not charged)",
"type": "string"
},
"orders": {
"description": "Largest open orders to list (0-50, default 10); the count and total are always returned",
"type": [
"number",
"string"
]
}
},
"required": [
"address"
],
"type": "object"
},
"name": "hl_wallet",
"outputSchema": null
},
{
"description": "Use when an agent needs a quick, cited fact sheet on a place, organization, thing or concept. Input: q (topic or title), optional lang (Wikipedia code, default en). Output: JSON title, description, extract, coordinates, thumbnail, page URL, Wikidata facts (instance of, inception, country, official website), CC BY-SA attribution. Best title match if not exact. Example: ?q=Seoul&lang=en Price: $0.005 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"lang": {
"description": "Wikipedia language code (default en; e.g. ko, ja, de, zh, simple)",
"type": "string"
},
"q": {
"description": "Topic or article title",
"type": "string"
}
},
"required": [
"q"
],
"type": "object"
},
"name": "knowledge_wiki",
"outputSchema": null
},
{
"description": "Use when an agent must normalize or translate a South Korean address (shipping, checkout, KYC forms). Input: q (Korean address or part of one, e.g. road name + number or neighborhood + lot number), optional limit (1-5). Output: JSON matches with official road-name and lot-number addresses in Korean and English, postal code, building name, admin and road codes. Data: Ministry of the Interior road-name address API. Example: ?q=테헤란로 152 Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"description": "Matches returned (default 3)",
"type": [
"number",
"string"
]
},
"q": {
"description": "Korean address or part of it (2+ chars; at most 40 Korean characters; no SQL words or % = > < [ ]); bad input → 400, not charged",
"type": "string"
}
},
"required": [
"q"
],
"type": "object"
},
"name": "kr_address",
"outputSchema": null
},
{
"description": "Use when you need actual apartment sale prices in a South Korean district for a month (property research, valuation, comps). Data: MOLIT (Korea land ministry) reported deals since 2006, updated daily. Input: region (5-digit LAWD_CD, e.g. 11680 Gangnam-gu), month (YYYYMM). Output: JSON trades with contract date, complex (Korean + romanized), area m2, floor, build year, price in KRW and USD, price per m2, deal type, cancelled flag. Example: ?region=11680&month=202609 Price: $0.0045 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"month": {
"description": "Contract month YYYYMM, 200601 to the current month (KST)",
"type": "string"
},
"region": {
"description": "5-digit 시군구 code (LAWD_CD), e.g. 11680 = Seoul Gangnam-gu, 11110 = Jongno-gu, 41135 = Seongnam Bundang-gu. Unknown codes → 400 (not charged).",
"type": "string"
}
},
"required": [
"region",
"month"
],
"type": "object"
},
"name": "kr_apartment_trades",
"outputSchema": null
},
{
"description": "Use when you need a quick housing-market snapshot for a South Korean district-month instead of raw trades. Data: MOLIT reported apartment sales, cancelled deals excluded. Input: region (5-digit LAWD_CD, e.g. 11680), month (YYYYMM). Output: JSON count, median/average/min/max price and price per m2 and per pyeong in KRW and USD, breakdown by size class, top complexes by volume. Example: ?region=11680&month=202609 Price: $0.0045 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"month": {
"description": "Contract month YYYYMM, 200601 to the current month (KST)",
"type": "string"
},
"region": {
"description": "5-digit 시군구 code (LAWD_CD), e.g. 11680 = Seoul Gangnam-gu. Unknown codes → 400 (not charged).",
"type": "string"
}
},
"required": [
"region",
"month"
],
"type": "object"
},
"name": "kr_apartment_trades_summary",
"outputSchema": null
},
{
"description": "Use when you need official Bank of Korea statistics (base rate, money supply, key indicators) as a time series. Input: stat (ECOS table code, e.g. 722Y001), cycle (A/S/Q/M/SM/D), start, end (period format of cycle), optional item (e.g. 0101000). Output: JSON series with English labels, units, observations [{period,value}] (max 1,000 rows) and source attribution. Only BOK-authored tables are served. Example: ?stat=722Y001&cycle=M&start=202401&end=202412&item=0101000 Price: $0.0045 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"cycle": {
"description": "A annual, S semi-annual, Q quarterly, M monthly, SM semi-monthly, D daily",
"type": "string"
},
"end": {
"description": "End period, same format as start",
"type": "string"
},
"item": {
"description": "Item code 1 (e.g. 0101000). Optional item2..item4 also accepted.",
"type": "string"
},
"start": {
"description": "Start period in ECOS format (A: YYYY, Q: YYYYQn, M: YYYYMM, D: YYYYMMDD)",
"type": "string"
},
"stat": {
"description": "ECOS statistic table code, e.g. 722Y001 (base rate). Non-BOK tables → 403 (not charged).",
"type": "string"
}
},
"required": [
"stat",
"cycle",
"start",
"end"
],
"type": "object"
},
"name": "kr_bok_ecos_series",
"outputSchema": null
},
{
"description": "Use when an agent must check that a South Korean business is still operating before paying, contracting or onboarding it (KYB, invoice checks). Input: b_no (1-20 business registration numbers, comma-separated, hyphens ok). Output: JSON per number: status (active, suspended, closed, unregistered), VAT taxpayer type, closure date, tax-type change and e-invoice dates, companyId. Data: National Tax Service, synced every 30 min. Example: ?b_no=1248100998 Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"b_no": {
"description": "Business registration numbers (사업자등록번호), 10 digits each, comma-separated (max 20); invalid check digit → 400, not charged",
"type": "string"
}
},
"required": [
"b_no"
],
"type": "object"
},
"name": "kr_business_status",
"outputSchema": null
},
{
"description": "Use when an agent needs a South Korean company's government contract wins for sales, credit or competitor research. Input: id (companyId) or business_number; optional from/to (YYYY-MM-DD, max 366 days, default last 12 months), category (goods,works,services,foreign), min_amount, limit, offset. Output: JSON summary (award count, total and largest KRW, top agencies) and awards with title, agency, amount, date. Data: KONEPS. Example: ?id=kr-dart-00126380 Price: $0.009 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"business_number": {
"description": "Business registration number; give id or business_number",
"type": "string"
},
"category": {
"description": "Comma list of goods, works, services, foreign (default all)",
"type": "string"
},
"from": {
"description": "Bid opening date from (default: 365 days before to)",
"type": "string"
},
"id": {
"description": "companyId from /v1/kr/company/resolve; give id or business_number",
"type": "string"
},
"limit": {
"description": "Awards per page (default 50)",
"type": [
"number",
"string"
]
},
"min_amount": {
"description": "Only awards of at least this many KRW",
"type": [
"number",
"string"
]
},
"offset": {
"description": "Paging offset (from page.nextOffset)",
"type": [
"number",
"string"
]
},
"to": {
"description": "Bid opening date to (default: today)",
"type": "string"
}
},
"type": "object"
},
"name": "kr_company_procurement",
"outputSchema": null
},
{
"description": "Use when an agent needs a normalized profile of a South Korean company for KYB, research or sales. Input: id (companyId from /v1/kr/company/resolve). Output: JSON profile: names, business/corporate/DART/stock ids, market, KSIC code, founding date, fiscal year end, address, homepage, KONEPS supplier registration. No CEO names. DART data is a weekly snapshot of KRX-listed companies (asOf in response). Data: OpenDART, KONEPS. Example: ?id=kr-dart-00126380 Price: $0.0045 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"id": {
"description": "companyId from /v1/kr/company/resolve",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "kr_company_profile",
"outputSchema": null
},
{
"description": "Use when an agent needs an English due-diligence brief on a South Korean company. Input: business_number, dart_corp_code, stock_code or q (exact name); format=json|markdown; news=true|false. Output: JSON summary, business overview, annual financials (revenue, profit, debt, YoY), major shareholders, procurement, DART events (90 d), risk, sanctions, data gaps, sources. AI-written; not advice. Example: ?stock_code=005930 (output example is illustrative) Price: $0.50 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"business_number": {
"description": "Business registration number (사업자등록번호), 10 digits",
"type": "string"
},
"dart_corp_code": {
"description": "OpenDART corp_code (8 digits)",
"type": "string"
},
"format": {
"description": "markdown adds a readable English Markdown rendering of the same report",
"type": "string"
},
"news": {
"description": "Include up to 5 recent third-party news headlines (default true)",
"type": "string"
},
"q": {
"description": "Company name (Korean or English), matched exactly after removing legal-form words",
"type": "string"
},
"stock_code": {
"description": "KRX stock code",
"type": "string"
}
},
"type": "object"
},
"name": "kr_company_report",
"outputSchema": null
},
{
"description": "Use when an agent must identify a South Korean company before looking up its profile or public-procurement record. Input: one of business_number (10 digits), dart_corp_code, stock_code (KRX, e.g. 005930) or q (company name, exact match ignoring 주식회사/(주)/spacing); first wins. Output: JSON companies with stable companyId, Korean and English names, stock code, DART code, match type, ambiguous flag. Data: OpenDART, KONEPS. Example: ?stock_code=005930 Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"business_number": {
"description": "Business registration number (사업자등록번호), 10 digits",
"type": "string"
},
"dart_corp_code": {
"description": "OpenDART corp_code (8 digits)",
"type": "string"
},
"q": {
"description": "Company name (Korean or English), matched exactly after removing legal-form words",
"type": "string"
},
"stock_code": {
"description": "KRX stock code",
"type": "string"
}
},
"type": "object"
},
"name": "kr_company_resolve",
"outputSchema": null
},
{
"description": "Use when an agent needs a Korean corporate disclosure in English. Input: rcept_no (14-digit DART receipt number from /v1/kr/filings). Output: JSON with headline, what_happened, key_figures (amounts, ratios, share counts with units), parties, key_dates, why_it_matters, confidence, original Korean title and DART link. Machine-generated paraphrase, not the official text. Unknown rcept_no or model outage is refused before payment. Example: ?rcept_no=20261030801383 Price: $0.02 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"rcept_no": {
"description": "DART receipt number (14 digits)",
"type": "string"
}
},
"required": [
"rcept_no"
],
"type": "object"
},
"name": "kr_filing_summary",
"outputSchema": null
},
{
"description": "Use when an agent needs recent material disclosures of a South Korean listed company (rights offerings, CBs, buybacks, M&A, litigation, earnings, periodic reports). Input: corp (DART corp_code, KRX stock code or kr-dart- id) or q (exact name), optional days (1-365, default 30); or date (YYYY-MM-DD, KST). Output: JSON list with rceptNo, date, Korean title, English type label, DART link. Summaries: /v1/kr/filings/summary. Example: ?corp=005930&days=90 Price: $0.0045 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"corp": {
"description": "DART corp_code (8 digits), KRX stock code (6 characters) or kr-dart-<corp_code>",
"type": "string"
},
"date": {
"description": "Receipt date (KST); with corp, only that day (inside the days window). No filings that day/window → count 0, not an error",
"type": "string"
},
"days": {
"description": "Look-back window for corp/q (default 30)",
"type": [
"number",
"string"
]
},
"limit": {
"description": "Max filings returned (default 20)",
"type": [
"number",
"string"
]
},
"q": {
"description": "Company name (Korean or English), matched exactly after removing legal-form words",
"type": "string"
}
},
"type": "object"
},
"name": "kr_filings",
"outputSchema": null
},
{
"description": "Use when you need the official text of a South Korean statute, decree or rule, or one article of it. Statutes only: no court decisions or personal data. Input: q (statute name in Korean, e.g. 근로기준법) or mst (law serial no.), optional article (e.g. 2), limit (articles, 1-100, default 30). Output: JSON law metadata (ministry, effective date), articles [{label,title,text}] in original Korean, official URL, attribution. Example: ?q=근로기준법&article=2 Price: $0.0045 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"article": {
"description": "Single article number, e.g. 2 or 제2조",
"type": "string"
},
"limit": {
"description": "Max articles when no article is given (default 30)",
"type": [
"number",
"string"
]
},
"mst": {
"description": "법령일련번호 (law serial number) from a previous answer",
"type": "string"
},
"q": {
"description": "Statute name in Korean (exact name preferred), e.g. 근로기준법. Required unless mst is given.",
"type": "string"
}
},
"type": "object"
},
"name": "kr_law",
"outputSchema": null
},
{
"description": "Use when an agent tracks South Korean government policy, regulation or draft legislation in English. Input: optional q (keyword, Korean or English), date (YYYY-MM-DD KST), limit (1-20, default 5). Output: JSON items with Korean title, official link, published time and English brief {title_en, summary_en, agency_en, category, key_points}. Machine translation; check the official page. Example: ?q=AI&limit=5 Price: $0.0045 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"date": {
"description": "Only items published that KST day",
"type": "string"
},
"limit": {
"description": "Max items (default 5)",
"type": [
"number",
"string"
]
},
"q": {
"description": "Keyword filter (title/summary, Korean or English)",
"type": "string"
}
},
"type": "object"
},
"name": "kr_policy_latest",
"outputSchema": null
},
{
"description": "Use when you need South Korea's official public holidays for a year (business-day calculation, scheduling, settlement and payroll calendars). Data: KASI (Korea Astronomy and Space Science Institute) special-day register, incl. substitute and temporary holidays once promulgated. Input: year (YYYY, 2004-2100). Output: JSON list with date, weekday, Korean and English name, isPublicHoliday, kind. Example: ?year=2026 Price: $0.0027 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"year": {
"description": "Year YYYY (2004–2100)",
"type": [
"number",
"string"
]
}
},
"required": [
"year"
],
"type": "object"
},
"name": "kr_public_holidays",
"outputSchema": null
},
{
"description": "Use when an agent must vet a South Korean supplier or counterparty before paying, contracting or onboarding it. Input: one of business_number, dart_corp_code, stock_code or q (exact company name). Output: JSON summary (riskLevel, riskFlags such as closed/suspended or sanctions match, per-section status) plus NTS status, DART profile, 12-month KONEPS award summary and OFAC/EU/UK screening of the English name. Not a legal determination. Example: ?stock_code=005930 Price: $0.015 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"business_number": {
"description": "Business registration number (사업자등록번호), 10 digits",
"type": "string"
},
"dart_corp_code": {
"description": "OpenDART corp_code (8 digits)",
"type": "string"
},
"q": {
"description": "Company name (Korean or English), matched exactly after removing legal-form words",
"type": "string"
},
"stock_code": {
"description": "KRX stock code",
"type": "string"
}
},
"type": "object"
},
"name": "kr_supplier_check",
"outputSchema": null
},
{
"description": "Use when you need South Korea's earliest export read: the Korea Customs 10-day provisional release (days 1-10, 1-20, full month; out on the 11th, 21st and 1st). Input: optional month (YYYYMM) and period (10, 20, full); default latest. Output: JSON exports in USD with YoY %, latest 10-day increment, 10 key items (semiconductors, cars, ships...) and 10 markets (China, US, EU, Vietnam...) with YoY and share, next release date. Example: ?month=202609 Price: $0.0045 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"month": {
"description": "Release month YYYYMM (default: latest release; data from 2024-09)",
"type": "string"
},
"period": {
"description": "10 (days 1-10), 20 (days 1-20) or full; requires month. Default: latest available for the month",
"type": "string"
}
},
"type": "object"
},
"name": "kr_trade_exports_10day",
"outputSchema": null
},
{
"description": "Use when you need South Korea's monthly trade for a product by HS code (e.g. 8542 chips, 870323 cars, 2710 petroleum). Data: Korea Customs Service, finalized monthly. Input: hs (2-10 digit prefix), optional month (YYYYMM, default latest), limit (1-100), sort (exports, imports, balance, total). Output: JSON totals (exports FOB, imports CIF, balance in USD, kg) with YoY % and 10-digit HSK lines with English HS descriptions and YoY. Example: ?hs=8542&month=202608 Price: $0.0045 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"hs": {
"description": "HS code prefix, 2-10 digits (e.g. 8542 integrated circuits, 870323 passenger cars)",
"type": "string"
},
"limit": {
"description": "Max 10-digit lines returned (1-100, default 20)",
"type": [
"number",
"string"
]
},
"month": {
"description": "Month YYYYMM (default: latest finalized month)",
"type": "string"
},
"sort": {
"description": "Line order (default exports)",
"type": "string"
}
},
"required": [
"hs"
],
"type": "object"
},
"name": "kr_trade_hs",
"outputSchema": null
},
{
"description": "Use when you need a one-call read on South Korea's export cycle for macro, FX or chip-sector analysis. Data: Korea Customs 10-day and monthly releases. Input: none. Output: JSON headline (latest exports and YoY, semiconductor share, strongest/weakest item and market, 3-month average YoY, momentum), latest release by item and market, 12 monthly export totals with YoY, and HS 8542 integrated-circuit trade for the latest month. Example: /v1/trade/pulse Price: $0.0045 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "kr_trade_pulse",
"outputSchema": null
},
{
"description": "Use when you need the official weather forecast for a point in South Korea for the next ~3-5 days. Data: KMA (Korea Meteorological Administration) village forecast on a 5 km grid, issued 8 times a day. Input: lat, lon (WGS84 decimal; Korea only). Output: JSON hourly then 3-hourly temperature C, sky, precipitation type and probability %, rain and snow amounts, humidity %, wind; plus daily min/max. Example: ?lat=37.5665&lon=126.978 Price: $0.0045 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"lat": {
"description": "Latitude, WGS84 decimal degrees (KMA domain ≈ 32–44; outside → 400, not charged)",
"type": [
"number",
"string"
]
},
"lon": {
"description": "Longitude, WGS84 decimal degrees (KMA domain ≈ 123–133)",
"type": [
"number",
"string"
]
}
},
"required": [
"lat",
"lon"
],
"type": "object"
},
"name": "kr_weather_forecast",
"outputSchema": null
},
{
"description": "Use when an agent must vet a company or counterparty before paying, onboarding or invoicing. Input: name, optional country (ISO2), lei, vat (EU, with prefix). Output: JSON summary (sanctions hits, LEI found/status, VAT valid), sanctions matches across OFAC SDN, EU and UK lists, GLEIF entity record with parents, VIES VAT result; a down VIES/GLEIF marks only that part. Not a legal determination. Example: ?name=Siemens+AG&lei=W38RGI023J3WT1HWRP32&vat=DE129273398 Price: $0.02 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"country": {
"description": "ISO 3166-1 alpha-2 country of the legal address (narrows the LEI search)",
"type": "string"
},
"lei": {
"description": "Legal Entity Identifier, if known (exact LEI lookup instead of name search)",
"type": "string"
},
"name": {
"description": "Company or person name in Latin script",
"type": "string"
},
"vat": {
"description": "EU VAT number with country prefix (Greece = EL), validated in VIES",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "kyb_check",
"outputSchema": null
},
{
"description": "Use when an agent must price an LLM call or pick the cheapest model. Input: model (up to 5, comma list) plus optional input_tokens, output_tokens, requests; or no model plus mode, provider, min_context, capabilities (vision, function_calling...). Output: JSON USD per 1M input/output tokens, cached/batch prices, context window, provider, capabilities, cost estimate or cheapest ranking, as_of + source commit. Example: ?model=gpt-4o&input_tokens=12000&output_tokens=800 Price: $0.004 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"capabilities": {
"description": "Comma-separated required capabilities: vision, function_calling, reasoning, prompt_caching, response_schema, pdf_input, audio_input, audio_output, web_search, computer_use, video_input",
"type": "string"
},
"include_deprecated": {
"description": "Include models past their deprecation date in the cheapest search (default false)",
"type": "string"
},
"input_tokens": {
"description": "Input (prompt) tokens per request, for the cost estimate and ranking",
"type": [
"number",
"string"
]
},
"limit": {
"description": "Max rows per model or in the ranking (default 10)",
"type": [
"number",
"string"
]
},
"min_context": {
"description": "Minimum context window (max input tokens)",
"type": [
"number",
"string"
]
},
"mode": {
"description": "Model type for the cheapest search (default chat; chat includes responses-API models). Ignored when model is given",
"type": "string"
},
"model": {
"description": "Model name(s), up to 5 comma-separated (gpt-4o, claude-sonnet-4-5, gemini/gemini-2.5-flash). Also lists the same model at other providers. Omit to rank the cheapest models. Unknown → 400 with suggestions (not charged)",
"type": "string"
},
"output_tokens": {
"description": "Output (completion) tokens per request",
"type": [
"number",
"string"
]
},
"provider": {
"description": "LiteLLM provider id filter: openai, anthropic, gemini, vertex_ai, bedrock, azure, groq, deepseek, mistral...",
"type": "string"
},
"requests": {
"description": "Number of requests to multiply the estimate by (default 1)",
"type": [
"number",
"string"
]
}
},
"type": "object"
},
"name": "llm_model_prices",
"outputSchema": null
},
{
"description": "Use when an agent must know when the next US data release or Fed decision lands. Input: optional indicators (cpi, jobs, ppi, jolts, eci, import_prices, gdp, pce, trade, retail_sales, durable_goods, housing_starts, new_home_sales, fomc), days (1-120, default 30). Output: events by time (UTC, ET), period, FOMC projections flag, prior CPI/jobs/PPI values, source links. Example: ?indicators=cpi,jobs,fomc Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"days": {
"description": "Look-ahead window in days (default 30)",
"type": [
"number",
"string"
]
},
"indicators": {
"description": "Comma list of cpi, jobs, ppi, jolts, eci, import_prices, gdp, pce, trade, retail_sales, durable_goods, housing_starts, new_home_sales, fomc (default all); unknown → 400 before payment",
"type": "string"
}
},
"type": "object"
},
"name": "macro_calendar",
"outputSchema": null
},
{
"description": "Use when an agent needs the official US Treasury par yield curve for a day or a recent stretch. Input: optional date (YYYY-MM-DD, default latest), days (1-366 history ending at date). Output: JSON yields per tenor (1m to 30y, percent), 2s10s and 3m10y spreads in bp, inversion flags, change over the range, history. Weekend or holiday dates fall back to the prior business day. Example: ?days=5 Price: $0.003 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"date": {
"description": "Curve date YYYY-MM-DD (default latest published; no curve that day → previous business day)",
"type": "string"
},
"days": {
"description": "Business days of history ending at date (default 1)",
"type": [
"number",
"string"
]
}
},
"type": "object"
},
"name": "macro_treasury_curve",
"outputSchema": null
},
{
"description": "Use when an agent needs what is happening on a topic right now, in English, including Korean and Asian news. Input: topic, optional time_range (day, week default, month, year), max (1-10 headlines, default 10). Output: JSON overview, clusters [{headline, summary, sources}] with duplicates merged, and sources (title, url, outlet, publishedAt). Headlines and links only. Failures not charged. Example: ?topic=korea+semiconductor+exports Price: $0.007 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"max": {
"description": "Headlines considered (default 10)",
"type": [
"number",
"string"
]
},
"time_range": {
"description": "Window (default week)",
"type": "string"
},
"topic": {
"description": "News topic (any language)",
"type": "string"
}
},
"required": [
"topic"
],
"type": "object"
},
"name": "news_brief",
"outputSchema": null
},
{
"description": "Use when an agent must send funds to an ENS name or label a wallet. Input: name (e.g. ens.eth, ENSIP-15 normalized) or address. Output: JSON resolve: address, resolver, avatar/url/description/twitter/github records, contenthash (name+address: matchesExpected); reverse: primary name only if forward-verified. Ethereum mainnet registry; wildcard/offchain resolvers not followed. Example: ?name=ens.eth Price: $0.005 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "Alone: reverse lookup (primary name). With name: also check the name resolves to this address (matchesExpected)",
"type": "string"
},
"name": {
"description": "ENS name to resolve (normalized with ENSIP-15; invalid → 400 before payment, not charged)",
"type": "string"
}
},
"type": "object"
},
"name": "onchain_ens",
"outputSchema": null
},
{
"description": "Use when an agent needs a token's USD price without a third-party price feed. Input: tokens (up to 10, base:0x… or sol:<mint>). Output: per token priceUsd, confidence, the pool used (Uniswap v3 / Aerodrome on Base, Orca Whirlpool on Solana; fee tier, depth in USD), path (direct USDC or via WETH/SOL), warnings; no price below $1,000 depth. Spot, not TWAP. Example: ?tokens=base:0x940181a94A35A4569E4529A3CDfB74e38FD98631 Price: $0.003 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"tokens": {
"description": "Comma-separated chain:address list, max 10 (base:0x… ERC-20, sol:<mint> base58), or tickers BTC, ETH, SOL, USDC, AERO, DEGEN, BONK, JUP. Bad input → 400 before payment (not charged)",
"type": "string"
}
},
"required": [
"tokens"
],
"type": "object"
},
"name": "onchain_prices",
"outputSchema": null
},
{
"description": "Use when a trading agent needs many token prices at once plus the price impact of a buy. Input: tokens (≤25, base:0x… or sol:<mint>, ≤10 Solana), amount_usd (default 1000) or amounts (up to 5 USD sizes). Output: per token priceUsd, confidence, pool, depth and buy estimates: tokensOut, effectivePriceUsd, priceImpactPct (Uniswap v3 QuoterV2 / Aerodrome, Orca CLMM). Example: ?tokens=base:0x4200000000000000000000000000000000000006&amounts=1000,100000 Price: $0.008 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"amount_usd": {
"description": "Size of the buy to estimate, in USD (default 1000)",
"type": [
"number",
"string"
]
},
"amounts": {
"description": "Up to 5 USD buy sizes for a price-impact curve (instead of amount_usd); each price row gets trades[]",
"type": "string"
},
"tokens": {
"description": "Comma-separated chain:address list, max 25 (≤10 Solana). Bad input → 400 before payment (not charged)",
"type": "string"
}
},
"required": [
"tokens"
],
"type": "object"
},
"name": "onchain_prices_batch",
"outputSchema": null
},
{
"description": "Use when an agent must check a dependency before installing or upgrading: is this exact package version vulnerable? Input: package, ecosystem (npm, PyPI, Go, Maven, crates.io, NuGet, RubyGems, Packagist...), version. Output: JSON vulnerable yes/no, counts by severity, advisories (GHSA/CVE id, summary, severity, CVSS, CWE, fixed versions, links). Data: OSV.dev. Example: ?package=lodash&ecosystem=npm&version=4.17.15 Price: $0.003 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"ecosystem": {
"description": "Package ecosystem (case-insensitive; pip/python, cargo/rust, composer, gem also accepted)",
"type": "string"
},
"package": {
"description": "Package name as in its registry (Go: module path; Maven: group:artifact)",
"type": "string"
},
"version": {
"description": "Exact released version",
"type": "string"
}
},
"required": [
"package",
"ecosystem",
"version"
],
"type": "object"
},
"name": "package_vulnerabilities",
"outputSchema": null
},
{
"description": "Use when an agent must scan a project's dependencies before install, upgrade or merge. Input: packages, up to 20 ecosystem:name@version, comma-separated (npm, pypi, go, cargo/crates.io, maven, nuget...). Output: JSON summary (vulnerable count, critical/high/moderate/low), per package vulnerable yes/no, counts, top advisories with CVE, severity, fixed versions, osv.dev links. Data: OSV.dev, CC BY 4.0. Example: ?packages=npm:[email protected],pypi:[email protected] Price: $0.0045 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"ecosystem": {
"description": "Default ecosystem for items written as name@version",
"type": "string"
},
"packages": {
"description": "1-20 packages as ecosystem:name@version, comma-separated (npm:[email protected], pypi:[email protected], go:golang.org/x/[email protected], cargo:[email protected])",
"type": "string"
}
},
"required": [
"packages"
],
"type": "object"
},
"name": "package_vulnerabilities_batch",
"outputSchema": null
},
{
"description": "Use when an agent checks whether a wrapped or backed token's reported reserves cover its supply. Input: optional asset (WBTC, cbBTC, TUSD, stETH, eETH). Output: JSON per asset Chainlink Proof of Reserve value, totalSupply by chain, ratio, reserves minus supply, below-supply flag, supply coverage (full/partial), feed age vs heartbeat, stale flag, feed page. Reported reserves, not an audit. Example: ?asset=WBTC Price: $0.003 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"asset": {
"description": "Only this asset (default all)",
"type": "string"
}
},
"type": "object"
},
"name": "proof_of_reserve",
"outputSchema": null
},
{
"description": "Use when an agent must hand over a document as a PDF (report, invoice, summary, receipt). Input: GET ?url= for a public page, or POST JSON {html | markdown | url, format A4|Letter, landscape, margin_mm}. Markdown gets a clean stylesheet with Korean fonts. Output: JSON fileBase64 (decode to the PDF), bytes, page settings. Headless Chrome on Cloudflare. Bad input or daily cap refused before payment. Example: ?url=https://example.com/ Price: $0.01 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"format": {
"description": "Page size (default A4)",
"type": "string"
},
"html": {
"description": "HTML to render (MCP argument or POST JSON; alternative to url/markdown)",
"type": "string"
},
"landscape": {
"description": "1 = landscape",
"type": "string"
},
"margin_mm": {
"description": "Page margin in mm (default 12)",
"type": [
"number",
"string"
]
},
"markdown": {
"description": "Markdown to render (MCP argument or POST JSON; alternative to url/html)",
"type": "string"
},
"url": {
"description": "Public http(s) page to render (GET). For html/markdown use POST JSON.",
"type": "string"
}
},
"type": "object"
},
"name": "render_pdf",
"outputSchema": null
},
{
"description": "Use when an agent must turn its own HTML or Markdown into an image (social card, chart, table snapshot, preview) or capture a page as PNG. Input: GET ?url=, or POST JSON {html | markdown | url, width 320-1920, full_page}. Korean fonts included. Output: JSON fileBase64 (decode to the PNG), bytes, viewport. Bad input or daily cap refused before payment. Example: ?url=https://example.com/ Price: $0.01 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"full_page": {
"description": "1 = whole page (default), 0 = first screen only",
"type": "string"
},
"html": {
"description": "HTML to render (MCP argument or POST JSON; alternative to url/markdown)",
"type": "string"
},
"markdown": {
"description": "Markdown to render (MCP argument or POST JSON; alternative to url/html)",
"type": "string"
},
"url": {
"description": "Public http(s) page to render (GET). For html/markdown use POST JSON.",
"type": "string"
},
"width": {
"description": "Viewport width in px (default 1024)",
"type": [
"number",
"string"
]
}
},
"type": "object"
},
"name": "render_png",
"outputSchema": null
},
{
"description": "Use when an agent integrates tokenized equities on Robinhood Chain (4663). Input: optional symbols (<=20), address, limit (1-100), feedOnly. Output: JSON per token: on-chain uid/symbol checked against the public registry, uiMultiplier vs registry, pending multiplier, paused, supply, Chainlink feed age/stale/lag, reference total-return value; US 24/5 session state. Reference signals, not market data or advice. Example: ?symbols=AAPL,TSLA Price: $0.003 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "One token contract; not in the registry → 404 (not charged)",
"type": "string"
},
"feedOnly": {
"description": "true = only tokens with a Chainlink feed",
"type": "string"
},
"limit": {
"description": "Tokens returned (1-100, default 25)",
"type": [
"number",
"string"
]
},
"symbols": {
"description": "Comma list of up to 20 tickers (AAPL,TSLA). Default: all, alphabetical",
"type": "string"
}
},
"type": "object"
},
"name": "rh_stock_tokens",
"outputSchema": null
},
{
"description": "Use when an agent tracks tokenized US Treasury / money market funds. Input: optional token (BUIDL, USDY, OUSG, USTB, USYC, BENJI), chain (all, ethereum, base). Output: JSON per token totalSupply, NAV per share from Chainlink or the issuer's onchain oracle ($1 for constant-NAV funds, null if none), AUM, mint/burn flows 24 h / 7 d in units and USD, totals. Ethereum + Base issuance only. Cached 10 min. Example: ?token=BUIDL Price: $0.005 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "Chain filter (default all)",
"type": "string"
},
"token": {
"description": "Only this fund token (default all)",
"type": "string"
}
},
"type": "object"
},
"name": "rwa_treasuries",
"outputSchema": null
},
{
"description": "Use when an agent must check a crypto wallet against the digital currency addresses on the U.S. Treasury OFAC SDN list before paying or accepting funds. Input: address (EVM matched on every EVM chain; BTC, TRX, SOL...), optional chain. Output: JSON listed yes/no, SDN entry, programs, listed currency and network, OFAC link, list as-of date, data age. Not a legal determination. Example: ?address=0x098B716B8Aaf21512996dC57EB0615e2383E2f96 Price: $0.0045 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "Crypto address to check (0x… EVM, BTC, TRX, SOL, …)",
"type": "string"
},
"chain": {
"description": "Optional chain (ethereum, base, bitcoin, tron, solana, …): checks the address format and marks listings on that network",
"type": "string"
}
},
"required": [
"address"
],
"type": "object"
},
"name": "sanctions_address",
"outputSchema": null
},
{
"description": "Use when an agent must screen many wallets at once (payouts, counterparty lists) against OFAC SDN wallet addresses. Input: addresses (1-50, comma-separated, mixed chains) or POST JSON {addresses:[...]}. Output: per address listed yes/no, detected chains, SDN entity, programs; summary counts; list date. Unknown formats refused before payment. Not a legal determination. Example: ?addresses=0x098B716B8Aaf21512996dC57EB0615e2383E2f96,TNiq9AXBp9EjUqhDhrwrfvAA8U3GUQZH81 Price: $0.01 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"addresses": {
"description": "1-50 crypto addresses, comma-separated (0x… EVM, BTC, TRX, SOL, LTC, XMR, …)",
"type": "string"
}
},
"required": [
"addresses"
],
"type": "object"
},
"name": "sanctions_address_batch",
"outputSchema": null
},
{
"description": "Use when an agent must check a person, company, vessel or aircraft against the U.S. Treasury OFAC SDN list before paying, onboarding or shipping. Input: name (fuzzy, aliases included), optional type, min_score, limit. Output: JSON potential matches with score, SDN entry, programs, countries, aliases, OFAC link, list as-of date, data age. Not a legal determination. Example: ?name=Lazarus+Group Price: $0.0045 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"description": "Max matches (default 10)",
"type": [
"number",
"string"
]
},
"lists": {
"description": "Lists to search: ofac (default), eu, uk, comma-separated, or all",
"type": "string"
},
"min_score": {
"description": "Name match threshold 0.6-1 (default 0.85)",
"type": [
"number",
"string"
]
},
"name": {
"description": "Person, company, vessel or aircraft name in Latin script; fuzzy match over SDN names and aliases",
"type": "string"
},
"type": {
"description": "Only match this SDN entry type",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "sanctions_screen",
"outputSchema": null
},
{
"description": "Use when an agent must check a transaction before accepting or relaying funds: screens its direct parties (sender, recipient, contracts, token Transfer parties on Base; accounts and token owners on Solana) against OFAC SDN wallet addresses. Input: tx, network (eip155:8453 default, or solana). Output: verdict, parties, roles, listed yes/no, SDN entity, programs, tx status, list date. Bad formats refused before payment. Not a legal determination. Example: ?tx=0x… Price: $0.009 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"network": {
"description": "Network (default eip155:8453 = Base)",
"type": "string"
},
"tx": {
"description": "Transaction hash (0x…, Base) or signature (base58, Solana)",
"type": "string"
}
},
"required": [
"tx"
],
"type": "object"
},
"name": "sanctions_tx",
"outputSchema": null
},
{
"description": "Use when checking what changed at a place between two dates (construction, deforestation, flooding, crops). Input: lat, lon, radius_m (200-10000), before and after dates (20+ days apart). Output: JSON per date: clearest scene, area cloud %, NDVI mean/median, true color, NDVI and false color PNG URLs; NDVI change and reliability. No scene: 404, not charged. Example: ?lat=37.5665&lon=126.978&before=2026-04-15&after=2026-10-08 Price: $0.018 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"after": {
"description": "Later date YYYY-MM-DD, at least 20 days after before",
"type": "string"
},
"before": {
"description": "Earlier date YYYY-MM-DD (2017-01-01 or later)",
"type": "string"
},
"lat": {
"description": "Latitude, WGS84 decimal degrees",
"type": [
"number",
"string"
]
},
"lon": {
"description": "Longitude, WGS84 decimal degrees",
"type": [
"number",
"string"
]
},
"radius_m": {
"description": "Half-width of the square area in meters (default 2000)",
"type": [
"number",
"string"
]
},
"size": {
"description": "Image width/height in px (default 768)",
"type": [
"number",
"string"
]
},
"window_days": {
"description": "Search ± days around each date (default 15)",
"type": [
"number",
"string"
]
}
},
"required": [
"lat",
"lon",
"before",
"after"
],
"type": "object"
},
"name": "satellite_compare",
"outputSchema": null
},
{
"description": "Use when an agent must see a place from above or check vegetation, water or change. Input: lat, lon, radius_m (200-10000), mode (true_color, false_color, ndvi, ndwi, moisture), date, days back, max_cloud. Picks the clearest Sentinel-2 scene by cloud share inside your area, not the whole tile. Output: JSON PNG URL (+ other modes), scene date, area cloud %, alternatives. No scene: 404, not charged. Example: ?lat=37.5665&lon=126.978 Price: $0.009 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"date": {
"description": "Latest acceptable scene date YYYY-MM-DD (default today; 2017-01-01 or later)",
"type": "string"
},
"days": {
"description": "Look-back window in days before date (default 30)",
"type": [
"number",
"string"
]
},
"lat": {
"description": "Latitude, WGS84 decimal degrees",
"type": [
"number",
"string"
]
},
"lon": {
"description": "Longitude, WGS84 decimal degrees",
"type": [
"number",
"string"
]
},
"max_cloud": {
"description": "Target max cloud % inside the area (default 40); if no scene meets it the clearest is returned with fulfillment=best_available",
"type": [
"number",
"string"
]
},
"mode": {
"description": "Rendering (default true_color); URLs for the other modes are returned too",
"type": "string"
},
"radius_m": {
"description": "Half-width of the square area in meters (default 2000)",
"type": [
"number",
"string"
]
},
"size": {
"description": "Image width/height in px (default 1024)",
"type": [
"number",
"string"
]
}
},
"required": [
"lat",
"lon"
],
"type": "object"
},
"name": "satellite_image",
"outputSchema": null
},
{
"description": "Use when tracking crops, greenery or land change month by month. Input: lat, lon, radius_m (200-10000), months (1-12), optional end date. Output: JSON series per month: clearest scene, area cloud %, NDVI mean/median, status (ok, cloudy, no_scene), plus min/max and first-to-last change. Numbers only, no images. No scene at all: 404, not charged. Example: ?lat=36.35&lon=127.38&months=6 Price: $0.012 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"end": {
"description": "Last date YYYY-MM-DD (default today)",
"type": "string"
},
"lat": {
"description": "Latitude, WGS84 decimal degrees",
"type": [
"number",
"string"
]
},
"lon": {
"description": "Longitude, WGS84 decimal degrees",
"type": [
"number",
"string"
]
},
"months": {
"description": "Number of calendar months ending with the end month (default 6)",
"type": [
"number",
"string"
]
},
"radius_m": {
"description": "Half-width of the square area in meters (default 2000)",
"type": [
"number",
"string"
]
}
},
"required": [
"lat",
"lon"
],
"type": "object"
},
"name": "satellite_trend",
"outputSchema": null
},
{
"description": "Use when an agent must see what an institutional manager (Berkshire, hedge funds, banks) holds and what it bought or sold. Input: cik (or ticker), optional period (quarter end), limit. Output: JSON manager, filing, total value, top holdings with value, shares, put/call and portfolio weight; changes vs the previous 13F-HR: new, added, reduced, exited with share change %. Organisations only. Example: ?cik=1067983&limit=10 Price: $0.004 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"cik": {
"description": "SEC CIK of the 13F filer (e.g. 1067983 Berkshire Hathaway); give cik or ticker",
"type": "string"
},
"limit": {
"description": "Top holdings to return (default 25)",
"type": [
"number",
"string"
]
},
"period": {
"description": "Quarter end (default the latest 13F-HR); unknown period → 404, not charged",
"type": "string"
},
"ticker": {
"description": "Ticker of a listed manager (e.g. BRK-B); give cik or ticker",
"type": "string"
}
},
"type": "object"
},
"name": "sec_13f_holdings",
"outputSchema": null
},
{
"description": "Use when an agent needs a U.S. company's SEC filings, key financials or the latest 8-K events. Input: ticker or cik, optional form, since, limit, items (8-K codes), mode (filings, events, financials). Output: company profile plus filings with sec.gov links; events = newest 8-Ks (no ticker: all EDGAR); financials = revenue, net income, cash flow, FCF, debt, cash, margins, debt/equity, YoY from XBRL. Example: ?ticker=AAPL&mode=financials Price: $0.0027 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"cik": {
"description": "SEC Central Index Key (e.g. 320193); give ticker or cik",
"type": "string"
},
"form": {
"description": "Only these form types, comma-separated (10-K, 10-Q, 8-K, DEF 14A, S-1, 4, 13F-HR…)",
"type": "string"
},
"items": {
"description": "Keep only 8-Ks with these item codes, comma-separated (1.01, 2.02, 5.02, 7.01, 8.01…); other forms unaffected",
"type": "string"
},
"limit": {
"description": "Max filings (default 20)",
"type": [
"number",
"string"
]
},
"mode": {
"description": "filings (default); events: 8-K events (without ticker/cik, the newest 8-Ks across EDGAR); financials: key figures and ratios from XBRL (ticker or cik required)",
"type": "string"
},
"since": {
"description": "Only filings on or after this date (YYYY-MM-DD)",
"type": "string"
},
"ticker": {
"description": "U.S. ticker (AAPL, BRK.B); give ticker or cik",
"type": "string"
}
},
"type": "object"
},
"name": "sec_filings",
"outputSchema": null
},
{
"description": "Use when an agent checks whether a U.S. company's officers, directors or 10% owners are buying or selling its stock. Input: ticker or cik, optional days (1-365, default 90), type (all, open_market, buy, sell), limit (Form 4 filings, 1-40). Output: JSON open-market buy and sell totals, net value, insider counts, 10b5-1 sells, signal (cluster_buying...), each transaction with role, code, shares, price, value, holdings after and filing link. Example: ?ticker=AAPL Price: $0.006 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"cik": {
"description": "Issuer SEC CIK (e.g. 320193); give ticker or cik",
"type": "string"
},
"days": {
"description": "Look-back window in days (default 90)",
"type": [
"number",
"string"
]
},
"limit": {
"description": "Newest Form 4 filings to read in the window (1-40, default 20)",
"type": [
"number",
"string"
]
},
"ticker": {
"description": "U.S. issuer ticker (AAPL, BRK.B); give ticker or cik",
"type": "string"
},
"type": {
"description": "all transactions, open_market (P and S), buy (P) or sell (S)",
"type": "string"
}
},
"type": "object"
},
"name": "sec_insider_trades",
"outputSchema": null
},
{
"description": "Use when an agent, test suite or CI job needs Sepolia gas now: one x402 call, no faucet login or mainnet history. Input: to (recipient address); sends 0.1 SepETH (1 SepETH: /v1/testnet/sepolia-eth/1). Output: JSON txHash (confirmed before settling), explorerUrl, amountEth, from, to. Daily limits (UTC): 5 SepETH per address (both sizes), 20 overall; checked before payment. Test ETH has no monetary value. Example: ?to=0x000000000000000000000000000000000000dEaD Price: $0.05 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"to": {
"description": "Recipient Ethereum address (EIP-55 checksum if mixed case). Bad input, caps reached or out of stock → 4xx/503 before payment (not charged)",
"type": "string"
}
},
"required": [
"to"
],
"type": "object"
},
"name": "sepolia_eth",
"outputSchema": null
},
{
"description": "Use when a contract deploy, test suite or CI job needs more Sepolia gas than a faucet gives: one x402 call, no faucet login or mainnet history. Input: to (recipient address); sends 1 SepETH. Output: JSON txHash (confirmed before settling), explorerUrl, amountEth, from, to. Daily limits (UTC): 5 SepETH per address (both sizes), 20 overall; checked before payment. Test ETH has no monetary value. Example: ?to=0x000000000000000000000000000000000000dEaD Price: $0.50 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"to": {
"description": "Recipient Ethereum address (EIP-55 checksum if mixed case). Bad input, caps reached or out of stock → 4xx/503 before payment (not charged)",
"type": "string"
}
},
"required": [
"to"
],
"type": "object"
},
"name": "sepolia_eth_1",
"outputSchema": null
},
{
"description": "Use when an agent must vet or research a website in one call (lead research, security or SEO check, is this site legit). Input: url or bare domain. Output: JSON page metadata, HTTP status, HTTPS and HTTP-to-HTTPS redirect, server and hosting hints, 7 security headers, robots.txt (sitemaps, AI-crawler rules), llms.txt presence, plus domain DNS, mail provider, SPF/DMARC and RDAP registrar, age and expiry. Example: ?url=stripe.com Price: $0.009 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"url": {
"description": "Site URL or bare domain (https:// assumed); private/internal targets → 400 (not charged)",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "site_profile",
"outputSchema": null
},
{
"description": "Use when an agent watches new Solana meme coins. Input: optional minutes (5-60), limit (1-20). Output: JSON launch counts per 10 min from the pump.fun program, then the newest launches: mint, name/symbol, age, bonding-curve progress %, price and market cap in SOL, mint/freeze authority, holder aggregates (curve %, top-10 ex-curve %, dev %), riskLevel + signals. Aggregates only; no wallet lists. Not advice. Example: ?minutes=60&limit=10 Price: $0.0045 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"description": "Newest launches detailed (1-20, default 10)",
"type": [
"number",
"string"
]
},
"minutes": {
"description": "Look-back window in minutes (5-60, default 60)",
"type": [
"number",
"string"
]
}
},
"type": "object"
},
"name": "sol_meme_launches",
"outputSchema": null
},
{
"description": "Use when an agent needs a Solana token's basics before quoting, transferring or accepting it. Input: mint. Output: JSON slot, program (spl-token or token-2022), decimals, supply raw and decimal, mint and freeze authority, Token-2022 extensions (transfer fee, permanent delegate, transfer hook, default frozen, metadata), known issuer if curated. Not a mint: 422, unknown: 404, not charged. Example: ?mint=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"mint": {
"description": "Token mint address on Solana mainnet (base58, 32 bytes). Bad input → 400, not a mint → 422 (not charged)",
"type": "string"
}
},
"required": [
"mint"
],
"type": "object"
},
"name": "sol_token_info",
"outputSchema": null
},
{
"description": "Solana token risk scan: rug pull, scam token and token safety check. Use when buying, accepting or listing a token. Input: mint. Output: JSON riskLevel + signals w/ evidence: mint authority, freeze authority (can freeze/blacklist holders), permanent delegate, transfer hook/fee, default-frozen, mutable metadata, top-10 share; pump.fun curve %/PumpSwap LP burn, dev %. No sell simulation; not an audit. Example: ?mint=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v Price: $0.009 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"mint": {
"description": "Token mint address on Solana mainnet (base58, 32 bytes). Bad input → 400, not a mint → 422 (not charged)",
"type": "string"
}
},
"required": [
"mint"
],
"type": "object"
},
"name": "sol_token_risk",
"outputSchema": null
},
{
"description": "Use when an agent must confirm a Solana payment or transaction landed: did it succeed, who paid whom, how much of which token. Input: signature. Output: JSON status (success/failed), slot, block time, confirmation status, fee payer, signers, fee, programs, SOL and token balance changes per account (first 25). Unknown signature: 404, not charged. Example: ?signature=5Xg1wCobkM4jAJNHE6t7B1amt4ch5wq5GrxuhQXXgoAkUPUAjVMC9tQFCvp1awUGfrqZY9L9sLdPieJ97DcDjXtC Price: $0.0045 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"signature": {
"description": "Transaction signature on Solana mainnet (base58, 64 bytes). Unknown or not yet confirmed → 404 (not charged)",
"type": "string"
}
},
"required": [
"signature"
],
"type": "object"
},
"name": "sol_tx",
"outputSchema": null
},
{
"description": "Use when an agent needs what a Solana address holds in one call. Input: address. Output: JSON slot, SOL balance, every non-zero token (mint, token account, program, decimals, raw and decimal balance, frozen flag; first 50), counts of token and empty accounts. Chain state only, no prices. Bad input: 400, not charged. Example: ?address=CV8t6fnSsckB3bzJSVRxQjVvTgdB35q11Fu3eaF1nz8u Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "Wallet address on Solana mainnet (base58, 32 bytes). Bad input → 400 (not charged)",
"type": "string"
}
},
"required": [
"address"
],
"type": "object"
},
"name": "sol_wallet_balances",
"outputSchema": null
},
{
"description": "Use when an agent needs recent issuer freezes of USDC, EURC (Ethereum, Base) and USDT (Ethereum), or whether an address is frozen now. Input: optional address, days (1-7, default 1), chain (all, ethereum, base), token. Output: JSON events (token, chain, freeze/unfreeze/destroy_funds, address, amount, block, approx time, tx), counts per token, live frozen status per token for the address. Issuer action, not a sanctions list. Example: ?days=1 Price: $0.003 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "Only events for this address, plus its live frozen status on each token",
"type": "string"
},
"chain": {
"description": "Chain filter (default all)",
"type": "string"
},
"days": {
"description": "Look-back window in days (default 1)",
"type": [
"number",
"string"
]
},
"token": {
"description": "Only this token",
"type": "string"
}
},
"type": "object"
},
"name": "stablecoin_freezes",
"outputSchema": null
},
{
"description": "Use when an agent tracks large stablecoin flows (whale alerts). Input: chain (ethereum, base, arbitrum), optional token (USDC, USDT), min_usd (default 100000), minutes (Ethereum ≤30, Base ≤5, Arbitrum ≤10), limit (default 25). Output: JSON transfers sorted by size with total/returned/truncated, totalUsd (returned rows) and totalUsdAll (window), from/to entity labels + OFAC flags, mint/burn, tx link. Example: ?chain=ethereum&min_usd=1000000 Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "Chain (default ethereum)",
"type": "string"
},
"limit": {
"description": "Max transfers returned (default 25); total/returned/truncated report the rest",
"type": [
"number",
"string"
]
},
"min_usd": {
"description": "Smallest transfer to list (default 100000)",
"type": [
"number",
"string"
]
},
"minutes": {
"description": "Look-back window (default Ethereum 10, Base 2, Arbitrum 5; max 30 / 5 / 10). Out of range → 400 before payment",
"type": [
"number",
"string"
]
},
"token": {
"description": "Stablecoin (default all on the chain; Base has USDC only)",
"type": "string"
}
},
"type": "object"
},
"name": "stablecoin_transfers",
"outputSchema": null
},
{
"description": "Use when an agent needs a swap quote and price impact before trading. Input: chain (base, ethereum, arbitrum), from, to (ticker like USDC, ETH or 0x address), amounts (1-5 sizes in from-token units). Output: JSON per size best venue (Uniswap v3 fee tier, Uniswap v2, Aerodrome), amount out, effective price, price impact %, all venue quotes, spot price. Quote only: no calldata, nothing executed. Example: ?from=USDC&to=ETH&amounts=1000,100000 Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"amounts": {
"description": "1-5 trade sizes in units of the from token, comma-separated (alias amount)",
"type": "string"
},
"chain": {
"description": "Chain (default base)",
"type": "string"
},
"from": {
"description": "Token sold: ticker (USDC, USDT, ETH/WETH, BTC/cbBTC/WBTC, wstETH, DAI, AERO, ARB… per chain) or 0x address. Unknown → 400 before payment",
"type": "string"
},
"to": {
"description": "Token bought (same format)",
"type": "string"
}
},
"required": [
"from",
"to",
"amounts"
],
"type": "object"
},
"name": "swap_quote",
"outputSchema": null
},
{
"description": "Use when computing due dates, SLAs, settlement or delivery dates. Input: start date, then days (add -260..260 business days) or end (count business days between), optional country KR, US, GB, DE, FR or JP for public holidays (omit = weekends only). Output: JSON result date or business/calendar day counts, holidays skipped on the way, holiday scope. Example: ?start=2026-12-22&days=5&country=US Price: $0.003 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"country": {
"description": "Public holiday calendar (omit for weekends only)",
"type": "string"
},
"days": {
"description": "Business days to add (negative = go back); give days or end (days wins if both)",
"type": [
"number",
"string"
]
},
"end": {
"description": "Count business days from start (excluded) to end (included), at most 2 years apart; ignored when days is given",
"type": "string"
},
"start": {
"description": "Start date YYYY-MM-DD (2004–2099)",
"type": "string"
}
},
"required": [
"start"
],
"type": "object"
},
"name": "time_business_days",
"outputSchema": null
},
{
"description": "Use when scheduling across time zones or turning a local time into UTC without guessing DST. Input: to (IANA zones or KST, PST, CET...), optional from (zone of a local time, default UTC), time (ISO 8601, Unix seconds, or now). Output: JSON UTC instant, Unix time, and per zone: local ISO time with offset, weekday, abbreviation, DST and business-hours flags, day difference. Example: ?time=2026-10-12T09:00&from=Asia/Seoul&to=America/New_York,Europe/London Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"from": {
"description": "Zone of the input local time (default UTC; ignored when time has an offset)",
"type": "string"
},
"time": {
"description": "ISO 8601 date-time (2026-10-12T09:00, 2026-10-12T09:00:00+09:00), Unix seconds/ms, or now",
"type": "string"
},
"to": {
"description": "1–25 target zones, comma-separated (IANA names like Asia/Seoul, UTC, or abbreviations like KST, PST, CET)",
"type": "string"
}
},
"required": [
"to"
],
"type": "object"
},
"name": "time_convert",
"outputSchema": null
},
{
"description": "Use when scheduling a meeting across time zones. Input: zones (2-10, IANA or KST/PST/CET), date, work_start/work_end (default 09:00-18:00), include_weekends. Output: JSON overlap windows in UTC and every zone's local time, top 3 one-hour slots ranked by distance from each zone's day edges, partial windows when no full overlap, next DST change per zone. Example: ?zones=America/New_York,Europe/London,Asia/Seoul&date=2026-11-03 Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"date": {
"description": "Meeting date YYYY-MM-DD in the anchor zone (default today UTC)",
"type": "string"
},
"include_weekends": {
"description": "Count Saturday/Sunday as working days",
"type": "string"
},
"work_end": {
"description": "Local end of working hours, HH:MM",
"type": "string"
},
"work_start": {
"description": "Local start of working hours, HH:MM",
"type": "string"
},
"zones": {
"description": "2–10 time zones, comma-separated; the first is the anchor whose local date is scanned",
"type": "string"
}
},
"required": [
"zones"
],
"type": "object"
},
"name": "time_overlap",
"outputSchema": null
},
{
"description": "Use when an agent must know what an issuer can do to holders of an ERC-20 (stablecoin, RWA, ERC-3643) on Ethereum or Base. Input: address, optional chain (ethereum default, base), holder. Output: JSON capabilities (mint, burn from holder, pause, freeze/blacklist, seize, upgrade, ERC-3643), matched functions, proxy implementation, role holders, paused now, holder frozen status and balance. Example: ?address=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 Price: $0.003 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "Token contract address",
"type": "string"
},
"chain": {
"description": "Chain (default ethereum)",
"type": "string"
},
"holder": {
"description": "Also check this holder's blacklist / frozen status and balance",
"type": "string"
}
},
"required": [
"address"
],
"type": "object"
},
"name": "token_controls",
"outputSchema": null
},
{
"description": "Use when an agent needs one English brief on a token before trading or listing it. Input: token (base:0x… or sol:<mint>), format=json|markdown. Output: executiveSummary, riskAssessment (signals, owner/proxy or mint/freeze authority, holders), liquidity (price, depth, $1k/$10k buy impact), perpMarket (Hyperliquid, symbol match), sanctions (OFAC wallets), dataGaps. AI-written from chain facts; not advice. Example: ?token=base:0x940181a94A35A4569E4529A3CDfB74e38FD98631 Price: $0.20 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"format": {
"description": "markdown adds a readable English rendering of the same report",
"type": "string"
},
"token": {
"description": "One token: base:0x… (ERC-20 on Base) or sol:<mint>. Unknown token or bad input → 400 before payment (not charged)",
"type": "string"
}
},
"required": [
"token"
],
"type": "object"
},
"name": "token_report",
"outputSchema": null
},
{
"description": "Use when an agent must know if a US airport has a ground stop, ground delay program, closure or arrival/departure delay right now. Input: optional airport (FAA/IATA 3-letter like JFK, or ICAO like KJFK); none = every affected airport. Output: JSON per airport flags, max delay minutes, events with reason, avg/max delay, trend, end/reopen times, FAA update time. Not for flight planning. Example: ?airport=SFO Price: $0.003 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"airport": {
"description": "FAA/IATA code (JFK) or ICAO (KJFK). Omit for all airports with active events",
"type": "string"
}
},
"type": "object"
},
"name": "travel_us_airports",
"outputSchema": null
},
{
"description": "Use when an agent must tell a user what a transaction did. Input: tx (Base hash or Solana signature), network=eip155:8453|solana (optional, inferred). Output: explanation (1-3 sentences; every number checked against the decoded facts, template fallback), facts: status, time, fee, from/to, called function (curated selector table), ERC-20 transfers, approvals, inferred swap (sent/received), Solana programs. Example: ?tx=0x…&network=eip155:8453 Price: $0.005 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"network": {
"description": "Chain (default: Base for 0x hashes, Solana otherwise)",
"type": "string"
},
"tx": {
"description": "Base transaction hash (0x + 64 hex) or Solana signature (base58)",
"type": "string"
}
},
"required": [
"tx"
],
"type": "object"
},
"name": "tx_explain",
"outputSchema": null
},
{
"description": "Use when an agent researches a U.S. public company (due diligence, investing, competitors) and wants one sourced brief instead of many calls. Input: ticker or cik, optional news=false. Output: JSON profile, 3 fiscal years + latest quarter + balance sheet from SEC XBRL, YoY growth, rule-based risk signals (8-K items, late filings, losses) with evidence, recent 8-K events, latest news (title, link, date, publisher summary), sources. Example: ?ticker=NVDA Price: $0.035 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"cik": {
"description": "SEC Central Index Key; give ticker or cik",
"type": "string"
},
"news": {
"description": "Include recent news (default true)",
"type": "string"
},
"ticker": {
"description": "U.S. ticker (NVDA, BRK.B); give ticker or cik",
"type": "string"
}
},
"type": "object"
},
"name": "us_company_intelligence",
"outputSchema": null
},
{
"description": "Use when you need a US macro time series (pairs with Korea's Bank of Korea series). Input: series (unemployment_rate, cpi, core_cpi, payrolls, avg_hourly_earnings, ppi, public_debt, avg_rate_bills, avg_rate_notes, avg_rate_bonds), optional start, end (years, max 10-year span, default last 3 years). Output: JSON title, unit, frequency, observations [{period,value}], latest and source attribution. Data: BLS and US Treasury Fiscal Data. Example: ?series=cpi&start=2024 Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"end": {
"description": "End year (default current year)",
"type": "string"
},
"series": {
"description": "Series id (see enum; BLS or Treasury)",
"type": "string"
},
"start": {
"description": "Start year (default end-2, min 1990)",
"type": "string"
}
},
"required": [
"series"
],
"type": "object"
},
"name": "us_macro_series",
"outputSchema": null
},
{
"description": "Use when an agent must track new U.S. rules, proposed rules, agency notices and fresh SEC disclosures. Input: optional q (topic), agency (Federal Register slug), doc_type, form (8-K, 13F-HR, NPORT-P...), source, days, limit. Output: JSON Federal Register documents (type, agencies, abstract, effective/comment dates, CFR, links) and latest SEC filings by companies/funds (form, filer, CIK, filed, link). Metadata only. Example: ?days=30&source=federal_register Price: $0.0045 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"agency": {
"description": "Federal Register agency slug",
"type": "string"
},
"days": {
"description": "Look-back window in days (default 7)",
"type": [
"number",
"string"
]
},
"doc_type": {
"description": "Federal Register document type",
"type": "string"
},
"form": {
"description": "SEC forms, comma-separated (8-K, 13F-HR, NPORT-P, 10-K, 10-Q, 6-K, S-1, N-CSR); default 8-K,13F-HR,NPORT-P",
"type": "string"
},
"limit": {
"description": "Max items per source (default 10)",
"type": [
"number",
"string"
]
},
"q": {
"description": "Topic keywords (Federal Register full text; filters SEC filer names). Empty lists are not an error",
"type": "string"
},
"source": {
"description": "Which source (default all)",
"type": "string"
}
},
"type": "object"
},
"name": "us_regs",
"outputSchema": null
},
{
"description": "Use when an agent must be told when something changes. Input: type (price, balance, stablecoin_transfer, filing, insider_trade, hl_position, sanctions, web_status), target, condition, days 7-30, optional webhook. Output: id, one-time secret, poll URL. Checked every 5-60 min; events by poll or HMAC-signed webhook. $0.002/day ($0.004 web_status), paid once. Best-effort, no SLA; not refunded. Example: POST {\"type\":\"price\",\"symbol\":\"ETH\",\"below\":2000} Price: $0.014–$0.12 USDC via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"above": {
"description": "price/balance: fire when the value rises above this (USD for price, token units for balance); give above or below, not both",
"type": "string"
},
"address": {
"description": "balance: wallet (0x…); hl_position: Hyperliquid account (below= liq. distance %); sanctions: any crypto address; stablecoin_transfer: optional from/to filter",
"type": "string"
},
"below": {
"description": "price/balance: fire when the value falls below this",
"type": "string"
},
"chain": {
"description": "balance: base, ethereum, arbitrum, monad; stablecoin_transfer: ethereum, base, arbitrum",
"type": "string"
},
"cik": {
"description": "SEC CIK instead of ticker",
"type": "string"
},
"corp": {
"description": "filing: Korean company (DART corp_code, stock code or kr-dart- id) instead of ticker",
"type": "string"
},
"days": {
"description": "Watch length in days, 7-30 (default 7); price = days × daily rate",
"type": "string"
},
"items": {
"description": "filing (SEC): 8-K item codes",
"type": "string"
},
"min_usd": {
"description": "stablecoin_transfer: min USD (default 100000)",
"type": "string"
},
"side": {
"description": "insider_trade (ticker/cik): new Form 4 open-market buy, sell or both (default)",
"type": "string"
},
"symbol": {
"description": "price: one ticker (BTC, ETH, SOL, …; DEX-priced like /v1/crypto/price)",
"type": "string"
},
"ticker": {
"description": "filing/insider_trade: US ticker (or cik)",
"type": "string"
},
"token": {
"description": "balance: token symbol from the default set (e.g. USDC) or NATIVE (default); any change fires when no above/below",
"type": "string"
},
"type": {
"description": "What to watch. Without type the request is a price probe (402 at the 7-day minimum)",
"type": "string"
},
"url": {
"description": "web_status: site (checked every 15 min)",
"type": "string"
},
"webhook": {
"description": "Optional https URL (port 443, public host) for signed POSTs: header x-1gateway-signature t=…,v1=HMAC-SHA256(key=hex(SHA-256(secret)), `${t}.${body}`)",
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
},
"name": "watch_create",
"outputSchema": null
},
{
"description": "Use when an agent needs the weather anywhere in the world. Input: lat and lon, or city (Paris or Paris,FR), optional hours (0-72, default 24), tz (IANA zone, default UTC or the city's). Output: JSON current temperature, symbol, wind, humidity, cloud, pressure; hourly series; daily min/max, precipitation, max wind, symbol for ~10 days. Data: MET Norway. Example: ?city=London,GB or ?lat=51.5072&lon=-0.1276 Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"city": {
"description": "City name instead of lat/lon, optional ,CC country code (most populous match; unknown city → 400 before payment)",
"type": "string"
},
"hours": {
"description": "Hourly steps to return (default 24)",
"type": [
"number",
"string"
]
},
"lat": {
"description": "Latitude, WGS84 decimal degrees (rounded to 0.01); with lon, or use city",
"type": [
"number",
"string"
]
},
"lon": {
"description": "Longitude, WGS84 decimal degrees (rounded to 0.01); with lat, or use city",
"type": [
"number",
"string"
]
},
"tz": {
"description": "IANA time zone for daily summaries and local hours (default UTC)",
"type": "string"
}
},
"type": "object"
},
"name": "weather_global",
"outputSchema": null
},
{
"description": "Use when an agent needs a sourced answer to a question from the live web in one call. Input: q (question), optional time_range (day, week, month, year). Output: JSON answer (English, inline [n] citations), citations [{url, title, quote}], confidence, notes, sources read. Searches, reads the top 4 pages itself and answers only from them. Provider or model failure is not charged. Example: ?q=what+is+the+x402+payment+protocol Price: $0.012 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"q": {
"description": "Search query",
"type": "string"
},
"time_range": {
"description": "Only results from the past day, week, month or year",
"type": "string"
}
},
"required": [
"q"
],
"type": "object"
},
"name": "web_answer",
"outputSchema": null
},
{
"description": "Use when an agent must grade a website and say what to fix. Input: url or bare domain. Output: JSON score 0-100, grade A-F, per-category scores (security, https, seo, mail, ai), findings [{id, severity, category, title, fix}] and top fixes. Rule-based from one live fetch plus DNS; raw data: /v1/web/site-profile. Example: ?url=stripe.com Price: $0.006 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"url": {
"description": "Site URL or bare domain (https:// assumed); private/internal targets → 400 (not charged)",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "web_audit",
"outputSchema": null
},
{
"description": "Use when an agent must know if a URL is up before linking, scraping or alerting. Input: url or bare domain (https:// assumed). Output: up (final status below 400), HTTP status, final URL, redirect chain, HTTPS and http-to-https upgrade, response time in ms, content type, server. Down or timed-out sites return up: false. Private targets → 400 before payment. Example: ?url=example.com Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"url": {
"description": "URL or bare domain (https:// assumed); private/internal targets → 400 (not charged)",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "web_check",
"outputSchema": null
},
{
"description": "Use when an agent needs specific fields from a web page as JSON. Input: url, schema (URL-encoded JSON Schema, object root, max 30 properties, depth 3, 3,000 chars). Output: JSON data validated against the schema (null when not on the page), title, finalUrl. SSRF-safe; noai pages refused; bad schema refused before payment. Fixed schema: /v1/docs/extract. Example: ?url=https://example.com/&schema={\"type\":\"object\",\"properties\":{\"title\":{\"type\":\"string\"}}} Price: $0.007 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"schema": {
"description": "JSON Schema (object root) describing the fields to extract",
"type": "string"
},
"url": {
"description": "Public http(s) web page URL",
"type": "string"
}
},
"required": [
"url",
"schema"
],
"type": "object"
},
"name": "web_extract",
"outputSchema": null
},
{
"description": "Use when an agent needs to know what a URL is before reading it, or to build a link preview or citation. Input: url (public http/https). Output: JSON with final URL after redirects, HTTP status, content type, title, description, site name, language, canonical, preview image, favicon, Open Graph and Twitter tags, RSS/Atom feeds, hreflang alternates, JSON-LD types, robots, first H1. No JavaScript is run. Example: ?url=https://developer.mozilla.org/en-US/ Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"url": {
"description": "Public http(s) URL; private/internal addresses → 400 (not charged)",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "web_metadata",
"outputSchema": null
},
{
"description": "Use when an agent already has a URL and needs the page as clean Markdown (boilerplate removed, tables kept). Input: url (https:// optional), optional max_chars (500-60000), flags=1 for prompt-injection signals; GET query or POST JSON {url, max_chars, flags}. Output: JSON markdown, title, language, finalUrl, chars, truncated. SSRF-safe; noai pages refused. English brief: /v1/web/read/brief. Search+read: /v1/web/search-read. Example: ?url=https://example.com/ Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"flags": {
"description": "1 = add rule-based prompt-injection signals found in the page",
"type": "string"
},
"max_chars": {
"description": "Max Markdown characters returned (default 60000)",
"type": [
"number",
"string"
]
},
"url": {
"description": "Public http(s) web page URL",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "web_read",
"outputSchema": null
},
{
"description": "Use when an agent has several URLs (search results, citations) and needs them all as Markdown at once. Input: urls (1-5 public URLs separated by spaces), optional max_chars per URL (500-20000), flags=1. Output: JSON results[] in input order, each status ok (markdown, title, finalUrl) or error (code, message). Charged once if at least one page is read. Example: ?urls=https://example.com/ https://example.org/ Price: $0.008 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"flags": {
"description": "1 = add rule-based prompt-injection signals per page",
"type": "string"
},
"max_chars": {
"description": "Max Markdown characters per URL (default 20000)",
"type": [
"number",
"string"
]
},
"urls": {
"description": "1-5 public http(s) URLs separated by spaces",
"type": "string"
}
},
"required": [
"urls"
],
"type": "object"
},
"name": "web_read_batch",
"outputSchema": null
},
{
"description": "Use when an agent needs a page in any language (Korean, Japanese, etc.) read and briefed in English. Input: url, optional max_chars, flags=1. Output: JSON markdown, title, plus brief {headline, summary, key_points, entities, topics, source_language, content_type}; fixed schema, cached by content. Model outage or daily cap is refused before payment. Example: ?url=https://example.com/ Price: $0.006 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"flags": {
"description": "1 = add rule-based prompt-injection signals found in the page",
"type": "string"
},
"max_chars": {
"description": "Max Markdown characters returned (default 60000)",
"type": [
"number",
"string"
]
},
"url": {
"description": "Public http(s) web page URL",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "web_read_brief",
"outputSchema": null
},
{
"description": "Use when an agent must see how a page looks (layout, charts, visual QA, previews), not just its text. Input: url, width (320-1920, default 1280), full_page=1 for the whole page, format png or jpeg (default). Output: JSON imageBase64 (decode to the image), contentType, bytes, viewport. Renders JavaScript. Daily cap or bad URL refused before payment. Example: ?url=https://example.com/ Price: $0.01 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"format": {
"description": "Image format (default jpeg)",
"type": "string"
},
"full_page": {
"description": "1 = capture the whole scrollable page",
"type": "string"
},
"url": {
"description": "Public http(s) page URL",
"type": "string"
},
"width": {
"description": "Viewport width in px (default 1280; height = 0.625 x width)",
"type": [
"number",
"string"
]
}
},
"required": [
"url"
],
"type": "object"
},
"name": "web_screenshot",
"outputSchema": null
},
{
"description": "Use when an agent needs current web results for a query. Input: q, optional max (1-10, default 5), time_range (day, week, month, year). Output: JSON results with title, URL and date when known, provider and retrieval time. For page text use /v1/web/search-read. Provider failure is not charged. Example: ?q=x402+payment+protocol&max=5 Price: $0.006 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"max": {
"description": "Number of results (default 5)",
"type": [
"number",
"string"
]
},
"q": {
"description": "Search query",
"type": "string"
},
"time_range": {
"description": "Only results from the past day, week, month or year",
"type": "string"
}
},
"required": [
"q"
],
"type": "object"
},
"name": "web_search",
"outputSchema": null
},
{
"description": "Use when an agent needs to search and read in one call. Input: q, optional max (1-10, default 5), time_range (day, week, month, year). Output: JSON results (title, URL, date) and, for the top 3, the page converted to Markdown (up to 4,000 characters each; a page that fails is marked, the rest still ship). Provider failure is not charged. Example: ?q=EU+AI+Act+timeline&max=5 Price: $0.02 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"max": {
"description": "Number of results (default 5)",
"type": [
"number",
"string"
]
},
"q": {
"description": "Search query",
"type": "string"
},
"time_range": {
"description": "Only results from the past day, week, month or year",
"type": "string"
}
},
"required": [
"q"
],
"type": "object"
},
"name": "web_search_read",
"outputSchema": null
},
{
"description": "Use when an agent must pick a paid x402 API for a task. Input: q (task in plain words or keywords), optional max_price (USD), network (base, solana or CAIP-2), limit (1-20). Output: JSON ranked endpoints: resource URL, method, description, price, networks, seller, 30-day payers and calls (Bazaar), seller buyers (x402scan), wash/quality flags, score, index as_of. Same rules for every seller. Example: ?q=base+token+honeypot+check&max_price=0.02 Price: $0.009 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"include_flagged": {
"description": "false drops routes flagged scanner_like or uniform_payers (suspected probes / wash); default true (flagged routes are kept but ranked lower)",
"type": "string"
},
"limit": {
"description": "Number of results (default 8)",
"type": [
"number",
"string"
]
},
"max_price": {
"description": "Only endpoints priced at or below this many USD per call",
"type": [
"number",
"string"
]
},
"network": {
"description": "Only endpoints that accept this network: base, solana, polygon, arbitrum, optimism, ethereum, avalanche, worldchain, monad, or a CAIP-2 id (eip155:8453)",
"type": "string"
},
"q": {
"description": "What the API should do, in plain words or keywords (e.g. 'korean apartment prices', 'convert pdf to markdown'). Text only: never fetched as a URL",
"type": "string"
}
},
"required": [
"q"
],
"type": "object"
},
"name": "x402_api_recommend",
"outputSchema": null
},
{
"description": "Use when you sell an API over x402 and want it to pass Bazaar/CDP listing checks. Input: url (https x402 resource), method GET or POST. Output: JSON score 0-100, grade, per-check pass/warn/fail with fix hints (x402 v2 quote, accepts fields, USDC asset, payTo format and OFAC list, description quality, Bazaar schemas, header size, CORS, latency, openapi/llms.txt, ERC-8004) plus our measured uptime. Never pays. Example: ?url=https://1gateway.dev/v1/time/convert Price: $0.008 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"method": {
"description": "HTTP method of the resource (POST sends an empty JSON body)",
"type": "string"
},
"url": {
"description": "https URL of the x402 resource to grade (public host)",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "x402_lint",
"outputSchema": null
},
{
"description": "Use when an agent is about to pay an unknown x402 endpoint and needs a cheap safety gate. Input: url (https x402 resource), method, optional max_price_usd. Output: JSON verdict ALLOW/WARN/DENY with reasons: live quote now, price vs similar routes and your budget, payTo on the OFAC list, price change vs our last measurement, our 7-day uptime/p95, ERC-8004 registration. Never pays; cached 60 s. Example: ?url=https://1gateway.dev/v1/fx/rates&max_price_usd=0.01 Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"max_price_usd": {
"description": "Your budget per call in USD; a higher quote gives DENY",
"type": [
"number",
"string"
]
},
"method": {
"description": "HTTP method of the resource",
"type": "string"
},
"url": {
"description": "https URL of the x402 resource you are about to pay",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "x402_preflight",
"outputSchema": null
},
{
"description": "Use when an agent or seller must confirm a payment before delivering: checks a Base, Base Sepolia or Solana transaction for a USDC transfer to pay_to of at least amount. Input: tx (hash or signature), pay_to, network (default eip155:8453), optional amount in USDC. Output: JSON paid true/false, verdict, received, payers, block, time, confirmations. Bad formats refused before payment. Example: ?tx=0x…&pay_to=0x…&amount=0.0045 (real Base payment) Price: $0.002 USDC (Base or Solana) via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"amount": {
"description": "Expected minimum USDC amount, e.g. 0.01",
"type": "string"
},
"network": {
"description": "CAIP-2 network (default eip155:8453 = Base)",
"type": "string"
},
"pay_to": {
"description": "Receiving address (0x… on Base, base58 owner address on Solana)",
"type": "string"
},
"tx": {
"description": "Transaction hash (0x…, Base) or signature (base58, Solana)",
"type": "string"
}
},
"required": [
"tx",
"pay_to"
],
"type": "object"
},
"name": "x402_verify",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:419f3cbb01c2f7494d9f63ef96761aaf5422f09c90987e2c775e6902c913d945 | sha256sum