{"uid":"cap_cXXl1VNVefwP7XgO97kRT","slug":"x402stock-conditions-reference-d91eadb0","name":"x402stock Conditions 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.vercel.app/api/v1/conditions?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"required":{"type":"string"},"properties":{"type":"string"}}},"responseSchema":{"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"}}]}},"example":{"request":{},"response":{"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"}}]}},"exampleRequest":{},"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_pJm-ojtnc2WR6gjXmKI1d","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 the list of known trade/sale condition codes used in US stock market data, including their names, types, data types, and SIP mappings.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Decode trade conditions in real-time market feeds","prompt":"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'?"},{"title":"Validate sale conditions for compliance reporting","prompt":"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?"},{"title":"Map market data conditions to internal systems","prompt":"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?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T00:35:34.711Z","isFirstParty":false,"canonicalSlug":"x402stock-conditions-reference-d91eadb0"}