# x402stock.xyz Trade/Quote Condition Codes Reference

> x402stock.xyz Trade/Quote Condition Codes Reference is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns a reference catalog of trade and quote condition codes used on US equity trades, including their numeric IDs, names, types, data types, and SIP mappings.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/conditions
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-xyz-8c0be15a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RKWG4pSYW60iy8yz14yS8

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-xyz-8c0be15a
```

Example prompt: Can you pull the full catalog of US equity trade and quote condition codes — the ones with numeric IDs, names, types, and SIP mappings — so I can decode the conditions field on my trade data? Give me up to 200 of them.

## When to prefer this

Use this endpoint when you need to decode or understand the numeric `conditions` field present on US equity trade or quote records from market data feeds. It is the authoritative reference catalog for condition code metadata including SIP mappings, making it ideal for building decoders, enriching trade data, or populating lookup tables in financial analytics pipelines.

## Known failure modes

- limit parameter <= 0 returns validation error
- limit exceeds 1000 returns validation error
- No conditions found returns empty array with count 0
- Payment not provided or failed returns 402 Payment Required
- Service unavailable returns 5xx error

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

An array of condition code objects, each containing a numeric ID, name, type string, data_types array, and SIP mapping object. Also includes a source identifier ('massive'), an as_of timestamp, and a count of returned conditions.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "limit": 50
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "limit"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "default": 50,
       "maximum": 1000,
       "exclusiveMinimum": 0
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "source",
      "as_of",
      "count",
      "conditions"
     ],
     "properties": {
      "as_of": {
       "type": "string"
      },
      "count": {
       "type": "number"
      },
      "source": {
       "type": "string",
       "const": "x402stock"
      },
      "conditions": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "id",
         "type",
         "name",
         "data_types",
         "sip_mapping"
        ],
        "properties": {
         "id": {
          "type": "number"
         },
         "name": {
          "type": "string"
         },
         "type": {
          "type": "string"
         },
         "data_types": {
          "type": "array",
          "items": {
           "type": "string"
          }
         },
         "sip_mapping": {
          "type": "object",
          "propertyNames": {
           "type": "string"
          },
          "additionalProperties": {
           "type": "string"
          }
         }
        },
        "additionalProperties": false
       }
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-05-29T20:00:00.000Z",
  "count": 1,
  "source": "x402stock",
  "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-xyz-8c0be15a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)