{"openapi":"3.1.0","info":{"title":"Fuci","version":"1.0.0","summary":"On-chain data tools for AI agents on Arc, paid per call in USDC over x402.","description":"Paid data tools for AI agents on Arc: Argus launches, bonding, market mood and A–F risk ratings. Settled in USDC over x402 via Circle Gateway.","x-guidance":"Fuci sells on-chain data about Arc to AI agents, paid per call in USDC over x402 (Circle Gateway, gas-free for the buyer; pay from Arc, Base, Arbitrum, Ethereum, Optimism, Polygon, Avalanche and more). Every paid call first returns 402 with the price; pay and retry to get JSON. Use argus_launches for the newest token launches on Argus (Arc's launchpad), argus_bonding for one token's price, bonding progress and recent trades, fucus_oracle for a one-sentence market mood, and fuci_risk for an A–F risk grade of any Arc token (0x address) or DeFi protocol (DefiLlama slug) before allocating capital, and fuci_kya (Know Your Agent) for an A–F trust grade of another agent (ERC-8004 id or wallet) before paying, hiring or trusting it. fuci_agent answers a free-text question by buying the tools it needs. All data is read live from Arc and public sources; unknown values are reported as unknown, never guessed.","x-logo":{"url":"https://www.fuci.family/brand/fuci-logo-512.png","altText":"Fuci"},"license":{"name":"MIT","identifier":"MIT"},"contact":{"name":"Fuci","url":"https://www.fuci.family/docs","email":"hello@fuci.family"}},"security":[],"externalDocs":{"description":"Docs, examples and the MCP server","url":"https://www.fuci.family/docs"},"servers":[{"url":"https://www.fuci.family"}],"tags":[{"name":"Paid tools","description":"Each call costs a fixed USDC price, paid over x402 on Arc."}],"paths":{"/api/x402/argus/launches":{"get":{"operationId":"argus_launches","summary":"Argus Launch Scout","description":"Latest token launches on Argus, the launchpad on Arc: who launched them, their pool and their buy/sell tax. Price: $0.001 USDC per call over x402.","tags":["Paid tools"],"parameters":[{"name":"limit","in":"query","required":false,"description":"How many launches to return, newest first (1–20, default 8)","schema":{"type":"integer","description":"How many launches to return, newest first (1–20, default 8)"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USDC","amount":"0.001000"},"protocols":[{"x402":{"scheme":"exact","networks":[{"network":"eip155:5042","name":"Arc","asset":"0x3600000000000000000000000000000000000000"},{"network":"eip155:8453","name":"Base","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},{"network":"eip155:42161","name":"Arbitrum","asset":"0xaf88d065e77c8cC2239327C5EDb3A432268e5831"},{"network":"eip155:1","name":"Ethereum","asset":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},{"network":"eip155:10","name":"Optimism","asset":"0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85"},{"network":"eip155:137","name":"Polygon","asset":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359"},{"network":"eip155:43114","name":"Avalanche","asset":"0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E"},{"network":"eip155:130","name":"Unichain","asset":"0x078D782b760474a361dDA0AF3839290b0EF57AD6"},{"network":"eip155:480","name":"World Chain","asset":"0x79A02482A880bCE3F13e09Da970dC34db4CD24d1"},{"network":"eip155:146","name":"Sonic","asset":"0x29219dd400f2Bf60E5a23d13Be72B486D4038894"},{"network":"eip155:1329","name":"Sei","asset":"0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392"},{"network":"eip155:999","name":"HyperEVM","asset":"0xb88339CB7199b77E23DB6E890353E22632Ba630f"}]}}]},"responses":{"200":{"description":"OK. The data, paid for.","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","description":"The tool id that answered."},"source":{"type":"string","description":"Where the data came from (chain = read live from Arc)."},"block":{"type":"integer","description":"Arc block the data was read at."},"data":{"type":"array","description":"Launches, newest first: token, creator, hook, poolId, symbol, buyTaxPct, sellTaxPct, block.","items":{"type":"object"}}}}}}},"400":{"description":"Invalid input (not charged)."},"402":{"description":"Payment Required. The x402 challenge (PAYMENT-REQUIRED header) with the price, network and receiver."}}}},"/api/x402/argus/bonding":{"get":{"operationId":"argus_bonding","summary":"Bonding Watcher","description":"Price, progress toward bonding, taxes and recent buys and sells for one Argus token. Price: $0.002 USDC per call over x402.","tags":["Paid tools"],"parameters":[{"name":"token","in":"query","required":false,"description":"Token address (0x…) of an Argus launch (default: $FUCI)","schema":{"type":"string","description":"Token address (0x…) of an Argus launch (default: $FUCI)"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USDC","amount":"0.002000"},"protocols":[{"x402":{"scheme":"exact","networks":[{"network":"eip155:5042","name":"Arc","asset":"0x3600000000000000000000000000000000000000"},{"network":"eip155:8453","name":"Base","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},{"network":"eip155:42161","name":"Arbitrum","asset":"0xaf88d065e77c8cC2239327C5EDb3A432268e5831"},{"network":"eip155:1","name":"Ethereum","asset":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},{"network":"eip155:10","name":"Optimism","asset":"0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85"},{"network":"eip155:137","name":"Polygon","asset":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359"},{"network":"eip155:43114","name":"Avalanche","asset":"0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E"},{"network":"eip155:130","name":"Unichain","asset":"0x078D782b760474a361dDA0AF3839290b0EF57AD6"},{"network":"eip155:480","name":"World Chain","asset":"0x79A02482A880bCE3F13e09Da970dC34db4CD24d1"},{"network":"eip155:146","name":"Sonic","asset":"0x29219dd400f2Bf60E5a23d13Be72B486D4038894"},{"network":"eip155:1329","name":"Sei","asset":"0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392"},{"network":"eip155:999","name":"HyperEVM","asset":"0xb88339CB7199b77E23DB6E890353E22632Ba630f"}]}}]},"responses":{"200":{"description":"OK. The data, paid for.","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","description":"The tool id that answered."},"source":{"type":"string","description":"Where the data came from (chain = read live from Arc)."},"block":{"type":"integer","description":"Arc block the data was read at."},"data":{"type":"object","description":"token, symbol, priceUsdc, progress (0..1 toward bonding), bonded, buyTaxPct, sellTaxPct and recent trades."}}}}}},"400":{"description":"Invalid input (not charged)."},"402":{"description":"Payment Required. The x402 challenge (PAYMENT-REQUIRED header) with the price, network and receiver."}}}},"/api/x402/fucus/oracle":{"get":{"operationId":"fucus_oracle","summary":"Tide Oracle","description":"A tide reading: net USDC flow and sentiment across the newest Argus launches, in one sentence. Price: $0.0005 USDC per call over x402.","tags":["Paid tools"],"parameters":[{"name":"launches","in":"query","required":false,"description":"How many of the newest launches to read trades from (1–6, default 4)","schema":{"type":"integer","description":"How many of the newest launches to read trades from (1–6, default 4)"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USDC","amount":"0.000500"},"protocols":[{"x402":{"scheme":"exact","networks":[{"network":"eip155:5042","name":"Arc","asset":"0x3600000000000000000000000000000000000000"},{"network":"eip155:8453","name":"Base","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},{"network":"eip155:42161","name":"Arbitrum","asset":"0xaf88d065e77c8cC2239327C5EDb3A432268e5831"},{"network":"eip155:1","name":"Ethereum","asset":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},{"network":"eip155:10","name":"Optimism","asset":"0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85"},{"network":"eip155:137","name":"Polygon","asset":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359"},{"network":"eip155:43114","name":"Avalanche","asset":"0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E"},{"network":"eip155:130","name":"Unichain","asset":"0x078D782b760474a361dDA0AF3839290b0EF57AD6"},{"network":"eip155:480","name":"World Chain","asset":"0x79A02482A880bCE3F13e09Da970dC34db4CD24d1"},{"network":"eip155:146","name":"Sonic","asset":"0x29219dd400f2Bf60E5a23d13Be72B486D4038894"},{"network":"eip155:1329","name":"Sei","asset":"0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392"},{"network":"eip155:999","name":"HyperEVM","asset":"0xb88339CB7199b77E23DB6E890353E22632Ba630f"}]}}]},"responses":{"200":{"description":"OK. The data, paid for.","content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","description":"The tool id that answered."},"source":{"type":"string","description":"Where the data came from (chain = read live from Arc)."},"block":{"type":"integer","description":"Arc block the data was read at."},"data":{"type":"object","description":"reading (one sentence), netFlowUsdc, mood, launches and trades counted."}}}}}},"400":{"description":"Invalid input (not charged)."},"402":{"description":"Payment Required. The x402 challenge (PAYMENT-REQUIRED header) with the price, network and receiver."}}}},"/api/x402/risk":{"get":{"operationId":"fuci_risk","summary":"Risk Rating","description":"A graded risk report (A–F) for a token on Arc or a DeFi protocol: contract control, liquidity, holder concentration, audits, hack history, TVL and yield sustainability, each explained with its source. Price: $0.002 USDC per call over x402.","tags":["Paid tools"],"parameters":[{"name":"target","in":"query","required":true,"description":"Token address on Arc (0x…) or a DefiLlama protocol slug (e.g. morpho-blue)","schema":{"type":"string","description":"Token address on Arc (0x…) or a DefiLlama protocol slug (e.g. morpho-blue)"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USDC","amount":"0.002000"},"protocols":[{"x402":{"scheme":"exact","networks":[{"network":"eip155:5042","name":"Arc","asset":"0x3600000000000000000000000000000000000000"},{"network":"eip155:8453","name":"Base","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},{"network":"eip155:42161","name":"Arbitrum","asset":"0xaf88d065e77c8cC2239327C5EDb3A432268e5831"},{"network":"eip155:1","name":"Ethereum","asset":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},{"network":"eip155:10","name":"Optimism","asset":"0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85"},{"network":"eip155:137","name":"Polygon","asset":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359"},{"network":"eip155:43114","name":"Avalanche","asset":"0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E"},{"network":"eip155:130","name":"Unichain","asset":"0x078D782b760474a361dDA0AF3839290b0EF57AD6"},{"network":"eip155:480","name":"World Chain","asset":"0x79A02482A880bCE3F13e09Da970dC34db4CD24d1"},{"network":"eip155:146","name":"Sonic","asset":"0x29219dd400f2Bf60E5a23d13Be72B486D4038894"},{"network":"eip155:1329","name":"Sei","asset":"0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392"},{"network":"eip155:999","name":"HyperEVM","asset":"0xb88339CB7199b77E23DB6E890353E22632Ba630f"}]}}]},"responses":{"200":{"description":"OK. The data, paid for.","content":{"application/json":{"schema":{"type":"object","description":"A risk report: grade (A–F or null), score 0–100, label, confidence, redFlags, limits (rules capping the grade), factors (each with score, summary, details and sources)."}}}},"400":{"description":"Invalid input (not charged)."},"402":{"description":"Payment Required. The x402 challenge (PAYMENT-REQUIRED header) with the price, network and receiver."}}}},"/api/x402/kya":{"get":{"operationId":"fuci_kya","summary":"Know Your Agent","description":"Check another AI agent before you pay, hire or trust it: an A–F trust grade from its ERC-8004 identity, registration file, on-chain reputation and validations, wallet activity, USDC balance and x402 payment record, each explained with its source. Price: $0.002 USDC per call over x402.","tags":["Paid tools"],"parameters":[{"name":"agent","in":"query","required":true,"description":"An ERC-8004 agent id on Arc (e.g. 12) or the agent's wallet address (0x…)","schema":{"type":"string","description":"An ERC-8004 agent id on Arc (e.g. 12) or the agent's wallet address (0x…)"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USDC","amount":"0.002000"},"protocols":[{"x402":{"scheme":"exact","networks":[{"network":"eip155:5042","name":"Arc","asset":"0x3600000000000000000000000000000000000000"},{"network":"eip155:8453","name":"Base","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},{"network":"eip155:42161","name":"Arbitrum","asset":"0xaf88d065e77c8cC2239327C5EDb3A432268e5831"},{"network":"eip155:1","name":"Ethereum","asset":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},{"network":"eip155:10","name":"Optimism","asset":"0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85"},{"network":"eip155:137","name":"Polygon","asset":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359"},{"network":"eip155:43114","name":"Avalanche","asset":"0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E"},{"network":"eip155:130","name":"Unichain","asset":"0x078D782b760474a361dDA0AF3839290b0EF57AD6"},{"network":"eip155:480","name":"World Chain","asset":"0x79A02482A880bCE3F13e09Da970dC34db4CD24d1"},{"network":"eip155:146","name":"Sonic","asset":"0x29219dd400f2Bf60E5a23d13Be72B486D4038894"},{"network":"eip155:1329","name":"Sei","asset":"0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392"},{"network":"eip155:999","name":"HyperEVM","asset":"0xb88339CB7199b77E23DB6E890353E22632Ba630f"}]}}]},"responses":{"200":{"description":"OK. The data, paid for.","content":{"application/json":{"schema":{"type":"object","description":"A Know Your Agent report: grade (A–F or null), score 0–100, label, confidence, redFlags, limits, factors (identity, registration, reputation, validation, activity, funds, payments, each with score, summary, details and sources) and subject (agentId, name, owner, wallet, cardUrl, x402Support, otherAgentIds)."}}}},"400":{"description":"Invalid input (not charged)."},"402":{"description":"Payment Required. The x402 challenge (PAYMENT-REQUIRED header) with the price, network and receiver."}}}},"/api/agent/run":{"post":{"operationId":"fuci_agent","summary":"Ask the Fucus Agent","description":"Pay-per-prompt: a Fuci agent answers your question by buying the tools above, and up to 0.02 USDC of data from other sellers in Fuci Market when it helps (each seller checked with Know Your Agent), then writes a brief (with Claude when enabled). Price: $0.04 USDC per call over x402.","tags":["Paid tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string","description":"Your question about Argus launches / Arc markets"}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USDC","amount":"0.040000"},"protocols":[{"x402":{"scheme":"exact","networks":[{"network":"eip155:5042","name":"Arc","asset":"0x3600000000000000000000000000000000000000"},{"network":"eip155:8453","name":"Base","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},{"network":"eip155:42161","name":"Arbitrum","asset":"0xaf88d065e77c8cC2239327C5EDb3A432268e5831"},{"network":"eip155:1","name":"Ethereum","asset":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},{"network":"eip155:10","name":"Optimism","asset":"0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85"},{"network":"eip155:137","name":"Polygon","asset":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359"},{"network":"eip155:43114","name":"Avalanche","asset":"0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E"},{"network":"eip155:130","name":"Unichain","asset":"0x078D782b760474a361dDA0AF3839290b0EF57AD6"},{"network":"eip155:480","name":"World Chain","asset":"0x79A02482A880bCE3F13e09Da970dC34db4CD24d1"},{"network":"eip155:146","name":"Sonic","asset":"0x29219dd400f2Bf60E5a23d13Be72B486D4038894"},{"network":"eip155:1329","name":"Sei","asset":"0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392"},{"network":"eip155:999","name":"HyperEVM","asset":"0xb88339CB7199b77E23DB6E890353E22632Ba630f"}]}}]},"responses":{"200":{"description":"OK. The data, paid for.","content":{"application/json":{"schema":{"type":"object","description":"The agent's brief: answer text, the tools it bought, USDC spent and the raw tool data."}}}},"400":{"description":"Invalid input (not charged)."},"402":{"description":"Payment Required. The x402 challenge (PAYMENT-REQUIRED header) with the price, network and receiver."}}}}}}