{"uid":"cap_ucYa9m7ysTmzZPO0kUXd1","slug":"agents-x402stock-xyz-x402stock-free-seller-api-quote-purchase-guide-bdd18fd9","name":"x402stock Free Seller API Quote & Purchase Guide","description":"Market and economic data for AI agents — US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities (crude, natural gas, gasoline), US and global macro (Fed funds, CPI/PCE, jobs, GDP, Treasury debt & yields, World Bank indicators), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 or MPP. This server is a pay-per-use, transparent proxy in front of x402stock's own API: it handles identity, payment, and proxying. Agents can purchase autonomously or with their human's approval. The complete verified paid surface is listed at /openapi.json, the source of truth for available operations. Each operation here carries its live price in x-payment-info. Use the operations and details here when they meet your needs. Filtered specs contain only matching operations; if you cannot find what you need here, use search or the service catalog. The live catalog at /manifest.json is authoritative for prices and any free included units (prices[].includedUnits) - some meters include free usage per account before any charge, reserved for agents claimed by a human with a verified email.","url":"https://agents.x402stock.xyz/zeroclick/agent/quote?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"goal":{"type":"string","maxLength":2000,"minLength":1,"description":"Describe the task and known inputs. Do not include credentials."},"payment":{"enum":["x402","mpp","card"],"type":"string","description":"Known payment method for the eventual purchase, independent of this free lookup's wallet proof."},"quantity":{"type":"integer","maximum":1000000,"minimum":1,"description":"Number of API calls, not returned items. Omit when unknown; describe desired output in goal."},"budgetUsd":{"type":"string","pattern":"^(0|[1-9]\\d{0,8})(\\.\\d{1,6})?$","description":"Total cash budget in USD. A quote does not authorize spending."},"requirements":{"type":"string","maxLength":300,"minLength":1},"humanAvailable":{"type":"boolean","description":"Whether a human is in the loop. False recommends anonymous auth for a new autonomous identity; omit when unknown. Executing a human's request without further interruptions does not by itself mean false."},"budgetExclusive":{"type":"boolean"},"reviewAfterCalls":{"type":"integer","maximum":1000000,"minimum":1}}},"responseSchema":{"type":"json","example":{"guide":"Task support is not established. Use the advisor to resolve missing details before purchasing.","status":"unknown","guideUrl":"https://agents.x402stock.xyz/zeroclick/agent/guide","priceUsd":"0"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"registry","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.67","successRate":"0.67","reviews":1,"stars":"3.7","state":"rated"},"availabilityStatus":"healthy","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"free","summary":"Free","primary":{"kind":"free","protocol":"x402","network":"base","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"free","protocol":"x402","network":"base","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_OxPd931dKoHxtN9kg9mbN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.x402stock.xyz","brandSlug":"agents-x402stock-xyz-x402","brandBaseUrl":"https://agents.x402stock.xyz","brandDocsUrl":null,"whatItDoes":"Returns a free, wallet-free quote with API contract details, pricing, prerequisites, and next steps for any x402stock data task — no purchase executed.","exampleAgentPrompt":"I want to pull short interest history for US stocks using x402stock — can you get me a free quote and purchase guide so I know the exact API contract, price per call, and what I need to get started?","exampleUseCases":[{"title":"Planning autonomous stock data pipeline","prompt":"I'm building an agent that fetches OHLCV bar history for US stocks — can you get me a free x402stock quote showing the API contract, price per call, and prerequisites so I can plan how many calls to budget for?"},{"title":"Researching SEC filing costs before committing","prompt":"Before I spend anything, can you look up the x402stock API guide for pulling recent SEC filings and insider transactions — tell me the contract details, cost, and what I need to set up?"},{"title":"Comparing payment options for crypto data","prompt":"I want to fetch crypto and on-chain perps data via x402stock using USDC payments — can you get a free quote that shows me the contract, price, and next steps for paying via x402?"}],"resultDescription":"Returns a JSON object with a status enum (quoted, ready, needs_input, blocked, unknown, unsupported, unavailable), a priceUsd field always equal to '0', a Markdown-formatted guide string containing the matched API contract, pricing, prerequisites, and next steps, and a guideUrl pointing to a wallet-free advisor endpoint for further planning.","failureModes":["status: needs_input — goal description too vague to match a contract; agent should refine the goal field","status: unsupported — requested data type not available on x402stock","status: unavailable — service temporarily unreachable","status: blocked — request violates policy (e.g. credentials included in goal)","status: unknown — ambiguous task, no confident match found"],"whenToPreferThis":"Use this endpoint when an agent needs to discover, plan, or price a data purchase on x402stock before committing any funds — especially when no wallet is available or when a human needs to review costs first. Prefer this over the paid endpoints when the task is exploratory, the right contract is uncertain, or when a budget needs to be validated. This is also ideal for autonomous agents that need to determine prerequisites and auth requirements before executing a purchase.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":3,"lastUsedAt":"2026-10-07T02:00:06.876Z","lastSuccessfullyRanAt":"2026-10-07T02:00:06.876Z","lastHealthCheckAt":"2026-10-12T21:35:22.953Z","isFirstParty":false,"canonicalSlug":"agents-x402stock-xyz-x402stock-free-seller-api-quote-purchase-guide-bdd18fd9"}