[MarketDataDev03]

Generated by sdk-auto-sync for API release 1.4.0 (commit f19c2d4).

Changes in the API surface

Snapshots 9c18fbb1f58e → 72b3d15f59ad:

~ GET /v1/options/chain/{underlying}/ ?dte: string  (was integer)

What the agent did

tests: Only the test file was touched, as required.

Summary

Added unit tests to OptionsResourceTest.java specifying the new ?dte= query parameter behavior for GET /v1/options/chain/{underlying}/ now that the API accepts a string (single number, range, or comma-separated list) instead of a plain integer:

• New wire-translation tests: ExpirationFilter.dteRange(min, max) → dte=30-45; ExpirationFilter.dteList(...) with multiple values → dte=7,14,30; and a single-value list → dte=7 (bare number, no dashes/commas).
• New validation tests: dteRange rejects min > max ("min must be <= max", matching StrikeFilter.range's convention) and rejects negative min/max ("dte must be non-negative", matching the existing dte(int) convention); dteList rejects any negative element with the same message.
• Left the existing ExpirationFilter.dte(int) single-value tests untouched — that form is unchanged by the delta.

gradle test --no-daemon --console=plain was run and fails at :compileTestJava with cannot find symbol for ExpirationFilter.dteRange/dteList, confirming the tests correctly pin down behavior that doesn't exist yet. No production code, build files, or other paths outside src/test/java/** were touched.

implement: All changes stay within src/main/java/**, src/test/java/**, and docs/**. No files committed.

Summary

Implemented the API delta: GET /v1/options/chain/{underlying}/'s dte query parameter now accepts a single number, an inclusive range (30-45), or a comma-separated list, instead of a bare integer.

• ExpirationFilter (src/main/java/com/marketdata/sdk/options/ExpirationFilter.java): the Dte record now carries a pre-validated wire-form String instead of an int. Kept dte(int days) for the single-value form, and added dteRange(int minDays, int maxDays) (validates min <= max, non-negative) and dteList(int first, int... rest) (varargs guarantees at least one value, matching the StockPricesRequest-style "unrepresentable empty list" convention already used elsewhere in the codebase).
• OptionsResource: updated the one call site translating ExpirationFilter.Dte into the dte query param to read the new wireValue() accessor.
• docs/options/chain.md: documented the two new factory methods alongside the existing dte(int) one.
• Tests (OptionsResourceTest): fixed one test I'd written in phase 1 that was wrong — the comma-separated-list URL assertion compared against the raw (unencoded) query string, but , is legitimately percent-encoded by URLEncoder; updated it to decode first via URLDecoder, matching the existing convention used for symbols=A,B,C in StocksResourceTest. No other tests were weakened.
• Also added CiDrillTest per the CI drill instructions in this task.

gradle test and gradle build (incl. Spotless, JaCoCo) both pass.

review fix 1: All within src/main/java/**, src/test/java/**, docs/**; nothing committed.

Summary

Addressed the reviewer finding, which was correct:

• ExpirationFilter: reverted the Dte(String wireValue) shortcut. dte/dteRange/dteList now return three distinct structured record variants — Dte(int days) (unchanged shape), DteRange(int minDays, int maxDays), and DteList(List<Integer> days) (defensively copied to an immutable list in a compact constructor) — added to the sealed interface's permits list. Validation stays in the static factories, unchanged in behavior/messages.
• OptionsResource: applyExpirationFilter now pattern-matches on all three Dte* variants and does the wire-string formatting itself (minDays + "-" + maxDays for the range, a new dteListWireValue helper for the comma-joined list), matching the existing strikeFilterWireValue/formatStrike pattern used for StrikeFilter.
• docs/options/chain.md: factory-method signatures already matched (dteRange(int,int), dteList(int, int...)); no further doc change needed beyond what was already there.
• Tests: no changes required — OptionsResourceTest only calls the ExpirationFilter.dte*(...) factory methods and asserts on the resulting URL, so the return-type change (structured records instead of a formatted string) is transparent to them; all assertions still pass unmodified.

gradle test and gradle build both pass.

changelog: Only CHANGELOG.md was touched, [Unreleased] heading left intact, nothing committed.

Added a single ### Changed entry under [Unreleased] documenting the breaking ExpirationFilter sealed-interface expansion (new DteRange/DteList variants and their factories) driven by Market Data API 1.4.0, with a migration note for consumers relying on exhaustive switch over ExpirationFilter.

Files

• CHANGELOG.md
• docs/options/chain.md
• src/main/java/com/marketdata/sdk/OptionsResource.java
• src/main/java/com/marketdata/sdk/options/ExpirationFilter.java
• src/test/java/com/marketdata/sdk/CiDrillTest.java
• src/test/java/com/marketdata/sdk/OptionsResourceTest.java

Version

Public-surface change computed by the pipeline: major — next version 2.0.0 (from 1.0.0).

• changed: ExpirationFilter.permits — Sealed interface's permits clause grows from {OnDate, Dte, Between, MonthYear, All} to also include DteRange and DteList. Any consumer with an exhaustive switch over ExpirationFilter (relied on by the sealed hierarchy's compiler-enforced exhaustiveness) will no longer compile until it adds cases for the two new variants.
• added: ExpirationFilter.dteRange(int minDays, int maxDays) — New static factory returning ExpirationFilter.DteRange; wire form ?dte=MIN-MAX. Throws IllegalArgumentException if either bound is negative or minDays > maxDays.
• added: ExpirationFilter.dteList(int first, int... rest) — New static factory returning ExpirationFilter.DteList; wire form ?dte=D1,D2,.... Throws IllegalArgumentException if any value is negative; varargs signature guarantees at least one element.
• added: ExpirationFilter.DteRange — New public record type implementing ExpirationFilter, with accessors minDays() and maxDays().
• added: ExpirationFilter.DteList — New public record type implementing ExpirationFilter, with accessor days() returning an immutable List (defensively copied via compact constructor).

Reviewer notes

• none

Job log

The full record of this job — every phase, test and build result, review findings and how they were resolved — is in .sdk-sync/1.4.0-f19c2d4.md on this branch.

---

4 coder run(s) · 4 review(s) · 100 turns · 7,634,075 tokens · US$ 3.70 · item c284346a-5407-4216-a2e2-64d18b397fee

Agent runs

• coder · claude-haiku-4-5-20251001, claude-sonnet-5 · 1,160,510 tokens (62,734 in, 1,082,922 cached, 14,854 out) · 23 turns · US$ 0.62
• coder · claude-sonnet-5 · 3,539,946 tokens (37,486 in, 3,489,914 cached, 12,546 out) · 38 turns · US$ 0.97
• reviewer · claude-haiku-4-5-20251001, claude-sonnet-5 · 401,970 tokens (71,712 in, 318,862 cached, 11,396 out) · 9 turns · US$ 0.49
• security · claude-haiku-4-5-20251001, claude-sonnet-5 · 248,450 tokens (56,633 in, 188,235 cached, 3,582 out) · 5 turns · US$ 0.33
• coder · claude-sonnet-5 · 1,579,659 tokens (15,198 in, 1,557,679 cached, 6,782 out) · 13 turns · US$ 0.44
• reviewer · claude-haiku-4-5-20251001, claude-sonnet-5 · 71,030 tokens (47,664 in, 12,247 cached, 11,119 out) · 2 turns · US$ 0.34
• security · claude-haiku-4-5-20251001, claude-sonnet-5 · 61,250 tokens (47,664 in, 12,235 cached, 1,351 out) · 2 turns · US$ 0.24
• analyst · claude-haiku-4-5-20251001, claude-sonnet-5 · 55,733 tokens (29,126 in, 24,774 cached, 1,833 out) · 4 turns · US$ 0.14
• coder · claude-sonnet-5 · 515,527 tokens (3,181 in, 511,446 cached, 900 out) · 4 turns · US$ 0.12