# x402stock Conditions Reference

> x402stock Conditions Reference is a paid API for AI agents from x402stock.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-13).

Returns the list of known trade/sale condition codes used in US stock market data, including their names, types, data types, and SIP mappings.

## Facts

- Endpoint: GET https://x402stock.vercel.app/api/v1/conditions?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-conditions-reference-d91eadb0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cXXl1VNVefwP7XgO97kRT

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability x402stock-conditions-reference-d91eadb0
```

Example prompt: Can you pull the full list of US stock market trade condition codes from x402stock, including their names, types, and SIP UTP mappings? I want to decode what condition code 'A' means in trade data.

## When to prefer this

Use this endpoint when you need to decode or enumerate trade/sale condition codes from US equity market data feeds, especially when you need the SIP (UTP/CTA) letter-code mappings. Prefer this over general financial APIs when you want no-account, pay-per-request access with USDC.

## Known failure modes

- Payment not processed (402): USDC payment via x402 was not completed or was invalid
- Invalid filter parameters (400): Unrecognized query parameters passed
- Service unavailable (503): Upstream data provider (Massive) is unreachable
- Empty result: No conditions match the specified filter criteria

## How this service works

Reference catalog of trade/quote condition codes (the numeric `conditions` seen on trades) with names, types, data types, and SIP mappings. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.

## Output

A JSON object containing a timestamp (as_of), a count of conditions, the data source, and an array of condition objects each with an id, name, type (e.g. sale_condition), applicable data_types (e.g. trade, quote), and sip_mapping entries for UTP and/or CTA codes.

## Example request

```json
{}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-05-29T20:00:00.000Z",
  "count": 1,
  "source": "massive",
  "conditions": [
   {
    "id": 1,
    "name": "Acquisition",
    "type": "sale_condition",
    "data_types": [
     "trade"
    ],
    "sip_mapping": {
     "UTP": "A"
    }
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-conditions-reference-d91eadb0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.vercel.app](https://www.zero.xyz/host/x402stock.vercel.app/llms.txt)