addedOutput schema / properties / data / items / properties / instrument
Added value: +{
+ "additionalProperties": false,
+ "description": "Additive projection from the filing's printed asset and description. Every absent or conflicting ticker or option term has a named reason. It is not an order instruction or a securities-master lookup; the original asset fields remain unchanged.",
+ "properties": {
+ "contracts": {
+ "anyOf": [
+ {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Explicit count of options or contracts. Shares and units are never converted, nor is a partial-sale count calculated from holdings."
+ },
+ "expiration": {
+ "anyOf": [
+ {
+ "minLength": 1,
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Date as printed, not necessarily ISO. Two-digit years retain two digits; no century or missing day is inferred. See field_evidence.expiration.reason."
+ },
+ "field_evidence": {
+ "additionalProperties": false,
+ "description": "Required per-field evidence for every option field, including missing fields and non-option rows.",
+ "properties": {
+ "contracts": {
+ "additionalProperties": false,
+ "description": "Explicit option/contract-count spans plus any share/unit spans. Describes quantity ambiguity without conversions or arithmetic.",
+ "properties": {
+ "raw": {
+ "description": "Matched filing-text spans, retaining competing values and printed share/unit counts. Empty when no applicable evidence was found.",
+ "items": {
+ "minLength": 1,
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "reason": {
+ "description": "Named extraction rule or refusal reason; always present, including when the value is null.",
+ "minLength": 1,
+ "type": "string"
+ },
+ "status": {
+ "description": "Whether this value is explicitly printed, absent, ambiguous, invalid or inapplicable to a non-option line.",
+ "enum": [
+ "printed",
+ "missing",
+ "ambiguous",
+ "invalid",
+ "not_applicable"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "reason",
+ "raw"
+ ],
+ "type": "object"
+ },
+ "expiration": {
+ "additionalProperties": false,
+ "description": "Printed expiration span and date-format/refusal rule. A two-digit year is identified explicitly and not expanded.",
+ "properties": {
+ "raw": {
+ "description": "Matched filing-text spans, retaining competing values and printed share/unit counts. Empty when no applicable evidence was found.",
+ "items": {
+ "minLength": 1,
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "reason": {
+ "description": "Named extraction rule or refusal reason; always present, including when the value is null.",
+ "minLength": 1,
+ "type": "string"
+ },
+ "status": {
+ "description": "Whether this value is explicitly printed, absent, ambiguous, invalid or inapplicable to a non-option line.",
+ "enum": [
+ "printed",
+ "missing",
+ "ambiguous",
+ "invalid",
+ "not_applicable"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "reason",
+ "raw"
+ ],
+ "type": "object"
+ },
+ "option_type": {
+ "additionalProperties": false,
+ "description": "Printed call/put evidence, conflict or absence.",
+ "properties": {
+ "raw": {
+ "description": "Matched filing-text spans, retaining competing values and printed share/unit counts. Empty when no applicable evidence was found.",
+ "items": {
+ "minLength": 1,
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "reason": {
+ "description": "Named extraction rule or refusal reason; always present, including when the value is null.",
+ "minLength": 1,
+ "type": "string"
+ },
+ "status": {
+ "description": "Whether this value is explicitly printed, absent, ambiguous, invalid or inapplicable to a non-option line.",
+ "enum": [
+ "printed",
+ "missing",
+ "ambiguous",
+ "invalid",
+ "not_applicable"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "reason",
+ "raw"
+ ],
+ "type": "object"
+ },
+ "strike": {
+ "additionalProperties": false,
+ "description": "Exact printed strike span, or the missing, malformed or conflicting-price reason.",
+ "properties": {
+ "raw": {
+ "description": "Matched filing-text spans, retaining competing values and printed share/unit counts. Empty when no applicable evidence was found.",
+ "items": {
+ "minLength": 1,
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "reason": {
+ "description": "Named extraction rule or refusal reason; always present, including when the value is null.",
+ "minLength": 1,
+ "type": "string"
+ },
+ "status": {
+ "description": "Whether this value is explicitly printed, absent, ambiguous, invalid or inapplicable to a non-option line.",
+ "enum": [
+ "printed",
+ "missing",
+ "ambiguous",
+ "invalid",
+ "not_applicable"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "reason",
+ "raw"
+ ],
+ "type": "object"
+ },
+ "underlying": {
+ "additionalProperties": false,
+ "description": "Printed underlying name/label evidence or why an underlying was withheld.",
+ "properties": {
+ "raw": {
+ "description": "Matched filing-text spans, retaining competing values and printed share/unit counts. Empty when no applicable evidence was found.",
+ "items": {
+ "minLength": 1,
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "reason": {
+ "description": "Named extraction rule or refusal reason; always present, including when the value is null.",
+ "minLength": 1,
+ "type": "string"
+ },
+ "status": {
+ "description": "Whether this value is explicitly printed, absent, ambiguous, invalid or inapplicable to a non-option line.",
+ "enum": [
+ "printed",
+ "missing",
+ "ambiguous",
+ "invalid",
+ "not_applicable"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "reason",
+ "raw"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "underlying",
+ "option_type",
+ "strike",
+ "expiration",
+ "contracts"
+ ],
+ "type": "object"
+ },
+ "kind": {
+ "description": "Instrument category supported by the printed code or text. Option mentions include exercised options even where the original source code is ST. Other means unclassified, not a guessed equity.",
+ "enum": [
+ "equity",
+ "option",
+ "etf",
+ "bond",
+ "fund",
+ "crypto",
+ "other"
+ ],
+ "type": "string"
+ },
+ "kind_reason": {
+ "description": "Named source-code or printed-text rule used to classify this line.",
+ "minLength": 1,
+ "type": "string"
+ },
+ "option_type": {
+ "anyOf": [
+ {
+ "enum": [
+ "call",
+ "put"
+ ],
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Call or put only when printed as the option type. Conflicting types and unlabelled verbs produce null."
+ },
+ "strike": {
+ "anyOf": [
+ {
+ "pattern": "^\\d+(?:\\.\\d+)?$",
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Exact printed decimal strike, with grouping separators and dollar sign removed. String avoids binary floating-point rounding. Currency is not inferred."
+ },
+ "ticker": {
+ "anyOf": [
+ {
+ "minLength": 1,
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Single printed symbol, uppercased without joining tokens. An explicit ticker label or security-named parenthetical may resolve a blank ticker field; issuer names alone never do. Not a guarantee of an executable option-series identifier."
+ },
+ "ticker_reason": {
+ "description": "Exact ticker-resolution rule or named missing/ambiguous reason. Never empty, including for untickered assets.",
+ "minLength": 1,
+ "type": "string"
+ },
+ "ticker_status": {
+ "description": "Distinguishes the original printed ticker field, a symbol resolved from explicit asset text, and missing, conflicting or malformed evidence.",
+ "enum": [
+ "printed",
+ "resolved_from_printed_text",
+ "missing",
+ "ambiguous",
+ "invalid"
+ ],
+ "type": "string"
+ },
+ "underlying": {
+ "anyOf": [
+ {
+ "minLength": 1,
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Explicitly labelled underlying or the printed stock name on an option-related line. Never decoded from the ticker or resolved from an issuer lookup."
+ }
+ },
+ "required": [
+ "kind",
+ "kind_reason",
+ "ticker",
+ "ticker_status",
+ "ticker_reason",
+ "underlying",
+ "option_type",
+ "strike",
+ "expiration",
+ "contracts",
+ "field_evidence"
+ ],
+ "type": "object"
+}