# Can AI agents buy stock market data from x402stock? Yes: an AI agent can buy x402stock's market and economic data one request at a time, with no account, API key or registration, and a stock quote costs $0.01. Each call answers with a 402, the price quote, which you pay over x402 or MPP in USDC. Calls priced from $0.50 can also be paid by card, prepaid Credits suit steady volume, and the [buyer skill](https://agents.x402stock.xyz/zcj/h3bl6a7l5t82/SKILL.md) is where to start. ## At a glance - **Example endpoint:** `GET https://agents.x402stock.xyz/zcj/h3bl6a7l5t82/api/v1/quote/{ticker}` - **Price:** $0.01 per quote. Every other operation carries its own price in the API reference and the catalog. - **Payment:** USDC on every call, over x402 on Base or MPP on Tempo, with no identity step. Calls priced at $0.50 or more can also be paid by card. - **Steady volume:** prepaid Credits from $0.50. Buying them needs a bearer credential, which is the agent identity the storefront issues. - **Response:** JSON with `ticker`, `data`, `source` and `as_of`. - **Coverage:** US stocks, ETFs and options, forex, crypto and perps, energy, US and global macro, SEC filings and sentiment. - **Full purchase flow:** [buyer skill](https://agents.x402stock.xyz/zcj/h3bl6a7l5t82/SKILL.md) ## Buy one stock quote 1. Send the request: ```http GET https://agents.x402stock.xyz/zcj/h3bl6a7l5t82/api/v1/quote/MSFT ``` The storefront answers with a 402 that states the exact `payment.amountUsd`. Nothing is charged at this step. 2. Pay the 402 and retry, as the [buyer skill](https://agents.x402stock.xyz/zcj/h3bl6a7l5t82/SKILL.md) describes. The example request paid $0.01. 3. Read the response. It is a JSON object with `ticker`, `data`, `source`, `as_of` and `feedback`. - `data` holds `price`, `change`, `change_percent`, `previous_close`, `timestamp`, `is_delayed` and `delayed_by`. - It also holds a `day` bar with `open`, `high`, `low`, `close`, `volume` and `vwap`. Every other operation is bought the same way. To find one, use the free search `GET https://agents.x402stock.xyz/zcj/h3bl6a7l5t82/openapi.json?q={short task}&page=1`. It returns the operation's parameters and its live price. ## Pick a way to pay | Situation | Path | | --- | --- | | Wallet with USDC | x402 or MPP on each call. No registration or bearer. | | Card, for a call priced at $0.50 or more | Card on that call. No registration. | | Card for smaller calls, or steady volume | Credits from $0.50 ($0.50 by card), bought at `/plans/{planId}/purchase` with a bearer credential. The plan id is in the [catalog](https://agents.x402stock.xyz/zcj/h3bl6a7l5t82/manifest.json). Calls draw down the balance. | | No payment client yet | [How to pay](https://agents.x402stock.xyz/zcj/h3bl6a7l5t82/payment.md) lists the setup options. | The [buyer skill](https://agents.x402stock.xyz/zcj/h3bl6a7l5t82/SKILL.md) has the steps for each path. ## When you are charged - Nothing is charged until you pay a 402. Reading the API reference, the search results and the catalog is free. - Each pay-as-you-go call is its own purchase: one 402 and one payment. - A card call under $0.50 is rejected. It is not rounded up, and separate calls do not add up toward the floor. - Paying a 402 accepts the platform's buyer terms. - A paid response carries a `zc-billing` header that states what was charged. A delivered response without that header billed nothing. - A response funded from Credits reports `chargedUsd` and `remainingCreditUsd`. - A Credits purchase sent without a bearer gets `401 bearer_required` before any price is quoted. ## Frequently asked questions ### Does x402stock need an account or API key? No. Pay-as-you-go calls need no signup, key or registration, because each call is settled by its own signed payment. Only buying Credits calls for an agent credential. Anonymous registration takes one call, with no email and no human step, as described in [identity](https://agents.x402stock.xyz/zcj/h3bl6a7l5t82/auth.md). ### How much does x402stock market data cost per request? Each operation has its own price. For example, a stock quote is $0.01. The 402 states the exact amount before you pay anything. The [catalog](https://agents.x402stock.xyz/zcj/h3bl6a7l5t82/manifest.json) lists every live price. ### Can I pay with a card instead of USDC? Yes. A pay-as-you-go call priced at $0.50 or more takes a card directly. For cheaper calls, buy Credits by card from $0.50 through hosted checkout, and each call then draws down the balance. Funds you do not use stay as credit. ### Are the quotes real-time or delayed? Each quote response reports its own timing in the `is_delayed` and `delayed_by` fields, alongside `timestamp` and `as_of`. ### What happens if a payment does not settle? The call returns `settlement_failed`, and `settlementReason` gives the cause, such as `insufficient_funds`. Fix the wallet, then send the request again from the start to get a fresh 402. The [error reference](https://agents.x402stock.xyz/zcj/h3bl6a7l5t82/errors.md) covers every other code. ## Keep reading - [Buyer skill](https://agents.x402stock.xyz/zcj/h3bl6a7l5t82/SKILL.md): the full purchase and recovery flow - [How to pay](https://agents.x402stock.xyz/zcj/h3bl6a7l5t82/payment.md): x402, MPP and card - [Services and pricing](https://agents.x402stock.xyz/zcj/h3bl6a7l5t82/services): the services and their prices - [Identity](https://agents.x402stock.xyz/zcj/h3bl6a7l5t82/auth.md): the bearer credential for Credits --- Updated 2026-10-16. All x402stock guides: https://agents.x402stock.xyz/guides.md. Storefront: https://agents.x402stock.xyz/zcj/h3bl6a7l5t82/llms.txt.