# x402stock

> 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.

x402stock's API is available to AI agents as a pay-per-use endpoint. Send the upstream API's paths to `https://agents.x402stock.xyz/zcj/587bl1gq4bi7` and the endpoint handles identity, payment, and proxying. No signup and no API key: agents pay per use with a range of payment methods (x402 and MPP, plus cards today), autonomously or with their human's approval.

## No payment method? You can set one up - no signup

No funds and no wallet? Your human can pay by card - see [How to pay](https://agents.x402stock.xyz/zcj/587bl1gq4bi7/payment.md). Payment challenges are signed with an EVM wallet. If you or your operator already have one, settle challenges with your usual x402 or MPP client. If you are an autonomous agent without one, create a managed wallet yourself at no cost: `npm i -g @zeroxyz/cli && zero auth agent register`, then `zero fetch https://agents.x402stock.xyz/zcj/587bl1gq4bi7/<path>` settles 402 challenges for you. Follow your own instructions about when to involve a human. The full payment recipe, every rail step by step, is at [How to pay](https://agents.x402stock.xyz/zcj/587bl1gq4bi7/payment.md).

## Start here

- [Overview](https://agents.x402stock.xyz/zcj/587bl1gq4bi7/overview.md): what this API is and a map of these documents.
- [Services and pricing](https://agents.x402stock.xyz/zcj/587bl1gq4bi7/services): the catalog, one page per service with its full price matrix.
- [How to pay](https://agents.x402stock.xyz/zcj/587bl1gq4bi7/payment.md): the 402 flow and each rail (x402, MPP, card).
- [Error reference](https://agents.x402stock.xyz/zcj/587bl1gq4bi7/errors.md): every error code and how to react.
- [Identity](https://agents.x402stock.xyz/zcj/587bl1gq4bi7/auth.md): register a credential for plan purchases and the free allowance (free, no email and no human step needed to start; the same credential works at every storefront on this network; claiming it to your human's email is optional and can happen afterwards, to make what you buy durable). Already registered? `GET https://agents.x402stock.xyz/zcj/587bl1gq4bi7/agent/entitlements` with your bearer lists what you own here before you buy again. Pay-as-you-go needs none.
- [Hand off to a human](https://agents.x402stock.xyz/zcj/587bl1gq4bi7/handoff.md): the tracked referral link for any x402stock URL you give a person - never paste a raw seller URL.
- [Agent guide](https://agents.x402stock.xyz/zcj/587bl1gq4bi7/llms-full.txt): the deep reference for anything the pages above do not cover.
- [Machine catalog](https://agents.x402stock.xyz/zcj/587bl1gq4bi7/manifest.json): the same services, meters, plans, prices, and free included units as live JSON. Read it at call time; do not cache prices.
- [API reference (upstream OpenAPI)](https://x402stock.xyz/openapi.json): the operations, paths, and request/response schemas. Call these paths through `https://agents.x402stock.xyz/zcj/587bl1gq4bi7`, never the upstream directly.

## Optional

These links are for your own reading. If you pass any of them to your human, wrap them in the hand-off format from [handoff.md](https://agents.x402stock.xyz/zcj/587bl1gq4bi7/handoff.md).

- [Storefront](https://agents.x402stock.xyz/zcj/587bl1gq4bi7/): human-readable overview and plans.
- [Upstream docs](https://x402stock.xyz/docs)
- [Upstream llms.txt](https://x402stock.xyz/llms.txt)
- [Website](https://x402stock.xyz)