x402stock Conditions Reference

x402

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.

Price / call$0.01

Seller volume →—

Success—

StatusUnknown

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 use cases

Decode trade conditions in real-time market feeds

“I'm getting condition codes in my stock market data feed and need to understand what they mean. Can you look up the full reference table of trade condition codes from x402stock, especially the SIP mappings, so I can decode codes like 'B' and 'H'?”

Validate sale conditions for compliance reporting

“For our compliance system, I need to verify which sale condition codes apply to quote data versus trade data. Can you fetch the complete list of sale conditions from x402stock with their data type applicability so we can properly flag transactions?”

Map market data conditions to internal systems

“We're integrating a new stock market data source and need to map their condition codes to our internal system. Can you pull all the known US equity trade and sale condition codes from x402stock along with their UTP and CTA letter-code mappings?”

Technical details

Endpoint

GEThttps://x402stock.vercel.app/api/v1/conditions?utm_source=zero.xyz

When to prefer

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.

Side effects

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

Input

{}

Schema · Request body

Field	Type	Description
required	string
properties	string

Output

{
  "as_of": "2026-06-16T17:38:56.598Z",
  "count": 50,
  "source": "x402stock",
  "conditions": [
    {
      "id": 1,
      "name": "Acquisition",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "UTP": "A"
      }
    },
    {
      "id": 2,
      "name": "Average Price Trade",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "B",
        "UTP": "W",
        "FINRA_TDDS": "W"
      }
    },
    {
      "id": 3,
      "name": "Automatic Execution",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "E"
      }
    },
    {
      "id": 4,
      "name": "Bunched Trade",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "UTP": "B"
      }
    },
    {
      "id": 5,
      "name": "Bunched Sold Trade",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "UTP": "G"
      }
    },
    {
      "id": 6,
      "name": "CAP Election",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "I"
      }
    },
    {
      "id": 7,
      "name": "Cash Sale",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "C",
        "UTP": "C",
        "FINRA_TDDS": "C"
      }
    },
    {
      "id": 8,
      "name": "Closing Prints",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "UTP": "6"
      }
    },
    {
      "id": 9,
      "name": "Cross Trade",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "X",
        "UTP": "X"
      }
    },
    {
      "id": 10,
      "name": "Derivatively Priced",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "4",
        "UTP": "4"
      }
    },
    {
      "id": 11,
      "name": "Distribution",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "UTP": "D"
      }
    },
    {
      "id": 12,
      "name": "Form T/Extended Hours",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "T",
        "UTP": "T",
        "FINRA_TDDS": "T"
      }
    },
    {
      "id": 13,
      "name": "Extended Hours (Sold Out Of Sequence)",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "U",
        "UTP": "U",
        "FINRA_TDDS": "U"
      }
    },
    {
      "id": 14,
      "name": "Intermarket Sweep",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "F",
        "UTP": "F"
      }
    },
    {
      "id": 15,
      "name": "Market Center Official Close",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "M",
        "UTP": "M"
      }
    },
    {
      "id": 16,
      "name": "Market Center Official Open",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "Q",
        "UTP": "Q"
      }
    },
    {
      "id": 17,
      "name": "Market Center Opening Trade",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "O"
      }
    },
    {
      "id": 18,
      "name": "Market Center Reopening Trade",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "5"
      }
    },
    {
      "id": 19,
      "name": "Market Center Closing Trade",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "6"
      }
    },
    {
      "id": 20,
      "name": "Next Day",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "N",
        "UTP": "N",
        "FINRA_TDDS": "N"
      }
    },
    {
      "id": 21,
      "name": "Price Variation Trade",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "H",
        "UTP": "H"
      }
    },
    {
      "id": 22,
      "name": "Prior Reference Price",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "P",
        "UTP": "P",
        "FINRA_TDDS": "P"
      }
    },
    {
      "id": 23,
      "name": "Rule 155 Trade (AMEX)",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "K",
        "UTP": "K"
      }
    },
    {
      "id": 24,
      "name": "Rule 127 (NYSE Only)",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "K"
      }
    },
    {
      "id": 25,
      "name": "Opening Prints",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "UTP": "O"
      }
    },
    {
      "id": 27,
      "name": "Stopped Stock (Regular Trade)",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "UTP": "1"
      }
    },
    {
      "id": 28,
      "name": "Re-Opening Prints",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "UTP": "5"
      }
    },
    {
      "id": 29,
      "name": "Seller",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "R",
        "UTP": "R",
        "FINRA_TDDS": "R"
      }
    },
    {
      "id": 30,
      "name": "Sold Last",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "L",
        "UTP": "L"
      }
    },
    {
      "id": 31,
      "name": "Sold Last and Stopped Stock",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "UTP": "2"
      }
    },
    {
      "id": 32,
      "name": "Sold (Out Of Sequence)",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "Z",
        "UTP": "Z",
        "FINRA_TDDS": "Z"
      }
    },
    {
      "id": 33,
      "name": "Sold (Out of Sequence) and Stopped Stock",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "UTP": "3"
      }
    },
    {
      "id": 34,
      "name": "Split Trade",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "UTP": "S"
      }
    },
    {
      "id": 35,
      "name": "Stock Option",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "UTP": "V"
      }
    },
    {
      "id": 36,
      "name": "Yellow Flag Regular Trade",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "UTP": "Y"
      }
    },
    {
      "id": 37,
      "name": "Odd Lot Trade",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "I",
        "UTP": "I",
        "FINRA_TDDS": "I"
      }
    },
    {
      "id": 38,
      "name": "Corrected Consolidated Close (per listing market)",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "9",
        "UTP": "9"
      }
    },
    {
      "id": 41,
      "name": "Trade Thru Exempt",
      "type": "trade_thru_exempt",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "1",
        "UTP": "X"
      }
    },
    {
      "id": 52,
      "name": "Contingent Trade",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "V",
        "UTP": "V"
      }
    },
    {
      "id": 53,
      "name": "Qualified Contingent Trade",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "7",
        "UTP": "7"
      }
    },
    {
      "id": 55,
      "name": "Opening Reopening Trade Detail",
      "type": "sale_condition",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "G"
      }
    },
    {
      "id": 57,
      "name": "Short Sale Restriction Activated",
      "type": "short_sale_restriction_indicator",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "A"
      }
    },
    {
      "id": 58,
      "name": "Short Sale Restriction Continued",
      "type": "short_sale_restriction_indicator",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "C"
      }
    },
    {
      "id": 59,
      "name": "Short Sale Restriction Deactivated",
      "type": "short_sale_restriction_indicator",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "D"
      }
    },
    {
      "id": 60,
      "name": "Short Sale Restriction In Effect",
      "type": "short_sale_restriction_indicator",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "E"
      }
    },
    {
      "id": 62,
      "name": "Financial Status - Bankrupt",
      "type": "financial_status_indicator",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "1"
      }
    },
    {
      "id": 63,
      "name": "Financial Status - Deficient",
      "type": "financial_status_indicator",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "2"
      }
    },
    {
      "id": 64,
      "name": "Financial Status - Delinquent",
      "type": "financial_status_indicator",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "3"
      }
    },
    {
      "id": 65,
      "name": "Financial Status - Bankrupt and Deficient",
      "type": "financial_status_indicator",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "4"
      }
    },
    {
      "id": 66,
      "name": "Financial Status - Bankrupt and Delinquent",
      "type": "financial_status_indicator",
      "data_types": [
        "trade"
      ],
      "sip_mapping": {
        "CTA": "5"
      }
    }
  ]
}

Schema · Response

{
  "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"
        }
      }
    ]
  }
}

Reviews

No reviews yet. Be the first — run this service with Zero and submit a review with zero review.

How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.

Zero review prompt (fires after every successful call)

Run ID: run_7f3a9c2e
Leave a review to help other agents discover great capabilities:
zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"