{"uid":"cap_RKWG4pSYW60iy8yz14yS8","slug":"x402stock-xyz-8c0be15a","name":"x402stock.xyz Trade/Quote Condition Codes Reference","description":"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.","url":"https://x402stock.xyz/api/v1/conditions","method":"GET","headers":{},"bodySchema":{"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}}}}},"responseSchema":{"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"}}]}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"limit":50}}},"response":{"as_of":"2026-06-12T03:08:23.030Z","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"}}]}},"exampleRequest":{"limit":50},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__plrUgYBzRQCb6u3eu8Mw","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Decode trade condition flags from market feed","prompt":"I'm building a real-time trade processor and I need to understand what all those numeric condition codes mean on the trades coming from our market data feed. Can you pull the full reference catalog with the names, types, and SIP mappings so I can set up a lookup decoder?"},{"title":"Populate analytics pipeline lookup table","prompt":"We're setting up a data warehouse for equity trades and I need to load the condition codes reference table so we can enrich our raw trade records with human-readable condition names. Pull the complete catalog with all the metadata — numeric IDs, types, data types, everything."},{"title":"Debug quote condition code meanings","prompt":"Our risk monitoring dashboard is showing numeric condition codes on quotes that our team doesn't understand. Can you get me the full list of quote condition codes with their names and what they mean so we can properly interpret what's happening in the market data?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:50:06.334Z","isFirstParty":false}