fix: stale JSON docs, missing Python Greeks fields, stale CGo declaration

- docs/api-reference.md: removed false claim that tdx_fpss_next_event
  returns JSON -- it returns *mut TdxFpssEvent since PR #89
- ffi/README.md: same correction
- sdks/go/client.go: fixed stale CGo declaration (char* -> TdxFpssEvent*)
- sdks/python/src/lib.rs: added 15 missing Greeks fields to
  greeks_tick_to_dict (vanna, charm, vomma, veta, speed, zomma, color,
  ultima, d1, d2, dual_delta, dual_gamma, epsilon, lambda, vera)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: userFRM

docs/api-reference.md

@@ -663,7 +663,7 @@ ThetaDataDx exposes **61 typed methods** (plus 4 `_stream` variants) covering al
 
 All 61 endpoints are exposed through the `thetadatadx-ffi` C ABI crate. Each method has a corresponding `extern "C"` function (e.g., `thetadatadx_stock_history_eod`). The Go and C++ SDKs wrap these FFI functions 1:1.
 
-**No JSON crosses the FFI boundary for historical data, snapshots, or subscriptions.** All inputs and outputs for these endpoints use typed `#[repr(C)]` structs. The sole exception is `tdx_fpss_next_event`, which returns a pre-formatted JSON string for real-time streaming events:
+**No JSON crosses the FFI boundary.** All inputs and outputs use typed `#[repr(C)]` structs -- historical endpoints, streaming events, Greeks, and subscriptions alike. `tdx_fpss_next_event` and `tdx_unified_next_event` return `*mut TdxFpssEvent` (a tagged `#[repr(C)]` struct with quote/trade/open_interest/ohlcvc/control/raw_data variants), freed with `tdx_fpss_event_free`.
 
 - **Bulk snapshot endpoints** (stock/index snapshot OHLC, trade, quote, market value, price) accept `symbols: *const *const c_char, symbols_len: usize` — a C array of C string pointers with a length.
 - **`tdx_all_greeks`** returns `*mut TdxGreeksResult` (22 `f64` fields). Caller frees with `tdx_greeks_result_free`.

ffi/README.md

@@ -74,7 +74,7 @@ All 61 endpoints are available as `tdx_stock_*`, `tdx_option_*`, `tdx_index_*`,
 | `tdx_fpss_is_authenticated` | Check if FPSS is authenticated |
 | `tdx_fpss_contract_lookup` | Look up contract by ID |
 | `tdx_fpss_active_subscriptions` | List active subscriptions (typed `TdxSubscriptionArray`) |
-| `tdx_fpss_next_event` | Poll for next event (JSON, blocks with timeout) |
+| `tdx_fpss_next_event` | Poll for next event (`*mut TdxFpssEvent`, blocks with timeout) |
 | `tdx_fpss_shutdown` | Shut down FPSS client |
 | `tdx_fpss_free` | Free the FPSS handle |
 
@@ -87,7 +87,7 @@ All functions that can fail return null on error. Call `tdx_last_error()` to get
 - Opaque handles are heap-allocated via `Box::into_raw`, freed via `Box::from_raw` in the corresponding `*_free` function.
 - Data endpoints return typed `#[repr(C)]` struct arrays (e.g. `TdxEodTickArray { data, len }`) - free with the corresponding `tdx_*_array_free` function.
 - List endpoints return `TdxStringArray` - free with `tdx_string_array_free`.
-- `tdx_fpss_next_event` returns `*mut c_char` (JSON string) - free with `tdx_string_free`.
+- `tdx_fpss_next_event` / `tdx_unified_next_event` return `*mut TdxFpssEvent` (tagged `#[repr(C)]` struct) - free with `tdx_fpss_event_free`.
 - `tdx_fpss_active_subscriptions` returns `*mut TdxSubscriptionArray` - free with `tdx_subscription_array_free`.
 - `tdx_last_error()` returns a borrowed pointer - do NOT free it.
 - `tdx_unified_historical()` returns a borrowed pointer - do NOT free it.

sdks/go/client.go

@@ -154,7 +154,8 @@ extern int tdx_fpss_is_authenticated(const TdxFpssHandle* h);
 extern char* tdx_fpss_contract_lookup(const TdxFpssHandle* h, int id);
 extern TdxSubscriptionArray* tdx_fpss_active_subscriptions(const TdxFpssHandle* h);
 extern void tdx_subscription_array_free(TdxSubscriptionArray* arr);
-extern char* tdx_fpss_next_event(const TdxFpssHandle* h, uint64_t timeout_ms);
+extern TdxFpssEvent* tdx_fpss_next_event(const TdxFpssHandle* h, uint64_t timeout_ms);
+extern void tdx_fpss_event_free(TdxFpssEvent* event);
 extern void tdx_fpss_shutdown(const TdxFpssHandle* h);
 extern void tdx_fpss_free(TdxFpssHandle* h);
 */

sdks/python/src/lib.rs

@@ -261,6 +261,21 @@ fn greeks_tick_to_dict(py: Python<'_>, t: &tick::GreeksTick) -> Py<PyAny> {
     dict.set_item("vega", t.vega).unwrap();
     dict.set_item("rho", t.rho).unwrap();
     dict.set_item("iv_error", t.iv_error).unwrap();
+    dict.set_item("vanna", t.vanna).unwrap();
+    dict.set_item("charm", t.charm).unwrap();
+    dict.set_item("vomma", t.vomma).unwrap();
+    dict.set_item("veta", t.veta).unwrap();
+    dict.set_item("speed", t.speed).unwrap();
+    dict.set_item("zomma", t.zomma).unwrap();
+    dict.set_item("color", t.color).unwrap();
+    dict.set_item("ultima", t.ultima).unwrap();
+    dict.set_item("d1", t.d1).unwrap();
+    dict.set_item("d2", t.d2).unwrap();
+    dict.set_item("dual_delta", t.dual_delta).unwrap();
+    dict.set_item("dual_gamma", t.dual_gamma).unwrap();
+    dict.set_item("epsilon", t.epsilon).unwrap();
+    dict.set_item("lambda", t.lambda).unwrap();
+    dict.set_item("vera", t.vera).unwrap();
     dict.set_item("date", t.date).unwrap();
     set_contract_id!(dict, t);
     dict.into_any().unbind()