diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/-/U/J1OwmkVv1doi-8YWLodw b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/-/U/J1OwmkVv1doi-8YWLodw new file mode 100644 index 00000000..b2658400 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/-/U/J1OwmkVv1doi-8YWLodw differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/1/X/s8SLXAO7WCFMPRoCWfGQ b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/1/X/s8SLXAO7WCFMPRoCWfGQ new file mode 100644 index 00000000..b63657ad Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/1/X/s8SLXAO7WCFMPRoCWfGQ differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/2/5/JRT1ixNCdNgqmM1S0RyQ b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/2/5/JRT1ixNCdNgqmM1S0RyQ new file mode 100644 index 00000000..0b9c9734 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/2/5/JRT1ixNCdNgqmM1S0RyQ differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/2/U/WduoJ8ZTtfaaHEZE9GEw b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/2/U/WduoJ8ZTtfaaHEZE9GEw new file mode 100644 index 00000000..e7ac9743 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/2/U/WduoJ8ZTtfaaHEZE9GEw differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/4/D/gM59oGrKCRDWe5B91zlQ b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/4/D/gM59oGrKCRDWe5B91zlQ new file mode 100644 index 00000000..b949e867 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/4/D/gM59oGrKCRDWe5B91zlQ differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/5/H/F1QS0XUs0IikyrzRKheg b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/5/H/F1QS0XUs0IikyrzRKheg new file mode 100644 index 00000000..bf66eb38 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/5/H/F1QS0XUs0IikyrzRKheg differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/5/T/Ju344ppxrNKSDhHPivzw b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/5/T/Ju344ppxrNKSDhHPivzw new file mode 100644 index 00000000..f4b98a22 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/5/T/Ju344ppxrNKSDhHPivzw differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/7/E/ppR9TJ3gHk+q5VKtEbbA b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/7/E/ppR9TJ3gHk+q5VKtEbbA new file mode 100644 index 00000000..32ef17db Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/7/E/ppR9TJ3gHk+q5VKtEbbA differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/8/5/lJ2mKvvoqD0NcowW8N1g b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/8/5/lJ2mKvvoqD0NcowW8N1g new file mode 100644 index 00000000..a35fa19d Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/8/5/lJ2mKvvoqD0NcowW8N1g differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/8/F/oMjGOoaT8ClKcWU6z7lg b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/8/F/oMjGOoaT8ClKcWU6z7lg new file mode 100644 index 00000000..991ef9e9 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/8/F/oMjGOoaT8ClKcWU6z7lg differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/9/J/HoAzOaLZJdEIze4NTI8w b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/9/J/HoAzOaLZJdEIze4NTI8w new file mode 100644 index 00000000..a61ed6eb Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/9/J/HoAzOaLZJdEIze4NTI8w differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/B/3/naeoOP+4oHyDWtCsX8NA b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/B/3/naeoOP+4oHyDWtCsX8NA new file mode 100644 index 00000000..be6bfbde Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/B/3/naeoOP+4oHyDWtCsX8NA differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/B/Z/FJcTv1IwpoVC62BER6xg b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/B/Z/FJcTv1IwpoVC62BER6xg new file mode 100644 index 00000000..a92fdd99 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/B/Z/FJcTv1IwpoVC62BER6xg differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/C/H/1jxNnbkc0AYhZWZurd4A b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/C/H/1jxNnbkc0AYhZWZurd4A new file mode 100644 index 00000000..9a24419a Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/C/H/1jxNnbkc0AYhZWZurd4A differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/D/H/WEzn6xChnR+AhPccdqIg b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/D/H/WEzn6xChnR+AhPccdqIg new file mode 100644 index 00000000..2259aaa8 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/D/H/WEzn6xChnR+AhPccdqIg differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/D/O/rxPv0pOPPTHld1OgyB5g b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/D/O/rxPv0pOPPTHld1OgyB5g new file mode 100644 index 00000000..1b0006e8 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/D/O/rxPv0pOPPTHld1OgyB5g differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/E/R/YiOy+lQkO2Vq-7-YXBRQ b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/E/R/YiOy+lQkO2Vq-7-YXBRQ new file mode 100644 index 00000000..3761597f Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/E/R/YiOy+lQkO2Vq-7-YXBRQ differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/F/K/T0jkBwmpHhEDEgpDOdRw b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/F/K/T0jkBwmpHhEDEgpDOdRw new file mode 100644 index 00000000..924cbc42 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/F/K/T0jkBwmpHhEDEgpDOdRw differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/F/R/hVsicjihMB09IZDGwZrw b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/F/R/hVsicjihMB09IZDGwZrw new file mode 100644 index 00000000..4d19c8b6 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/F/R/hVsicjihMB09IZDGwZrw differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/G/C/04HCLK0AmQ-l-IMAcmZg b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/G/C/04HCLK0AmQ-l-IMAcmZg new file mode 100644 index 00000000..26efe5c5 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/G/C/04HCLK0AmQ-l-IMAcmZg differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/G/Z/SAsMBKSoVMqELzkL70dA b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/G/Z/SAsMBKSoVMqELzkL70dA new file mode 100644 index 00000000..bc939544 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/G/Z/SAsMBKSoVMqELzkL70dA differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/H/3/JwqGzTaLMrtKway0Edbw b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/H/3/JwqGzTaLMrtKway0Edbw new file mode 100644 index 00000000..66009f41 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/H/3/JwqGzTaLMrtKway0Edbw differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/J/1/UKQq3XpspK2nM2Dp2-3g b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/J/1/UKQq3XpspK2nM2Dp2-3g new file mode 100644 index 00000000..aa345a36 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/J/1/UKQq3XpspK2nM2Dp2-3g differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/L/1/VwArR69DEPOgvYKUUYew b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/L/1/VwArR69DEPOgvYKUUYew new file mode 100644 index 00000000..540910c3 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/L/1/VwArR69DEPOgvYKUUYew differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/L/C/wZJMgh8deZhu0JW9+N4A b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/L/C/wZJMgh8deZhu0JW9+N4A new file mode 100644 index 00000000..d9eaa5d3 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/L/C/wZJMgh8deZhu0JW9+N4A differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/M/D/YAuHGbZ5QlW26mVQmmxA b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/M/D/YAuHGbZ5QlW26mVQmmxA new file mode 100644 index 00000000..35b8babe Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/M/D/YAuHGbZ5QlW26mVQmmxA differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/M/N/VwuCK0aAdUMb-dLIhydw b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/M/N/VwuCK0aAdUMb-dLIhydw new file mode 100644 index 00000000..e1e6c7fb Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/M/N/VwuCK0aAdUMb-dLIhydw differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/M/N/ci0ykcOiH9wIG5VSiVjg b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/M/N/ci0ykcOiH9wIG5VSiVjg new file mode 100644 index 00000000..20689cee Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/M/N/ci0ykcOiH9wIG5VSiVjg differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/M/V/+18MocshXiuihvzDMBMQ b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/M/V/+18MocshXiuihvzDMBMQ new file mode 100644 index 00000000..d7442c6d Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/M/V/+18MocshXiuihvzDMBMQ differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/N/E/zCHI9b4qIjP1as4jzpfw b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/N/E/zCHI9b4qIjP1as4jzpfw new file mode 100644 index 00000000..6a656163 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/N/E/zCHI9b4qIjP1as4jzpfw differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/O/H/B+hKB1BE3om2sI2MmmeA b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/O/H/B+hKB1BE3om2sI2MmmeA new file mode 100644 index 00000000..47445f44 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/O/H/B+hKB1BE3om2sI2MmmeA differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/Q/3/o-pyEWcPZwZFG7SUsQzQ b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/Q/3/o-pyEWcPZwZFG7SUsQzQ new file mode 100644 index 00000000..2e93d1a2 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/Q/3/o-pyEWcPZwZFG7SUsQzQ differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/Q/P/E0iph5f4ObNFRU53UJ5A b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/Q/P/E0iph5f4ObNFRU53UJ5A new file mode 100644 index 00000000..885c88ba Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/Q/P/E0iph5f4ObNFRU53UJ5A differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/Q/T/MN0NfHLn9LMbl0mYzCjQ b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/Q/T/MN0NfHLn9LMbl0mYzCjQ new file mode 100644 index 00000000..48dbdb0c Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/Q/T/MN0NfHLn9LMbl0mYzCjQ differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/S/2/WitHPEC4OBe-SHtXGV8w b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/S/2/WitHPEC4OBe-SHtXGV8w new file mode 100644 index 00000000..a12c0605 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/S/2/WitHPEC4OBe-SHtXGV8w differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/S/F/7XRECOz2sbGXVNXKS+yA b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/S/F/7XRECOz2sbGXVNXKS+yA new file mode 100644 index 00000000..17e06f6c Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/S/F/7XRECOz2sbGXVNXKS+yA differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/S/J/trixBCp-rgol1VatGJ6A b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/S/J/trixBCp-rgol1VatGJ6A new file mode 100644 index 00000000..0008d09f Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/S/J/trixBCp-rgol1VatGJ6A differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/S/X/r+0riuHXIuP8ed8T-NOA b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/S/X/r+0riuHXIuP8ed8T-NOA new file mode 100644 index 00000000..9d6bb1ed Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/S/X/r+0riuHXIuP8ed8T-NOA differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/S/Y/ALoMgWaxRLaBIkfBfiFw b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/S/Y/ALoMgWaxRLaBIkfBfiFw new file mode 100644 index 00000000..87d53ffe Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/S/Y/ALoMgWaxRLaBIkfBfiFw differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/U/+/6IrMZK+npNqH1wV8TT9w b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/U/+/6IrMZK+npNqH1wV8TT9w new file mode 100644 index 00000000..3141f103 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/U/+/6IrMZK+npNqH1wV8TT9w differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/U/C/h6IPaY4CVbFuC4X2FJ2Q b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/U/C/h6IPaY4CVbFuC4X2FJ2Q new file mode 100644 index 00000000..bb38cc2c Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/U/C/h6IPaY4CVbFuC4X2FJ2Q differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/U/J/jVx1WpwUDDj3ReRMxjYw b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/U/J/jVx1WpwUDDj3ReRMxjYw new file mode 100644 index 00000000..3a20da95 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/U/J/jVx1WpwUDDj3ReRMxjYw differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/U/X/zuSLkdAsrDsrT6bodpZg b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/U/X/zuSLkdAsrDsrT6bodpZg new file mode 100644 index 00000000..c1a7ba71 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/U/X/zuSLkdAsrDsrT6bodpZg differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/V/+/AAvZpKRSF0c5aPaAK8Ww b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/V/+/AAvZpKRSF0c5aPaAK8Ww new file mode 100644 index 00000000..06cc74ff Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/V/+/AAvZpKRSF0c5aPaAK8Ww differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/V/P/Wr-nuv6SqosPRNTzI89Q b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/V/P/Wr-nuv6SqosPRNTzI89Q new file mode 100644 index 00000000..bf2bb295 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/V/P/Wr-nuv6SqosPRNTzI89Q differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/V/P/gVObdQ5806NZ-X+IhvKg b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/V/P/gVObdQ5806NZ-X+IhvKg new file mode 100644 index 00000000..8b96bf9b Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/V/P/gVObdQ5806NZ-X+IhvKg differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/V/Y/cxbteYW3BePoMHSN8VPQ b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/V/Y/cxbteYW3BePoMHSN8VPQ new file mode 100644 index 00000000..6609f7d9 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/V/Y/cxbteYW3BePoMHSN8VPQ differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/W/0/MFPyXYNqYlQ1PLi+N-+w b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/W/0/MFPyXYNqYlQ1PLi+N-+w new file mode 100644 index 00000000..18c41f0e Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/W/0/MFPyXYNqYlQ1PLi+N-+w differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/W/2/dMo+BrG5sJdeKZzgNVrA b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/W/2/dMo+BrG5sJdeKZzgNVrA new file mode 100644 index 00000000..2d50cb0c Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/W/2/dMo+BrG5sJdeKZzgNVrA differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/W/O/60rH2lhsT383hI7Awi4g b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/W/O/60rH2lhsT383hI7Awi4g new file mode 100644 index 00000000..86616092 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/W/O/60rH2lhsT383hI7Awi4g differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/X/D/80nuYHDtcobXHOCUBCBA b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/X/D/80nuYHDtcobXHOCUBCBA new file mode 100644 index 00000000..1d573fb0 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/X/D/80nuYHDtcobXHOCUBCBA differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/X/M/vNmr8FlTHyxfIqSQv2AQ b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/X/M/vNmr8FlTHyxfIqSQv2AQ new file mode 100644 index 00000000..5e54c4bd Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/X/M/vNmr8FlTHyxfIqSQv2AQ differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/Y/N/VbuXmWguiuGVkgSjk49Q b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/Y/N/VbuXmWguiuGVkgSjk49Q new file mode 100644 index 00000000..61d38663 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/Y/N/VbuXmWguiuGVkgSjk49Q differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/Y/T/7I4Pqu8Te-h+UN0tgYag b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/Y/T/7I4Pqu8Te-h+UN0tgYag new file mode 100644 index 00000000..0bab03bb Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/Y/T/7I4Pqu8Te-h+UN0tgYag differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/Z/9/-sNoBSq+MKpK5YECj-iQ b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/Z/9/-sNoBSq+MKpK5YECj-iQ new file mode 100644 index 00000000..fbbc7ea6 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/Z/9/-sNoBSq+MKpK5YECj-iQ differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/Z/X/1KWEQ74YIdIrO6tlxbEQ b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/Z/X/1KWEQ74YIdIrO6tlxbEQ new file mode 100644 index 00000000..0ab69ddf Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-descriptors/Z/X/1KWEQ74YIdIrO6tlxbEQ differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/-/A/LPvSIL9FqpLbXHDZcmUA b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/-/A/LPvSIL9FqpLbXHDZcmUA new file mode 100644 index 00000000..31d0fd9d Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/-/A/LPvSIL9FqpLbXHDZcmUA differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/0/E/sdFc+s19SfxpDqPx8lvg b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/0/E/sdFc+s19SfxpDqPx8lvg new file mode 100644 index 00000000..500f8517 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/0/E/sdFc+s19SfxpDqPx8lvg differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/1/L/9SbE8XHEShbED0syztoA b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/1/L/9SbE8XHEShbED0syztoA new file mode 100644 index 00000000..fe058f4a Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/1/L/9SbE8XHEShbED0syztoA differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/2/U/9M0BJSlr2u6991jvaxgQ b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/2/U/9M0BJSlr2u6991jvaxgQ new file mode 100644 index 00000000..14964b6e Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/2/U/9M0BJSlr2u6991jvaxgQ differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/3/1/b9pooxjMCt92g8V0N8mQ b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/3/1/b9pooxjMCt92g8V0N8mQ new file mode 100644 index 00000000..3394bf6d Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/3/1/b9pooxjMCt92g8V0N8mQ differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/3/Q/-WREDzDP0WgmEEWWof3w b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/3/Q/-WREDzDP0WgmEEWWof3w new file mode 100644 index 00000000..30201939 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/3/Q/-WREDzDP0WgmEEWWof3w differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/3/T/BZBGybfWxIoKhF7wYbkQ b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/3/T/BZBGybfWxIoKhF7wYbkQ new file mode 100644 index 00000000..5e2d64a0 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/3/T/BZBGybfWxIoKhF7wYbkQ differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/5/-/pkgi8ygGSWyfwKWW1huA b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/5/-/pkgi8ygGSWyfwKWW1huA new file mode 100644 index 00000000..75f724ca Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/5/-/pkgi8ygGSWyfwKWW1huA differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/7/0/s7mQU3hnlN0Atr2CVAkw b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/7/0/s7mQU3hnlN0Atr2CVAkw new file mode 100644 index 00000000..774240ab Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/7/0/s7mQU3hnlN0Atr2CVAkw differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/A/E/xMZibgiUX57u2Q3PKK5A b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/A/E/xMZibgiUX57u2Q3PKK5A new file mode 100644 index 00000000..c3451c9b Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/A/E/xMZibgiUX57u2Q3PKK5A differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/A/N/nFzqiA2FSe6VYwUagewg b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/A/N/nFzqiA2FSe6VYwUagewg new file mode 100644 index 00000000..2388da8c Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/A/N/nFzqiA2FSe6VYwUagewg differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/B/R/ioPijwVB9BnJdq4BAJoA b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/B/R/ioPijwVB9BnJdq4BAJoA new file mode 100644 index 00000000..f14b2100 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/B/R/ioPijwVB9BnJdq4BAJoA differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/D/A/+BdCO+VsIjuVQ3W0EVrw b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/D/A/+BdCO+VsIjuVQ3W0EVrw new file mode 100644 index 00000000..9d895367 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/D/A/+BdCO+VsIjuVQ3W0EVrw differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/D/T/POHrA3zGbZ3CGOeziSkA b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/D/T/POHrA3zGbZ3CGOeziSkA new file mode 100644 index 00000000..e596499b Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/D/T/POHrA3zGbZ3CGOeziSkA differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/D/X/MHhO+9PrhGoZ23EPFn+A b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/D/X/MHhO+9PrhGoZ23EPFn+A new file mode 100644 index 00000000..0bc3204d Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/D/X/MHhO+9PrhGoZ23EPFn+A differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/D/Y/rnppUxhk4vXyHPwmsu3Q b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/D/Y/rnppUxhk4vXyHPwmsu3Q new file mode 100644 index 00000000..d7050e83 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/D/Y/rnppUxhk4vXyHPwmsu3Q differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/E/3/AcxVYd2Sv97yGWOtr0FA b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/E/3/AcxVYd2Sv97yGWOtr0FA new file mode 100644 index 00000000..233c7fc2 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/E/3/AcxVYd2Sv97yGWOtr0FA differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/E/4/pU8uuaET44lIVnM-inXw b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/E/4/pU8uuaET44lIVnM-inXw new file mode 100644 index 00000000..161b4061 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/E/4/pU8uuaET44lIVnM-inXw differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/E/F/utcub0tmrQ7mTzqDR2Eg b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/E/F/utcub0tmrQ7mTzqDR2Eg new file mode 100644 index 00000000..82428945 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/E/F/utcub0tmrQ7mTzqDR2Eg differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/E/O/jNdzsA3pd9w-ATOvogNg b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/E/O/jNdzsA3pd9w-ATOvogNg new file mode 100644 index 00000000..2b2c4ae3 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/E/O/jNdzsA3pd9w-ATOvogNg differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/F/S/+7ogajjfvIA4cUBpgrlQ b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/F/S/+7ogajjfvIA4cUBpgrlQ new file mode 100644 index 00000000..30098fce Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/F/S/+7ogajjfvIA4cUBpgrlQ differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/F/W/oZXh+5skWrkEcXUoAiUQ b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/F/W/oZXh+5skWrkEcXUoAiUQ new file mode 100644 index 00000000..cb727778 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/F/W/oZXh+5skWrkEcXUoAiUQ differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/G/9/vIfhqmHLaYoqH7hoPvqQ b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/G/9/vIfhqmHLaYoqH7hoPvqQ new file mode 100644 index 00000000..f356f0d0 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/G/9/vIfhqmHLaYoqH7hoPvqQ differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/G/U/LQrRn4p0BPQV5HKZG-AQ b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/G/U/LQrRn4p0BPQV5HKZG-AQ new file mode 100644 index 00000000..26e5741e Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/G/U/LQrRn4p0BPQV5HKZG-AQ differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/H/K/0zl2a4zSewuADw2RVe7w b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/H/K/0zl2a4zSewuADw2RVe7w new file mode 100644 index 00000000..a41da14c Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/H/K/0zl2a4zSewuADw2RVe7w differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/H/L/BQvpOjy-T05xf+1THuhw b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/H/L/BQvpOjy-T05xf+1THuhw new file mode 100644 index 00000000..8cb7bc5a Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/H/L/BQvpOjy-T05xf+1THuhw differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/H/N/ou2TgYfenAkqmUxUKvfQ b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/H/N/ou2TgYfenAkqmUxUKvfQ new file mode 100644 index 00000000..57d09e2c Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/H/N/ou2TgYfenAkqmUxUKvfQ differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/H/Y/DBg-T5+1XcOIpmNPoUvA b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/H/Y/DBg-T5+1XcOIpmNPoUvA new file mode 100644 index 00000000..8e1d8965 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/H/Y/DBg-T5+1XcOIpmNPoUvA differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/J/9/FWMI8H4MSqQtaDPeo3Bw b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/J/9/FWMI8H4MSqQtaDPeo3Bw new file mode 100644 index 00000000..27c8c61d Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/J/9/FWMI8H4MSqQtaDPeo3Bw differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/J/V/4+9Z1icVQw7wxPnlt0vA b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/J/V/4+9Z1icVQw7wxPnlt0vA new file mode 100644 index 00000000..e02d2b77 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/J/V/4+9Z1icVQw7wxPnlt0vA differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/L/3/8q0GwI8kYgJy5LpNsVKA b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/L/3/8q0GwI8kYgJy5LpNsVKA new file mode 100644 index 00000000..b4083b36 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/L/3/8q0GwI8kYgJy5LpNsVKA differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/L/8/WBM9TeBCOZaNIMAS2uyg b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/L/8/WBM9TeBCOZaNIMAS2uyg new file mode 100644 index 00000000..2c785973 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/L/8/WBM9TeBCOZaNIMAS2uyg differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/L/O/CFsYFpjtK9p28euFeocQ b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/L/O/CFsYFpjtK9p28euFeocQ new file mode 100644 index 00000000..4ebe83a0 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/L/O/CFsYFpjtK9p28euFeocQ differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/L/P/QrxVCv99dUIVJ5Qo3RXQ b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/L/P/QrxVCv99dUIVJ5Qo3RXQ new file mode 100644 index 00000000..be3ba527 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/L/P/QrxVCv99dUIVJ5Qo3RXQ differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/M/M/nuuVtd2xyOaNieuosHtA b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/M/M/nuuVtd2xyOaNieuosHtA new file mode 100644 index 00000000..91c23e2c Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/M/M/nuuVtd2xyOaNieuosHtA differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/N/4/LHC0SWsiVm0Zdr24EL5Q b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/N/4/LHC0SWsiVm0Zdr24EL5Q new file mode 100644 index 00000000..c4e8c6de Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/N/4/LHC0SWsiVm0Zdr24EL5Q differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/N/N/wZmrPbEeBZ8nI6-JgI3A b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/N/N/wZmrPbEeBZ8nI6-JgI3A new file mode 100644 index 00000000..f3ec905f Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/N/N/wZmrPbEeBZ8nI6-JgI3A differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/N/W/hhW4+qzrbWSvmoWPPINA b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/N/W/hhW4+qzrbWSvmoWPPINA new file mode 100644 index 00000000..7dcefd59 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/N/W/hhW4+qzrbWSvmoWPPINA differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/P/G/3GqFAGSVVV-AWfKUqUwA b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/P/G/3GqFAGSVVV-AWfKUqUwA new file mode 100644 index 00000000..245333bb Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/P/G/3GqFAGSVVV-AWfKUqUwA differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/R/+/ZcpC0xIM0y2mP+UNKHoQ b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/R/+/ZcpC0xIM0y2mP+UNKHoQ new file mode 100644 index 00000000..2de934b1 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/R/+/ZcpC0xIM0y2mP+UNKHoQ differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/R/T/QV5Wd+FBSXvgAaZC6VSQ b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/R/T/QV5Wd+FBSXvgAaZC6VSQ new file mode 100644 index 00000000..f1d2d222 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/R/T/QV5Wd+FBSXvgAaZC6VSQ differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/R/V/Ko1k0lOstm76ZYoAAXnQ b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/R/V/Ko1k0lOstm76ZYoAAXnQ new file mode 100644 index 00000000..3b368844 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/R/V/Ko1k0lOstm76ZYoAAXnQ differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/R/X/0gQotkXF1eh34cXfwfHg b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/R/X/0gQotkXF1eh34cXfwfHg new file mode 100644 index 00000000..35974e63 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/R/X/0gQotkXF1eh34cXfwfHg differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/U/K/DPRCrU2OgU+JCDBwxMXw b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/U/K/DPRCrU2OgU+JCDBwxMXw new file mode 100644 index 00000000..0500bfc8 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/U/K/DPRCrU2OgU+JCDBwxMXw differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/V/6/0bDOBn5Dhl1pGDoF7+0w b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/V/6/0bDOBn5Dhl1pGDoF7+0w new file mode 100644 index 00000000..91ff3b93 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/V/6/0bDOBn5Dhl1pGDoF7+0w differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/V/6/uWzP51Z4FobRMMFYkUFQ b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/V/6/uWzP51Z4FobRMMFYkUFQ new file mode 100644 index 00000000..8fd345b8 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/V/6/uWzP51Z4FobRMMFYkUFQ differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/W/D/NsTt6yIsaf7RXx22+qvg b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/W/D/NsTt6yIsaf7RXx22+qvg new file mode 100644 index 00000000..20f45169 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/W/D/NsTt6yIsaf7RXx22+qvg differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/W/F/PySfA1kswezqxLsj+nrA b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/W/F/PySfA1kswezqxLsj+nrA new file mode 100644 index 00000000..079d178d Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/W/F/PySfA1kswezqxLsj+nrA differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/W/M/FNzbas5ZUtxMQt3vSVjA b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/W/M/FNzbas5ZUtxMQt3vSVjA new file mode 100644 index 00000000..0cca023d Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/W/M/FNzbas5ZUtxMQt3vSVjA differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/X/S/nnse0p8W81ko7ucn4ZXg b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/X/S/nnse0p8W81ko7ucn4ZXg new file mode 100644 index 00000000..6aa001dd Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/X/S/nnse0p8W81ko7ucn4ZXg differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/Y/R/T-l-LiNfrqV5sn2z6Lrg b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/Y/R/T-l-LiNfrqV5sn2z6Lrg new file mode 100644 index 00000000..dae20244 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/Y/R/T-l-LiNfrqV5sn2z6Lrg differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/Y/S/JxjoSecxBJpq1G4G5sAA b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/Y/S/JxjoSecxBJpq1G4G5sAA new file mode 100644 index 00000000..2facc44a Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/Y/S/JxjoSecxBJpq1G4G5sAA differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/Y/U/tkbdkWBrNPaEJ1C0SIqw b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/Y/U/tkbdkWBrNPaEJ1C0SIqw new file mode 100644 index 00000000..c4b241a6 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/Y/U/tkbdkWBrNPaEJ1C0SIqw differ diff --git a/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/Z/E/f2jh7eESJlhHBApCvo+g b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/Z/E/f2jh7eESJlhHBApCvo+g new file mode 100644 index 00000000..9b6f5df4 Binary files /dev/null and b/.phpdoc/cache/441d63ebbc39eba359c9061ece8482bd-files/Z/E/f2jh7eESJlhHBApCvo+g differ diff --git a/docs/classes/MarketDataApp-Client.html b/docs/classes/MarketDataApp-Client.html index ca1be1e0..22e3da83 100644 --- a/docs/classes/MarketDataApp-Client.html +++ b/docs/classes/MarketDataApp-Client.html @@ -80,6 +80,14 @@

  • Exceptions +
  • +
  • + Logging + +
  • +
  • + Retry +
  • Traits @@ -141,7 +149,7 @@

    @@ -149,15 +157,13 @@

    This class provides access to various endpoints of the Market Data API, -including indices, stocks, options, markets, mutual funds, and utilities.

    +including stocks, options, markets, mutual funds, and utilities.

    - - - - + +

    Table of Contents @@ -190,6 +196,20 @@

    The base URL for the Market Data API.
    +
    + PACKAGE_NAME + +  = 'marketdataapp/sdk-php' +
    +
    Composer package name for this SDK.
    + +
    + VERSION + +  = '1.0.0' +
    +
    Fallback SDK version for User-Agent header.
    + @@ -200,12 +220,16 @@

    - $indices + $default_params + +  : Parameters +
    + +
    + $logger -  : Indices +  : LoggerInterface
    -
    The index endpoints provided by the Market Data API offer access to both real-time and historical data related to -financial indices. These endpoints are designed to cater to a wide range of financial data needs.
    $markets @@ -231,6 +255,12 @@

    and historical data queries. They accommodate a wide range of optional parameters for detailed data retrieval, making the Market Data API a versatile tool for options traders and financial analysts. +
    + $rate_limits + +  : RateLimits|null +
    +
    $stocks @@ -278,14 +308,42 @@

     : object

    -
    Execute a single API request.
    +
    Execute a single API request with retry logic.
    execute_in_parallel()  : array<string|int, mixed>
    -
    Execute multiple API calls in parallel.
    +
    Execute multiple API calls in parallel with concurrency limiting.
    + +
    + extractRateLimitsFromResponse() + +  : RateLimits|null +
    +
    Extract rate limit information from response headers.
    + +
    + getUserAgent() + +  : string +
    +
    Build SDK User-Agent value.
    + +
    + getVersion() + +  : string +
    +
    Resolve SDK version from Composer metadata when available.
    + +
    + makeRawRequest() + +  : ResponseInterface +
    +
    Make a raw API request and return the response object.
    setGuzzle() @@ -294,12 +352,54 @@

    Set a custom Guzzle client.
    +
    + validateResponseStatusCode() + +  : void +
    +
    Validate response status code and raise appropriate exceptions.
    + +
    + _setup_rate_limits() + +  : void +
    +
    Set up initial rate limits by fetching from the /user/ endpoint.
    +
    async()  : PromiseInterface
    -
    Perform an asynchronous API request.
    +
    Perform an asynchronous API request with retry logic.
    + +
    + calculateBackoffDelay() + +  : float +
    +
    Calculate exponential backoff delay.
    + +
    + createDelayedPromise() + +  : PromiseInterface +
    +
    Create a promise that resolves after a delay.
    + +
    + getErrorMessage() + +  : string +
    +
    Get error message from response.
    + +
    + getServicePath() + +  : string|null +
    +
    Get service path from method path using hardcoded mapping.
    headers() @@ -308,6 +408,48 @@

    Generate headers for API requests.
    +
    + isInternalRequest() + +  : bool +
    +
    Check if a URL is for an internal request.
    + +
    + logRequest() + +  : void +
    +
    Log a completed HTTP request.
    + +
    + processResponse() + +  : object +
    +
    Process the response and return the appropriate object.
    + +
    + shouldSkipRetryDueToOfflineService() + +  : bool +
    +
    Check if service is offline and should skip retries.
    + +
    + waitForRetry() + +  : void +
    +
    Wait for retry with exponential backoff.
    + +
    + obfuscateToken() + +  : string +
    +
    Obfuscate token for logging - show full length with asterisks, last 4 chars visible.
    +

    @@ -329,7 +471,7 @@

    @@ -348,9 +490,8 @@

    - - - + +

    API_URL @@ -361,7 +502,7 @@

    @@ -380,9 +521,70 @@

    + +

    +
    +

    + PACKAGE_NAME + + +

    + + + +

    Composer package name for this SDK.

    + + + + public + mixed + PACKAGE_NAME + = 'marketdataapp/sdk-php' + + + + + -
    + + +
    +

    + VERSION + + +

    + + + +

    Fallback SDK version for User-Agent header.

    + + + + public + mixed + VERSION + = '1.0.0' + + + + + + + + +
    @@ -397,57 +599,99 @@

    phpdocumentor-element -property -public - " + " > -

    - $indices - +

    + $default_params + - +

    -

    The index endpoints provided by the Market Data API offer access to both real-time and historical data related to -financial indices. These endpoints are designed to cater to a wide range of financial data needs.

    - + - public - Indices - $indices + public + Parameters + $default_params +

    Default universal parameters for all API requests. +Can be modified programmatically: $client->default_params->format = Format::CSV; +Method-level parameters override these defaults.

    +
    + + + + + + + +
    +

    + $logger + + + + +

    + + + + + public + LoggerInterface + $logger + + +

    PSR-3 logger instance for request logging.

    +
    + + +

    $markets - +

    @@ -455,8 +699,8 @@

    - public - Markets + public + Markets $markets @@ -464,7 +708,8 @@

    - + +

    phpdocumentor-element -property -public - " + " >

    $mutual_funds - +

    @@ -492,8 +737,8 @@

    - public - MutualFunds + public + MutualFunds $mutual_funds @@ -501,7 +746,8 @@

    - + +

    phpdocumentor-element -property -public - " + " >

    $options - +

    @@ -532,8 +778,8 @@

    - public - Options + public + Options $options @@ -541,27 +787,68 @@

    + + + +

    +
    +

    + $rate_limits + + + + +

    + + + + + + public + RateLimits|null + $rate_limits + = null + + +

    Current rate limit information, automatically updated after each request. +Tracks credits (not requests), as some requests may consume multiple credits.

    +
    + + + +

    $stocks - +

    @@ -569,8 +856,8 @@

    - public - Stocks + public + Stocks $stocks @@ -578,7 +865,8 @@

    - + +

    phpdocumentor-element -property -public - " + " >

    $utilities - +

    @@ -607,8 +895,8 @@

    - public - Utilities + public + Utilities $utilities @@ -616,7 +904,8 @@

    - + +

    phpdocumentor-element -property -protected - " + " >

    $guzzle - +

    - protected - Client + protected + Client $guzzle @@ -654,7 +943,8 @@

    - + +

    phpdocumentor-element -property -protected - " + " >

    $token - +

    - protected - string + protected + string $token @@ -692,7 +982,8 @@

    - + +

    @@ -717,7 +1008,7 @@

    @@ -725,7 +1016,7 @@

    public - __construct(string $token) : mixed + __construct([string|null $token = null ][, LoggerInterface|null $logger = null ]) : mixed
    @@ -736,20 +1027,51 @@

    Parameters
    - $token - : string -
    + $token + : string|null + = null +
    +

    The API token for authentication. If not provided, the token will be +automatically resolved from MARKETDATA_TOKEN environment variable or .env file. +An empty string is allowed for accessing free symbols like AAPL. +A valid token is required for authenticated endpoints. An invalid token will throw +UnauthorizedException during construction.

    +
    + +
    +
    + $logger + : LoggerInterface|null + = null
    -

    The API token for authentication.

    +

    Optional PSR-3 logger instance. If not provided, uses the default logger +configured via MARKETDATA_LOGGING_LEVEL environment variable.

    +
    + Tags + - +
    +
    +
    + throws +
    +
    + UnauthorizedException + +

    If the token is invalid (non-empty but returns 401 from /user endpoint)

    +
    + +
    +
    + +
    -

    Execute a single API request.

    +

    Execute a single API request with retry logic.

    public - execute(string $method[, array<string|int, mixed> $arguments = [] ]) : object + execute(string $method[, array<string|int, mixed> $arguments = [] ]) : object
    @@ -783,8 +1105,8 @@

    Parameters
    - $method - : string + $method + : string

    The API method to call.

    @@ -792,9 +1114,9 @@
    Parameters
    - $arguments - : array<string|int, mixed> - = []
    + $arguments + : array<string|int, mixed> + = []

    The arguments for the API call.

    @@ -824,11 +1146,35 @@
    ApiException +
    +
    + throws +
    +
    + RequestError + + +
    +
    + throws +
    +
    + BadStatusCodeError + + +
    +
    + throws +
    +
    + UnauthorizedException + +
    + -
    Return values
    object @@ -853,30 +1199,45 @@

    -

    Execute multiple API calls in parallel.

    +

    Execute multiple API calls in parallel with concurrency limiting.

    public - execute_in_parallel(array<string|int, mixed> $calls) : array<string|int, mixed> + execute_in_parallel(array<string|int, mixed> $calls[, array<string|int, mixed>|null &$failedRequests = null ]) : array<string|int, mixed>
    - +

    Uses Guzzle's EachPromise to maintain a sliding window of concurrent requests. +Unlike batch processing, this approach starts new requests as soon as previous +ones complete, maintaining optimal throughput up to MAX_CONCURRENT_REQUESTS (50).

    +
    +

    Parameters
    - $calls - : array<string|int, mixed> + $calls + : array<string|int, mixed>

    An array of method calls, each containing the method name and arguments.

    +
    +
    + $failedRequests + : array<string|int, mixed>|null + = null
    +
    +

    Optional by-reference array to collect failed requests instead of throwing. +When provided, exceptions are stored here keyed by their call index, +allowing callers to handle partial failures.

    +
    +
    @@ -893,17 +1254,20 @@
    Throwable - +

    When $failedRequests is not provided and any request fails.

    +
    +
    + -
    Return values
    array<string|int, mixed> — -

    An array of decoded JSON responses.

    +

    An array of decoded JSON responses. When $failedRequests is provided, successful responses +are keyed by their original call index. Otherwise, returns a sequential array.

    @@ -915,36 +1279,41 @@
    Return values
    -public " > -

    - setGuzzle() - +

    + extractRateLimitsFromResponse() +

    -

    Set a custom Guzzle client.

    +

    Extract rate limit information from response headers.

    public - setGuzzle(Client $guzzleClient) : void + extractRateLimitsFromResponse(ResponseInterface $response) : RateLimits|null
    - +

    This method extracts rate limit data from API response headers and returns +a RateLimits object. Returns null if headers are missing, allowing +graceful degradation. This method is designed to be reusable for future +automatic rate limit tracking across all API requests.

    +
    +
    Parameters
    - $guzzleClient - : Client + $response + : ResponseInterface
    -

    The Guzzle client to use.

    +

    The HTTP response.

    @@ -952,93 +1321,209 @@
    Parameters
    + + +
    +
    Return values
    + RateLimits|null + — +

    The rate limit information, or null if headers are missing.

    +
    + +
    + +
    +
    +

    + getUserAgent() + + +

    + + +

    Build SDK User-Agent value.

    + + + public + static getUserAgent() : string + +
    +
    + + + + +
    +
    Return values
    + string +
    +
    -

    - async() - +

    + getVersion() +

    -

    Perform an asynchronous API request.

    +

    Resolve SDK version from Composer metadata when available.

    - protected - async(string $method[, array<string|int, mixed> $arguments = [] ]) : PromiseInterface + public + static getVersion() : string
    + + + + + +
    +
    Return values
    + string +
    + +
    +
    +

    + makeRawRequest() + + +

    + + +

    Make a raw API request and return the response object.

    + + + public + makeRawRequest(string $method[, array<string|int, mixed> $arguments = [] ]) : ResponseInterface + +
    +
    + +

    This method is useful for endpoints that need access to response headers, +such as the /user/ endpoint for rate limit information.

    +
    +
    Parameters
    - $method - : string + $method + : string
    -

    The API method to call.

    +

    The API method to call (no API version prefix).

    - $arguments - : array<string|int, mixed> - = []
    + $arguments + : array<string|int, mixed> + = []
    -

    The arguments for the API call.

    +

    Optional query parameters.

    +
    + Tags + - +
    +
    +
    + throws +
    +
    + GuzzleException + + +
    +
    + throws +
    +
    + UnauthorizedException + + +
    +
    + +
    Return values
    - PromiseInterface + ResponseInterface + — +

    The HTTP response.

    +
    +
    -

    - headers() - +

    + setGuzzle() +

    -

    Generate headers for API requests.

    +

    Set a custom Guzzle client.

    - protected - headers([string $format = 'json' ]) : array<string|int, mixed> + public + setGuzzle(Client $guzzleClient) : void
    @@ -1047,11 +1532,11 @@

    Parameters
    - $format - : string - = 'json'
    + $guzzleClient + : Client +
    -

    The desired response format (json, csv, or html).

    +

    The Guzzle client to use.

    @@ -1059,13 +1544,934 @@
    Parameters
    + + + +
    +
    +

    + validateResponseStatusCode() + + +

    + + +

    Validate response status code and raise appropriate exceptions.

    + + + public + validateResponseStatusCode(ResponseInterface $response[, bool $raiseForStatus = true ][, string|null $requestUrl = null ]) : void + +
    +
    + + +
    Parameters
    +
    +
    + $response + : ResponseInterface +
    +
    +

    The HTTP response.

    +
    + +
    +
    + $raiseForStatus + : bool + = true
    +
    +

    Whether to raise for non-2xx status codes.

    +
    + +
    +
    + $requestUrl + : string|null + = null
    +
    +

    The URL that was requested.

    +
    + +
    +
    + +
    + Tags + -
    -
    Return values
    - array<string|int, mixed> - — -

    An array of headers.

    +
    +
    +
    + throws +
    +
    + RequestError + + +
    +
    + throws +
    +
    + BadStatusCodeError + + +
    +
    + throws +
    +
    + UnauthorizedException + + +
    +
    + + + + +
    +
    +

    + _setup_rate_limits() + + +

    + + +

    Set up initial rate limits by fetching from the /user/ endpoint.

    + + + protected + _setup_rate_limits() : void + +
    +
    + +

    This method is called during client construction to initialize rate limit +information. If the request fails, rate_limits will remain null until the +first successful request with rate limit headers.

    +

    Rate limits track credits, not requests. Most requests consume 1 credit, +but bulk requests or options requests may consume multiple credits.

    +

    If the token is empty, validation is skipped to allow free symbols like AAPL. +If the token is invalid (returns 401), an UnauthorizedException is thrown +to prevent client creation.

    +
    + + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + UnauthorizedException + +

    If the token is invalid (non-empty but returns 401)

    +
    + +
    +
    + + + + +
    +
    +

    + async() + + +

    + + +

    Perform an asynchronous API request with retry logic.

    + + + protected + async(string $method[, array<string|int, mixed> $arguments = [] ]) : PromiseInterface + +
    +
    + + +
    Parameters
    +
    +
    + $method + : string +
    +
    +

    The API method to call.

    +
    + +
    +
    + $arguments + : array<string|int, mixed> + = []
    +
    +

    The arguments for the API call.

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + RequestError + + +
    +
    + throws +
    +
    + BadStatusCodeError + + +
    +
    + throws +
    +
    + UnauthorizedException + + +
    +
    + + + +
    +
    Return values
    + PromiseInterface +
    + +
    +
    +

    + calculateBackoffDelay() + + +

    + + +

    Calculate exponential backoff delay.

    + + + protected + calculateBackoffDelay(int $attempt) : float + +
    +
    + + +
    Parameters
    +
    +
    + $attempt + : int +
    +
    +

    The current attempt number (1-based).

    +
    + +
    +
    + + + + + +
    +
    Return values
    + float + — +

    The delay in seconds.

    +
    + +
    + +
    +
    +

    + createDelayedPromise() + + +

    + + +

    Create a promise that resolves after a delay.

    + + + protected + createDelayedPromise(float $delay) : PromiseInterface + +
    +
    + +

    Note: PHP doesn't have native async timers, so this uses a micro-delay +approach. For true non-blocking behavior, an event loop would be needed. +This implementation provides the delay while maintaining promise chaining.

    +
    + +
    Parameters
    +
    +
    + $delay + : float +
    +
    +

    The delay in seconds.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + PromiseInterface + — +

    A promise that resolves after the delay.

    +
    + +
    + +
    +
    +

    + getErrorMessage() + + +

    + + +

    Get error message from response.

    + + + protected + getErrorMessage(ResponseInterface $response) : string + +
    +
    + + +
    Parameters
    +
    +
    + $response + : ResponseInterface +
    +
    +

    The HTTP response.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    The error message.

    +
    + +
    + +
    +
    +

    + getServicePath() + + +

    + + +

    Get service path from method path using hardcoded mapping.

    + + + protected + getServicePath(string $method) : string|null + +
    +
    + +

    Maps method paths like "v1/stocks/quotes/AAPL" to service paths like "/v1/stocks/quotes/". +Returns null for status endpoint (to avoid checking its own status) or unknown services.

    +
    + +
    Parameters
    +
    +
    + $method + : string +
    +
    +

    The method path (e.g., "v1/stocks/quotes/AAPL").

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string|null + — +

    The service path (e.g., "/v1/stocks/quotes/") or null if not found/special case.

    +
    + +
    + +
    +
    +

    + headers() + + +

    + + +

    Generate headers for API requests.

    + + + protected + headers([string $format = 'json' ]) : array<string|int, mixed> + +
    +
    + + +
    Parameters
    +
    +
    + $format + : string + = 'json'
    +
    +

    The desired response format (json, csv, or html).

    +
    + +
    +
    + + + + + +
    +
    Return values
    + array<string|int, mixed> + — +

    An array of headers.

    +
    + +
    + +
    +
    +

    + isInternalRequest() + + +

    + + +

    Check if a URL is for an internal request.

    + + + protected + isInternalRequest(string $url) : bool + +
    +
    + +

    Internal requests (rate limit setup, API status) are logged at DEBUG level. +API requests are logged at INFO level.

    +
    + +
    Parameters
    +
    +
    + $url + : string +
    +
    +

    The request URL.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + bool + — +

    True if internal request, false otherwise.

    +
    + +
    + +
    +
    +

    + logRequest() + + +

    + + +

    Log a completed HTTP request.

    + + + protected + logRequest(string $method, ResponseInterface $response, float $durationMs, string $url[, string $logLevel = 'info' ]) : void + +
    +
    + +

    Logs one line per request with format: METHOD STATUS DURATION REQUEST_ID URL

    +
    + +
    Parameters
    +
    +
    + $method + : string +
    +
    +

    HTTP method (GET, POST, etc.).

    +
    + +
    +
    + $response + : ResponseInterface +
    +
    +

    The HTTP response.

    +
    + +
    +
    + $durationMs + : float +
    +
    +

    Request duration in milliseconds.

    +
    + +
    +
    + $url + : string +
    +
    +

    The full request URL.

    +
    + +
    +
    + $logLevel + : string + = 'info'
    +
    +

    Log level: 'info' for API requests, 'debug' for internal.

    +
    + +
    +
    + + + + + + +
    +
    +

    + processResponse() + + +

    + + +

    Process the response and return the appropriate object.

    + + + protected + processResponse(ResponseInterface $response, string $format, array<string|int, mixed> $arguments[, string|null $requestUrl = null ]) : object + +
    +
    + + +
    Parameters
    +
    +
    + $response + : ResponseInterface +
    +
    +

    The HTTP response.

    +
    + +
    +
    + $format + : string +
    +
    +

    The response format.

    +
    + +
    +
    + $arguments + : array<string|int, mixed> +
    +
    +

    The request arguments.

    +
    + +
    +
    + $requestUrl + : string|null + = null
    +
    +

    The URL that was requested.

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + ApiException + + +
    +
    + + + +
    +
    Return values
    + object + — +

    The processed response.

    +
    + +
    + +
    +
    +

    + shouldSkipRetryDueToOfflineService() + + +

    + + +

    Check if service is offline and should skip retries.

    + + + protected + shouldSkipRetryDueToOfflineService(string $method) : bool + +
    +
    + + +
    Parameters
    +
    +
    + $method + : string +
    +
    +

    The method path being called.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + bool + — +

    True if service is offline (should skip retries), false otherwise.

    +
    + +
    + +
    +
    +

    + waitForRetry() + + +

    + + +

    Wait for retry with exponential backoff.

    + + + protected + waitForRetry(int $attempt) : void + +
    +
    + + +
    Parameters
    +
    +
    + $attempt + : int +
    +
    +

    The current attempt number (1-based).

    +
    + +
    +
    + + + + + + +
    +
    +

    + obfuscateToken() + + +

    + + +

    Obfuscate token for logging - show full length with asterisks, last 4 chars visible.

    + + + private + static obfuscateToken(string $token) : string + +
    +
    + +

    Example: "abc123xyz789" becomes "********z789"

    +
    + +
    Parameters
    +
    +
    + $token + : string +
    +
    +

    The token to obfuscate.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    The obfuscated token.

    @@ -1109,6 +2515,8 @@
    Return values
    if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } @@ -1186,16 +2594,20 @@
    Return values
  • Properties
  • diff --git a/docs/classes/MarketDataApp-ClientBase.html b/docs/classes/MarketDataApp-ClientBase.html index a4cdf3ce..b0c3d80d 100644 --- a/docs/classes/MarketDataApp-ClientBase.html +++ b/docs/classes/MarketDataApp-ClientBase.html @@ -80,6 +80,14 @@

  • Exceptions +
  • +
  • + Logging + +
  • +
  • + Retry +
  • Traits @@ -140,7 +148,7 @@

    @@ -153,10 +161,8 @@

    - - - - + +

    Table of Contents @@ -189,6 +195,20 @@

    The base URL for the Market Data API.
    +
    + PACKAGE_NAME + +  = 'marketdataapp/sdk-php' +
    +
    Composer package name for this SDK.
    + +
    + VERSION + +  = '1.0.0' +
    +
    Fallback SDK version for User-Agent header.
    + @@ -198,6 +218,24 @@

    +
    + $default_params + +  : Parameters +
    + +
    + $logger + +  : LoggerInterface +
    + +
    + $rate_limits + +  : RateLimits|null +
    +
    $guzzle @@ -230,14 +268,42 @@

     : object

    -
    Execute a single API request.
    +
    Execute a single API request with retry logic.
    execute_in_parallel()  : array<string|int, mixed>
    -
    Execute multiple API calls in parallel.
    +
    Execute multiple API calls in parallel with concurrency limiting.
    + +
    + extractRateLimitsFromResponse() + +  : RateLimits|null +
    +
    Extract rate limit information from response headers.
    + +
    + getUserAgent() + +  : string +
    +
    Build SDK User-Agent value.
    + +
    + getVersion() + +  : string +
    +
    Resolve SDK version from Composer metadata when available.
    + +
    + makeRawRequest() + +  : ResponseInterface +
    +
    Make a raw API request and return the response object.
    setGuzzle() @@ -246,12 +312,54 @@

    Set a custom Guzzle client.
    +
    + validateResponseStatusCode() + +  : void +
    +
    Validate response status code and raise appropriate exceptions.
    + +
    + _setup_rate_limits() + +  : void +
    +
    Set up initial rate limits by fetching from the /user/ endpoint.
    +
    async()  : PromiseInterface
    -
    Perform an asynchronous API request.
    +
    Perform an asynchronous API request with retry logic.
    + +
    + calculateBackoffDelay() + +  : float +
    +
    Calculate exponential backoff delay.
    + +
    + createDelayedPromise() + +  : PromiseInterface +
    +
    Create a promise that resolves after a delay.
    + +
    + getErrorMessage() + +  : string +
    +
    Get error message from response.
    + +
    + getServicePath() + +  : string|null +
    +
    Get service path from method path using hardcoded mapping.
    headers() @@ -260,6 +368,41 @@

    Generate headers for API requests.
    +
    + isInternalRequest() + +  : bool +
    +
    Check if a URL is for an internal request.
    + +
    + logRequest() + +  : void +
    +
    Log a completed HTTP request.
    + +
    + processResponse() + +  : object +
    +
    Process the response and return the appropriate object.
    + +
    + shouldSkipRetryDueToOfflineService() + +  : bool +
    +
    Check if service is offline and should skip retries.
    + +
    + waitForRetry() + +  : void +
    +
    Wait for retry with exponential backoff.
    +
    @@ -281,7 +424,7 @@

    @@ -300,9 +443,8 @@

    - - - + +

    API_URL @@ -313,7 +455,7 @@

    @@ -332,9 +474,70 @@

    + +

    +
    +

    + PACKAGE_NAME + + +

    + + + +

    Composer package name for this SDK.

    + + + + public + mixed + PACKAGE_NAME + = 'marketdataapp/sdk-php' + + + + + -
    + + +
    +

    + VERSION + + +

    + + + +

    Fallback SDK version for User-Agent header.

    + + + + public + mixed + VERSION + = '1.0.0' + + + + + + + + +
    @@ -345,31 +548,151 @@

    +

    + $default_params + + + + +

    + + + + + + public + Parameters + $default_params + + + +

    Default universal parameters for all API requests. +Can be modified programmatically: $client->default_params->format = Format::CSV; +Method-level parameters override these defaults.

    +
    + + + + + + +
    +
    +

    + $logger + + + + +

    + + + + + + public + LoggerInterface + $logger + + + +

    PSR-3 logger instance for request logging.

    +
    + + + + + + +
    +
    +

    + $rate_limits + + + + +

    + + + + + + public + RateLimits|null + $rate_limits + = null + + +

    Current rate limit information, automatically updated after each request. +Tracks credits (not requests), as some requests may consume multiple credits.

    +
    + + + + + + +
    +

    $guzzle - +

    - protected - Client + protected + Client $guzzle @@ -379,7 +702,8 @@

    - + +

    phpdocumentor-element -property -protected - " + " >

    $token - +

    - protected - string + protected + string $token @@ -417,7 +741,8 @@

    - + +

    @@ -442,7 +767,7 @@

    @@ -450,7 +775,7 @@

    public - __construct(string $token) : mixed + __construct([string|null $token = null ][, LoggerInterface|null $logger = null ]) : mixed
    @@ -459,20 +784,50 @@

    Parameters
    - $token - : string -
    + $token + : string|null + = null
    -

    The API token for authentication.

    +

    The API token for authentication. If not provided, the token will be +automatically resolved from MARKETDATA_TOKEN environment variable or .env file. +An empty string is allowed for accessing free symbols like AAPL. +A valid token is required for authenticated endpoints. An invalid token will throw +UnauthorizedException during construction.

    +
    + +
    +
    + $logger + : LoggerInterface|null + = null
    +
    +

    PSR-3 logger instance. If not provided, uses the default logger.

    +
    + Tags + - +
    +
    +
    + throws +
    +
    + UnauthorizedException + +

    If the token is invalid (non-empty but returns 401 from /user endpoint)

    +
    +
    +
    + + +
    -

    Execute a single API request.

    +

    Execute a single API request with retry logic.

    public - execute(string $method[, array<string|int, mixed> $arguments = [] ]) : object + execute(string $method[, array<string|int, mixed> $arguments = [] ]) : object
    @@ -506,8 +861,8 @@

    Parameters
    - $method - : string + $method + : string

    The API method to call.

    @@ -515,9 +870,9 @@
    Parameters
    - $arguments - : array<string|int, mixed> - = []
    + $arguments + : array<string|int, mixed> + = []

    The arguments for the API call.

    @@ -547,11 +902,35 @@
    ApiException +
    +
    + throws +
    +
    + RequestError + + +
    +
    + throws +
    +
    + BadStatusCodeError + + +
    +
    + throws +
    +
    + UnauthorizedException + +
    + -
    Return values
    object @@ -576,30 +955,45 @@

    -

    Execute multiple API calls in parallel.

    +

    Execute multiple API calls in parallel with concurrency limiting.

    public - execute_in_parallel(array<string|int, mixed> $calls) : array<string|int, mixed> + execute_in_parallel(array<string|int, mixed> $calls[, array<string|int, mixed>|null &$failedRequests = null ]) : array<string|int, mixed>
    - +

    Uses Guzzle's EachPromise to maintain a sliding window of concurrent requests. +Unlike batch processing, this approach starts new requests as soon as previous +ones complete, maintaining optimal throughput up to MAX_CONCURRENT_REQUESTS (50).

    +
    +

    Parameters
    - $calls - : array<string|int, mixed> + $calls + : array<string|int, mixed>

    An array of method calls, each containing the method name and arguments.

    +
    +
    + $failedRequests + : array<string|int, mixed>|null + = null
    +
    +

    Optional by-reference array to collect failed requests instead of throwing. +When provided, exceptions are stored here keyed by their call index, +allowing callers to handle partial failures.

    +
    +
    @@ -616,17 +1010,20 @@
    Throwable - +

    When $failedRequests is not provided and any request fails.

    +
    +
    + -
    Return values
    array<string|int, mixed> — -

    An array of decoded JSON responses.

    +

    An array of decoded JSON responses. When $failedRequests is provided, successful responses +are keyed by their original call index. Otherwise, returns a sequential array.

    @@ -638,36 +1035,41 @@
    Return values
    -public " > -

    - setGuzzle() - +

    + extractRateLimitsFromResponse() +

    -

    Set a custom Guzzle client.

    +

    Extract rate limit information from response headers.

    public - setGuzzle(Client $guzzleClient) : void + extractRateLimitsFromResponse(ResponseInterface $response) : RateLimits|null
    - +

    This method extracts rate limit data from API response headers and returns +a RateLimits object. Returns null if headers are missing, allowing +graceful degradation. This method is designed to be reusable for future +automatic rate limit tracking across all API requests.

    +
    +
    Parameters
    - $guzzleClient - : Client + $response + : ResponseInterface
    -

    The Guzzle client to use.

    +

    The HTTP response.

    @@ -675,93 +1077,209 @@
    Parameters
    + + +
    +
    Return values
    + RateLimits|null + — +

    The rate limit information, or null if headers are missing.

    +
    + +
    + +
    +
    +

    + getUserAgent() + + +

    + + +

    Build SDK User-Agent value.

    + + + public + static getUserAgent() : string + +
    +
    + + + + +
    +
    Return values
    + string +
    +
    -

    - async() - +

    + getVersion() +

    -

    Perform an asynchronous API request.

    +

    Resolve SDK version from Composer metadata when available.

    - protected - async(string $method[, array<string|int, mixed> $arguments = [] ]) : PromiseInterface + public + static getVersion() : string
    + + + + + +
    +
    Return values
    + string +
    + +
    +
    +

    + makeRawRequest() + + +

    + + +

    Make a raw API request and return the response object.

    + + + public + makeRawRequest(string $method[, array<string|int, mixed> $arguments = [] ]) : ResponseInterface + +
    +
    + +

    This method is useful for endpoints that need access to response headers, +such as the /user/ endpoint for rate limit information.

    +
    +
    Parameters
    - $method - : string + $method + : string
    -

    The API method to call.

    +

    The API method to call (no API version prefix).

    - $arguments - : array<string|int, mixed> - = []
    + $arguments + : array<string|int, mixed> + = []
    -

    The arguments for the API call.

    +

    Optional query parameters.

    +
    + Tags + - +
    +
    +
    + throws +
    +
    + GuzzleException + + +
    +
    + throws +
    +
    + UnauthorizedException + + +
    +
    + +
    Return values
    - PromiseInterface + ResponseInterface + — +

    The HTTP response.

    +
    +
    -

    - headers() - +

    + setGuzzle() +

    -

    Generate headers for API requests.

    +

    Set a custom Guzzle client.

    - protected - headers([string $format = 'json' ]) : array<string|int, mixed> + public + setGuzzle(Client $guzzleClient) : void
    @@ -770,11 +1288,11 @@

    Parameters
    - $format - : string - = 'json'
    + $guzzleClient + : Client +
    -

    The desired response format (json, csv, or html).

    +

    The Guzzle client to use.

    @@ -782,17 +1300,881 @@
    Parameters
    + + +
    +
    +

    + validateResponseStatusCode() + -
    -
    Return values
    - array<string|int, mixed> - — -

    An array of headers.

    +

    + + +

    Validate response status code and raise appropriate exceptions.

    + + + public + validateResponseStatusCode(ResponseInterface $response[, bool $raiseForStatus = true ][, string|null $requestUrl = null ]) : void + +
    +
    + + +
    Parameters
    +
    +
    + $response + : ResponseInterface +
    +
    +

    The HTTP response.

    - +
    +
    + $raiseForStatus + : bool + = true
    +
    +

    Whether to raise for non-2xx status codes.

    +
    + +
    +
    + $requestUrl + : string|null + = null
    +
    +

    The URL that was requested.

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + RequestError + + +
    +
    + throws +
    +
    + BadStatusCodeError + + +
    +
    + throws +
    +
    + UnauthorizedException + + +
    +
    + + + +
    +
    +

    + _setup_rate_limits() + + +

    + + +

    Set up initial rate limits by fetching from the /user/ endpoint.

    + + + protected + _setup_rate_limits() : void + +
    +
    + +

    This method is called during client construction to initialize rate limit +information. If the request fails, rate_limits will remain null until the +first successful request with rate limit headers.

    +

    Rate limits track credits, not requests. Most requests consume 1 credit, +but bulk requests or options requests may consume multiple credits.

    +

    If the token is empty, validation is skipped to allow free symbols like AAPL. +If the token is invalid (returns 401), an UnauthorizedException is thrown +to prevent client creation.

    +
    + + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + UnauthorizedException + +

    If the token is invalid (non-empty but returns 401)

    +
    + +
    +
    + + + + +
    +
    +

    + async() + + +

    + + +

    Perform an asynchronous API request with retry logic.

    + + + protected + async(string $method[, array<string|int, mixed> $arguments = [] ]) : PromiseInterface + +
    +
    + + +
    Parameters
    +
    +
    + $method + : string +
    +
    +

    The API method to call.

    +
    + +
    +
    + $arguments + : array<string|int, mixed> + = []
    +
    +

    The arguments for the API call.

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + RequestError + + +
    +
    + throws +
    +
    + BadStatusCodeError + + +
    +
    + throws +
    +
    + UnauthorizedException + + +
    +
    + + + +
    +
    Return values
    + PromiseInterface +
    + +
    +
    +

    + calculateBackoffDelay() + + +

    + + +

    Calculate exponential backoff delay.

    + + + protected + calculateBackoffDelay(int $attempt) : float + +
    +
    + + +
    Parameters
    +
    +
    + $attempt + : int +
    +
    +

    The current attempt number (1-based).

    +
    + +
    +
    + + + + + +
    +
    Return values
    + float + — +

    The delay in seconds.

    +
    + +
    + +
    +
    +

    + createDelayedPromise() + + +

    + + +

    Create a promise that resolves after a delay.

    + + + protected + createDelayedPromise(float $delay) : PromiseInterface + +
    +
    + +

    Note: PHP doesn't have native async timers, so this uses a micro-delay +approach. For true non-blocking behavior, an event loop would be needed. +This implementation provides the delay while maintaining promise chaining.

    +
    + +
    Parameters
    +
    +
    + $delay + : float +
    +
    +

    The delay in seconds.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + PromiseInterface + — +

    A promise that resolves after the delay.

    +
    + +
    + +
    +
    +

    + getErrorMessage() + + +

    + + +

    Get error message from response.

    + + + protected + getErrorMessage(ResponseInterface $response) : string + +
    +
    + + +
    Parameters
    +
    +
    + $response + : ResponseInterface +
    +
    +

    The HTTP response.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    The error message.

    +
    + +
    + +
    +
    +

    + getServicePath() + + +

    + + +

    Get service path from method path using hardcoded mapping.

    + + + protected + getServicePath(string $method) : string|null + +
    +
    + +

    Maps method paths like "v1/stocks/quotes/AAPL" to service paths like "/v1/stocks/quotes/". +Returns null for status endpoint (to avoid checking its own status) or unknown services.

    +
    + +
    Parameters
    +
    +
    + $method + : string +
    +
    +

    The method path (e.g., "v1/stocks/quotes/AAPL").

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string|null + — +

    The service path (e.g., "/v1/stocks/quotes/") or null if not found/special case.

    +
    + +
    + +
    +
    +

    + headers() + + +

    + + +

    Generate headers for API requests.

    + + + protected + headers([string $format = 'json' ]) : array<string|int, mixed> + +
    +
    + + +
    Parameters
    +
    +
    + $format + : string + = 'json'
    +
    +

    The desired response format (json, csv, or html).

    +
    + +
    +
    + + + + + +
    +
    Return values
    + array<string|int, mixed> + — +

    An array of headers.

    +
    + +
    + +
    +
    +

    + isInternalRequest() + + +

    + + +

    Check if a URL is for an internal request.

    + + + protected + isInternalRequest(string $url) : bool + +
    +
    + +

    Internal requests (rate limit setup, API status) are logged at DEBUG level. +API requests are logged at INFO level.

    +
    + +
    Parameters
    +
    +
    + $url + : string +
    +
    +

    The request URL.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + bool + — +

    True if internal request, false otherwise.

    +
    + +
    + +
    +
    +

    + logRequest() + + +

    + + +

    Log a completed HTTP request.

    + + + protected + logRequest(string $method, ResponseInterface $response, float $durationMs, string $url[, string $logLevel = 'info' ]) : void + +
    +
    + +

    Logs one line per request with format: METHOD STATUS DURATION REQUEST_ID URL

    +
    + +
    Parameters
    +
    +
    + $method + : string +
    +
    +

    HTTP method (GET, POST, etc.).

    +
    + +
    +
    + $response + : ResponseInterface +
    +
    +

    The HTTP response.

    +
    + +
    +
    + $durationMs + : float +
    +
    +

    Request duration in milliseconds.

    +
    + +
    +
    + $url + : string +
    +
    +

    The full request URL.

    +
    + +
    +
    + $logLevel + : string + = 'info'
    +
    +

    Log level: 'info' for API requests, 'debug' for internal.

    +
    + +
    +
    + + + + + + +
    +
    +

    + processResponse() + + +

    + + +

    Process the response and return the appropriate object.

    + + + protected + processResponse(ResponseInterface $response, string $format, array<string|int, mixed> $arguments[, string|null $requestUrl = null ]) : object + +
    +
    + + +
    Parameters
    +
    +
    + $response + : ResponseInterface +
    +
    +

    The HTTP response.

    +
    + +
    +
    + $format + : string +
    +
    +

    The response format.

    +
    + +
    +
    + $arguments + : array<string|int, mixed> +
    +
    +

    The request arguments.

    +
    + +
    +
    + $requestUrl + : string|null + = null
    +
    +

    The URL that was requested.

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + ApiException + + +
    +
    + + + +
    +
    Return values
    + object + — +

    The processed response.

    +
    + +
    + +
    +
    +

    + shouldSkipRetryDueToOfflineService() + + +

    + + +

    Check if service is offline and should skip retries.

    + + + protected + shouldSkipRetryDueToOfflineService(string $method) : bool + +
    +
    + + +
    Parameters
    +
    +
    + $method + : string +
    +
    +

    The method path being called.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + bool + — +

    True if service is offline (should skip retries), false otherwise.

    +
    + +
    + +
    +
    +

    + waitForRetry() + + +

    + + +

    Wait for retry with exponential backoff.

    + + + protected + waitForRetry(int $attempt) : void + +
    +
    + + +
    Parameters
    +
    +
    + $attempt + : int +
    +
    +

    The current attempt number (1-based).

    +
    + +
    +
    + + + + + +
    @@ -832,6 +2214,8 @@
    Return values
    if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } @@ -909,12 +2293,17 @@
    Return values
  • Properties
  • @@ -926,9 +2315,24 @@
    Return values
  • __construct()
  • execute()
  • execute_in_parallel()
  • +
  • extractRateLimitsFromResponse()
  • +
  • getUserAgent()
  • +
  • getVersion()
  • +
  • makeRawRequest()
  • setGuzzle()
  • +
  • validateResponseStatusCode()
  • +
  • _setup_rate_limits()
  • async()
  • +
  • calculateBackoffDelay()
  • +
  • createDelayedPromise()
  • +
  • getErrorMessage()
  • +
  • getServicePath()
  • headers()
  • +
  • isInternalRequest()
  • +
  • logRequest()
  • +
  • processResponse()
  • +
  • shouldSkipRetryDueToOfflineService()
  • +
  • waitForRetry()
  • diff --git a/docs/classes/MarketDataApp-Endpoints-Markets.html b/docs/classes/MarketDataApp-Endpoints-Markets.html index a8975887..6f5001f9 100644 --- a/docs/classes/MarketDataApp-Endpoints-Markets.html +++ b/docs/classes/MarketDataApp-Endpoints-Markets.html @@ -80,6 +80,14 @@

  • Exceptions +
  • +
  • + Logging + +
  • +
  • + Retry +
  • Traits @@ -131,7 +139,7 @@

    uses - UniversalParameters + UniversalParameters, ValidatesInputs

    @@ -142,7 +150,7 @@

    @@ -152,10 +160,8 @@

    - - - - + +

    Table of Contents @@ -217,6 +223,13 @@

    Get the market status for a specific country and date range.
    +
    + canParseAsDate() + +  : bool +
    +
    Check if a string can be parsed as a date.
    +
    execute() @@ -231,6 +244,83 @@

    Execute multiple API requests in parallel with universal parameters.
    +
    + mergeParameters() + +  : Parameters +
    +
    Merge method-level parameters with client default parameters.
    + +
    + parseDateToTimestamp() + +  : int|null +
    +
    Parse a date string to unix timestamp.
    + +
    + validateCountryCode() + +  : void +
    +
    Validate ISO 3166 two-letter country code.
    + +
    + validateDateRange() + +  : void +
    +
    Validate date range logic.
    + +
    + validateNonEmptyArray() + +  : void +
    +
    Validate that an array is non-empty.
    + +
    + validateNonEmptyString() + +  : void +
    +
    Validate that a string is non-empty.
    + +
    + validateNumericRange() + +  : void +
    +
    Validate that min < max when both are provided.
    + +
    + validatePositiveInteger() + +  : void +
    +
    Validate that an integer is positive if provided.
    + +
    + validatePositiveNumber() + +  : void +
    +
    Validate that a number (int or float) is positive if provided.
    + +
    + validateResolution() + +  : void +
    +
    Validate resolution format.
    + +
    + validateSymbols() + +  : void +
    +
    Validate symbols array (trim and ensure non-empty).
    + @@ -252,7 +342,7 @@

    @@ -272,9 +362,8 @@

    - - - + + @@ -289,27 +378,27 @@

    phpdocumentor-element -property -private - " + " >

    $client - +

    - private - Client + private + Client $client @@ -319,7 +408,8 @@

    - + + @@ -344,7 +434,7 @@

    @@ -352,7 +442,7 @@

    public - __construct(Client $client) : mixed + __construct(Client $client) : mixed
    @@ -361,8 +451,8 @@

    Parameters
    - $client - : Client + $client + : Client

    The Market Data API client instance.

    @@ -373,8 +463,8 @@
    Parameters
    + -
    @@ -399,9 +489,11 @@

    public - status([string $country = "US" ][, string|null $date = null ][, string|null $from = null ][, string|null $to = null ][, int|null $countback = null ][, Parameters|null $parameters = null ]) : Statuses + status([string $country = "US" ][, string|null $date = null ][, string|null $from = null ][, string|null $to = null ][, int|null $countback = null ][, Parameters|null $parameters = null ]) : Statuses
    +
    APIYes
    +

    Get the past, present, or future status for a stock market. The endpoint will respond with "open" for trading @@ -411,9 +503,9 @@

    Parameters
    - $country - : string - = "US"
    + $country + : string + = "US"

    The country. Use the two-digit ISO 3166 country code. If no country is specified, US will be assumed. Only countries that Market Data supports for @@ -422,9 +514,9 @@

    Parameters
    - $date - : string|null - = null
    + $date + : string|null + = null

    Consult whether the market was open or closed on the specified date. Accepted timestamp inputs: ISO 8601, unix, spreadsheet.

    @@ -432,9 +524,9 @@
    Parameters
    - $from - : string|null - = null
    + $from + : string|null + = null

    The earliest date (inclusive). If you use countback, from is not required. Accepted timestamp inputs: ISO 8601, unix, spreadsheet.

    @@ -442,9 +534,9 @@
    Parameters
    - $to - : string|null - = null
    + $to + : string|null + = null

    The last date (inclusive). Accepted timestamp inputs: ISO 8601, unix, spreadsheet.

    @@ -452,9 +544,9 @@
    Parameters
    - $countback - : int|null - = null
    + $countback + : int|null + = null

    Countback will fetch a number of dates before to If you use from, countback is not required.

    @@ -462,9 +554,9 @@
    Parameters
    - $parameters - : Parameters|null - = null
    + $parameters + : Parameters|null + = null

    Universal parameters for all methods (such as format).

    @@ -480,6 +572,28 @@
    + link +
    +
    +

    API Documentation

    +
    + +
    +
    + example +
    +
    + +

    // Get current market status +$status = $client->markets->status();

    +

    // Check if market was open on a specific date +$status = $client->markets->status(date: '2024-01-01');

    +

    // Get market calendar for a date range +$status = $client->markets->status(from: '2024-01-01', to: '2024-01-31');

    +
    + +
    +
    throws
    @@ -489,13 +603,74 @@
    + -
    Return values
    Statuses
    +

    +
    +

    + canParseAsDate() + + +

    + + +

    Check if a string can be parsed as a date.

    + + + protected + canParseAsDate(string|null $value) : bool + +
    +
    + +

    Similar to Python SDK's check_is_date() function. +Returns true if the value contains "-" or "/" (indicating parseable date format) +or is numeric (unix timestamp or spreadsheet format).

    +

    This allows relative dates ("today", "yesterday", "-5 days") and option +expiration dates ("December expiration") to pass through without validation.

    +
    + +
    Parameters
    +
    +
    + $value + : string|null +
    +
    +

    The value to check

    +
    + +
    +
    + + + + + +
    +
    Return values
    + bool + — +

    True if the value can be parsed as a date

    +
    + +
    +
    @@ -519,7 +694,7 @@

    protected - execute(string $method, array<string|int, mixed> $arguments, Parameters|null $parameters) : object + execute(string $method, array<string|int, mixed> $arguments, Parameters|null $parameters) : object
    @@ -528,8 +703,8 @@

    Parameters
    - $method - : string + $method + : string

    The API method to call.

    @@ -537,8 +712,8 @@
    Parameters
    - $arguments - : array<string|int, mixed> + $arguments + : array<string|int, mixed>

    The arguments for the API call.

    @@ -546,8 +721,8 @@
    Parameters
    - $parameters - : Parameters|null + $parameters + : Parameters|null

    Optional Parameters object for additional settings.

    @@ -558,8 +733,8 @@
    Parameters
    + -
    Return values
    object @@ -584,7 +759,7 @@

    @@ -592,7 +767,7 @@

    protected - execute_in_parallel(array<string|int, mixed> $calls[, Parameters|null $parameters = null ]) : array<string|int, mixed> + execute_in_parallel(array<string|int, mixed> $calls[, Parameters|null $parameters = null ][, array<string|int, mixed>|null &$failedRequests = null ]) : array<string|int, mixed>
    @@ -601,8 +776,8 @@

    Parameters
    - $calls - : array<string|int, mixed> + $calls + : array<string|int, mixed>

    An array of method calls, each containing the method name and arguments.

    @@ -610,13 +785,23 @@
    Parameters
    - $parameters - : Parameters|null - = null
    + $parameters + : Parameters|null + = null

    Optional Parameters object for additional settings.

    +
    +
    + $failedRequests + : array<string|int, mixed>|null + = null
    +
    +

    Optional by-reference array to collect failed requests instead of throwing. +When provided, exceptions are stored here keyed by their call index.

    +
    +
    @@ -633,21 +818,820 @@
    Throwable - +

    When $failedRequests is not provided and any request fails.

    +
    +
    + -
    Return values
    array<string|int, mixed> — -

    An array of API responses.

    +

    An array of API responses. When $failedRequests is provided, results are keyed by original call index.

    +
    + +
    + +
    +
    +

    + mergeParameters() + + +

    + + +

    Merge method-level parameters with client default parameters.

    + + + protected + mergeParameters(Parameters|null $methodParams) : Parameters + +
    +
    + +

    Priority order (highest to lowest):

    +
      +
    1. Method-level parameters (if provided)
    2. +
    3. Client default parameters ($this->client->default_params)
    4. +
    5. Default Parameters() values
    6. +
    +
    + +
    Parameters
    +
    +
    + $methodParams + : Parameters|null +
    +
    +

    Method-level parameters, or null to use only client defaults.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + Parameters + — +

    Merged parameters instance.

    +
    + +
    + +
    +
    +

    + parseDateToTimestamp() + + +

    + + +

    Parse a date string to unix timestamp.

    + + + protected + parseDateToTimestamp(string|null $value) : int|null + +
    +
    + +

    Handles ISO 8601, unix timestamps, spreadsheet dates, and American format.

    +
    + +
    Parameters
    +
    +
    + $value + : string|null +
    +
    +

    The date string to parse

    +
    + +
    +
    + + + + + +
    +
    Return values
    + int|null + — +

    Unix timestamp or null if cannot be parsed

    +
    +
    +

    + validateCountryCode() + + +

    + + +

    Validate ISO 3166 two-letter country code.

    + + + protected + validateCountryCode(string $country) : void + +
    +
    + + +
    Parameters
    +
    +
    + $country + : string +
    +
    +

    The country code to validate

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If country code is invalid

    +
    + +
    +
    + + + + +
    +
    +

    + validateDateRange() + + +

    + + +

    Validate date range logic.

    + + + protected + validateDateRange(string|null $from, string|null $to[, int|null $countback = null ][, string $context = '' ]) : void + +
    +
    + +

    Rules:

    +
      +
    • If to is provided, it requires either from OR countback (but not both)
    • +
    • If both from and to are parseable dates, validates that from < to
    • +
    • If countback is provided, it must be a positive integer
    • +
    +

    This allows relative dates and option expiration dates to pass through without +strict format validation.

    +
    + +
    Parameters
    +
    +
    + $from + : string|null +
    +
    +

    The start date

    +
    + +
    +
    + $to + : string|null +
    +
    +

    The end date

    +
    + +
    +
    + $countback + : int|null + = null
    +
    +

    The countback value

    +
    + +
    +
    + $context + : string + = ''
    +
    +

    Optional context for error messages

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If validation fails

    +
    + +
    +
    + + + + +
    +
    +

    + validateNonEmptyArray() + + +

    + + +

    Validate that an array is non-empty.

    + + + protected + validateNonEmptyArray(array<string|int, mixed> $value, string $fieldName) : void + +
    +
    + + +
    Parameters
    +
    +
    + $value + : array<string|int, mixed> +
    +
    +

    The value to validate

    +
    + +
    +
    + $fieldName + : string +
    +
    +

    The field name for error messages

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If array is empty

    +
    + +
    +
    + + + + +
    +
    +

    + validateNonEmptyString() + + +

    + + +

    Validate that a string is non-empty.

    + + + protected + validateNonEmptyString(string $value, string $fieldName) : void + +
    +
    + + +
    Parameters
    +
    +
    + $value + : string +
    +
    +

    The value to validate

    +
    + +
    +
    + $fieldName + : string +
    +
    +

    The field name for error messages

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If value is empty

    +
    + +
    +
    + + + + +
    +
    +

    + validateNumericRange() + + +

    + + +

    Validate that min < max when both are provided.

    + + + protected + validateNumericRange(float|null $min, float|null $max, string $minField, string $maxField) : void + +
    +
    + + +
    Parameters
    +
    +
    + $min + : float|null +
    +
    +

    The minimum value

    +
    + +
    +
    + $max + : float|null +
    +
    +

    The maximum value

    +
    + +
    +
    + $minField + : string +
    +
    +

    The minimum field name for error messages

    +
    + +
    +
    + $maxField + : string +
    +
    +

    The maximum field name for error messages

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If min >= max

    +
    + +
    +
    + + + + +
    +
    +

    + validatePositiveInteger() + + +

    + + +

    Validate that an integer is positive if provided.

    + + + protected + validatePositiveInteger(int|null $value, string $fieldName) : void + +
    +
    + + +
    Parameters
    +
    +
    + $value + : int|null +
    +
    +

    The value to validate

    +
    + +
    +
    + $fieldName + : string +
    +
    +

    The field name for error messages

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If value is not positive

    +
    + +
    +
    + + + + +
    +
    +

    + validatePositiveNumber() + + +

    + + +

    Validate that a number (int or float) is positive if provided.

    + + + protected + validatePositiveNumber(int|float|null $value, string $fieldName) : void + +
    +
    + + +
    Parameters
    +
    +
    + $value + : int|float|null +
    +
    +

    The value to validate

    +
    + +
    +
    + $fieldName + : string +
    +
    +

    The field name for error messages

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If value is not positive

    +
    + +
    +
    + + + + +
    +
    +

    + validateResolution() + + +

    + + +

    Validate resolution format.

    + + + protected + validateResolution(string $resolution) : void + +
    +
    + +

    Valid resolutions: minutely, hourly, daily, weekly, monthly, yearly, +or numeric with optional suffix (1, 3, 5, 15, 30, 45, H, 1H, 2H, D, 1D, 2D, etc.)

    +
    + +
    Parameters
    +
    +
    + $resolution + : string +
    +
    +

    The resolution to validate

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If resolution is invalid

    +
    + +
    +
    + + + + +
    +
    +

    + validateSymbols() + + +

    + + +

    Validate symbols array (trim and ensure non-empty).

    + + + protected + validateSymbols(array<string|int, mixed> $symbols) : void + +
    +
    + + +
    Parameters
    +
    +
    + $symbols + : array<string|int, mixed> +
    +
    +

    The symbols array to validate

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If symbols array is invalid

    +
    + +
    +
    + + + +
    @@ -687,6 +1671,8 @@
    Return values
    if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } @@ -778,8 +1764,20 @@
    Return values
  • diff --git a/docs/classes/MarketDataApp-Endpoints-MutualFunds.html b/docs/classes/MarketDataApp-Endpoints-MutualFunds.html index dac5c996..e87ac48b 100644 --- a/docs/classes/MarketDataApp-Endpoints-MutualFunds.html +++ b/docs/classes/MarketDataApp-Endpoints-MutualFunds.html @@ -80,6 +80,14 @@

  • Exceptions +
  • +
  • + Logging + +
  • +
  • + Retry +
  • Traits @@ -131,7 +139,7 @@

    uses - UniversalParameters + UniversalParameters, ValidatesInputs

    @@ -142,7 +150,7 @@

    @@ -152,10 +160,8 @@

    - - - - + +

    Table of Contents @@ -217,6 +223,13 @@

    Get historical price candles for a mutual fund.
    +
    + canParseAsDate() + +  : bool +
    +
    Check if a string can be parsed as a date.
    +
    execute() @@ -231,6 +244,83 @@

    Execute multiple API requests in parallel with universal parameters.
    +
    + mergeParameters() + +  : Parameters +
    +
    Merge method-level parameters with client default parameters.
    + +
    + parseDateToTimestamp() + +  : int|null +
    +
    Parse a date string to unix timestamp.
    + +
    + validateCountryCode() + +  : void +
    +
    Validate ISO 3166 two-letter country code.
    + +
    + validateDateRange() + +  : void +
    +
    Validate date range logic.
    + +
    + validateNonEmptyArray() + +  : void +
    +
    Validate that an array is non-empty.
    + +
    + validateNonEmptyString() + +  : void +
    +
    Validate that a string is non-empty.
    + +
    + validateNumericRange() + +  : void +
    +
    Validate that min < max when both are provided.
    + +
    + validatePositiveInteger() + +  : void +
    +
    Validate that an integer is positive if provided.
    + +
    + validatePositiveNumber() + +  : void +
    +
    Validate that a number (int or float) is positive if provided.
    + +
    + validateResolution() + +  : void +
    +
    Validate resolution format.
    + +
    + validateSymbols() + +  : void +
    +
    Validate symbols array (trim and ensure non-empty).
    + @@ -252,7 +342,7 @@

    @@ -272,9 +362,8 @@

    - - - + + @@ -289,27 +378,27 @@

    phpdocumentor-element -property -private - " + " >

    $client - +

    - private - Client + private + Client $client @@ -319,7 +408,8 @@

    - + + @@ -344,7 +434,7 @@

    @@ -352,7 +442,7 @@

    public - __construct(Client $client) : mixed + __construct(Client $client) : mixed
    @@ -361,8 +451,8 @@

    Parameters
    - $client - : Client + $client + : Client

    The Market Data API client instance.

    @@ -373,8 +463,8 @@
    Parameters
    + -
    @@ -399,17 +489,19 @@

    public - candles(string $symbol, string $from[, string|null $to = null ][, string $resolution = 'D' ][, int|null $countback = null ][, Parameters|null $parameters = null ]) : Candles + candles(string $symbol, string $from[, string|null $to = null ][, string $resolution = 'D' ][, int|null $countback = null ][, Parameters|null $parameters = null ]) : Candles
    +
    APIYes
    +

    Parameters
    - $symbol - : string + $symbol + : string

    The mutual fund's ticker symbol.

    @@ -417,8 +509,8 @@
    Parameters
    - $from - : string + $from + : string

    The leftmost candle on a chart (inclusive). If you use countback, to is not @@ -427,9 +519,9 @@

    Parameters
    - $to - : string|null - = null
    + $to + : string|null + = null

    The rightmost candle on a chart (inclusive). Accepted timestamp inputs: ISO 8601, unix, spreadsheet.

    @@ -437,9 +529,9 @@
    Parameters
    - $resolution - : string - = 'D'
    + $resolution + : string + = 'D'

    The duration of each candle.

      @@ -454,9 +546,9 @@
      Parameters
    - $countback - : int|null - = null
    + $countback + : int|null + = null

    Will fetch a number of candles before (to the left of) to. If you use from, countback is not required.

    @@ -464,9 +556,9 @@
    Parameters
    - $parameters - : Parameters|null - = null
    + $parameters + : Parameters|null + = null

    Universal parameters for all methods (such as format).

    @@ -482,6 +574,36 @@
    + link +
    +
    +

    API Documentation

    +
    + +
    +
    + see +
    +
    + Stocks::candles() + +

    For stock candles

    +
    + +
    +
    + example +
    +
    + +

    // Get daily candles for a mutual fund +$candles = $client->mutual_funds->candles('VFINX', '2024-01-01', '2024-01-31');

    +

    // Get weekly candles +$candles = $client->mutual_funds->candles('VFINX', '2023-01-01', '2023-12-31', 'W');

    +
    + +
    +
    throws
    @@ -491,13 +613,74 @@
    + -
    Return values
    Candles
    +
    +
    +

    + canParseAsDate() + + +

    + + +

    Check if a string can be parsed as a date.

    + + + protected + canParseAsDate(string|null $value) : bool + +
    +
    + +

    Similar to Python SDK's check_is_date() function. +Returns true if the value contains "-" or "/" (indicating parseable date format) +or is numeric (unix timestamp or spreadsheet format).

    +

    This allows relative dates ("today", "yesterday", "-5 days") and option +expiration dates ("December expiration") to pass through without validation.

    +
    + +
    Parameters
    +
    +
    + $value + : string|null +
    +
    +

    The value to check

    +
    + +
    +
    + + + + + +
    +
    Return values
    + bool + — +

    True if the value can be parsed as a date

    +
    + +
    +
    @@ -521,7 +704,7 @@

    protected - execute(string $method, array<string|int, mixed> $arguments, Parameters|null $parameters) : object + execute(string $method, array<string|int, mixed> $arguments, Parameters|null $parameters) : object
    @@ -530,8 +713,8 @@

    Parameters
    - $method - : string + $method + : string

    The API method to call.

    @@ -539,8 +722,8 @@
    Parameters
    - $arguments - : array<string|int, mixed> + $arguments + : array<string|int, mixed>

    The arguments for the API call.

    @@ -548,8 +731,8 @@
    Parameters
    - $parameters - : Parameters|null + $parameters + : Parameters|null

    Optional Parameters object for additional settings.

    @@ -560,8 +743,8 @@
    Parameters
    + -
    Return values
    object @@ -586,7 +769,7 @@

    @@ -594,7 +777,7 @@

    protected - execute_in_parallel(array<string|int, mixed> $calls[, Parameters|null $parameters = null ]) : array<string|int, mixed> + execute_in_parallel(array<string|int, mixed> $calls[, Parameters|null $parameters = null ][, array<string|int, mixed>|null &$failedRequests = null ]) : array<string|int, mixed>
    @@ -603,8 +786,8 @@

    Parameters
    - $calls - : array<string|int, mixed> + $calls + : array<string|int, mixed>

    An array of method calls, each containing the method name and arguments.

    @@ -612,13 +795,23 @@
    Parameters
    - $parameters - : Parameters|null - = null
    + $parameters + : Parameters|null + = null

    Optional Parameters object for additional settings.

    +
    +
    + $failedRequests + : array<string|int, mixed>|null + = null
    +
    +

    Optional by-reference array to collect failed requests instead of throwing. +When provided, exceptions are stored here keyed by their call index.

    +
    +
    @@ -635,21 +828,820 @@
    Throwable - +

    When $failedRequests is not provided and any request fails.

    +
    +
    + -
    Return values
    array<string|int, mixed> — -

    An array of API responses.

    +

    An array of API responses. When $failedRequests is provided, results are keyed by original call index.

    +
    + +
    + +
    +
    +

    + mergeParameters() + + +

    + + +

    Merge method-level parameters with client default parameters.

    + + + protected + mergeParameters(Parameters|null $methodParams) : Parameters + +
    +
    + +

    Priority order (highest to lowest):

    +
      +
    1. Method-level parameters (if provided)
    2. +
    3. Client default parameters ($this->client->default_params)
    4. +
    5. Default Parameters() values
    6. +
    +
    + +
    Parameters
    +
    +
    + $methodParams + : Parameters|null +
    +
    +

    Method-level parameters, or null to use only client defaults.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + Parameters + — +

    Merged parameters instance.

    +
    + +
    + +
    +
    +

    + parseDateToTimestamp() + + +

    + + +

    Parse a date string to unix timestamp.

    + + + protected + parseDateToTimestamp(string|null $value) : int|null + +
    +
    + +

    Handles ISO 8601, unix timestamps, spreadsheet dates, and American format.

    +
    + +
    Parameters
    +
    +
    + $value + : string|null +
    +
    +

    The date string to parse

    +
    + +
    +
    + + + + + +
    +
    Return values
    + int|null + — +

    Unix timestamp or null if cannot be parsed

    +
    +
    +

    + validateCountryCode() + + +

    + + +

    Validate ISO 3166 two-letter country code.

    + + + protected + validateCountryCode(string $country) : void + +
    +
    + + +
    Parameters
    +
    +
    + $country + : string +
    +
    +

    The country code to validate

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If country code is invalid

    +
    + +
    +
    + + + + +
    +
    +

    + validateDateRange() + + +

    + + +

    Validate date range logic.

    + + + protected + validateDateRange(string|null $from, string|null $to[, int|null $countback = null ][, string $context = '' ]) : void + +
    +
    + +

    Rules:

    +
      +
    • If to is provided, it requires either from OR countback (but not both)
    • +
    • If both from and to are parseable dates, validates that from < to
    • +
    • If countback is provided, it must be a positive integer
    • +
    +

    This allows relative dates and option expiration dates to pass through without +strict format validation.

    +
    + +
    Parameters
    +
    +
    + $from + : string|null +
    +
    +

    The start date

    +
    + +
    +
    + $to + : string|null +
    +
    +

    The end date

    +
    + +
    +
    + $countback + : int|null + = null
    +
    +

    The countback value

    +
    + +
    +
    + $context + : string + = ''
    +
    +

    Optional context for error messages

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If validation fails

    +
    + +
    +
    + + + + +
    +
    +

    + validateNonEmptyArray() + + +

    + + +

    Validate that an array is non-empty.

    + + + protected + validateNonEmptyArray(array<string|int, mixed> $value, string $fieldName) : void + +
    +
    + + +
    Parameters
    +
    +
    + $value + : array<string|int, mixed> +
    +
    +

    The value to validate

    +
    + +
    +
    + $fieldName + : string +
    +
    +

    The field name for error messages

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If array is empty

    +
    + +
    +
    + + + + +
    +
    +

    + validateNonEmptyString() + + +

    + + +

    Validate that a string is non-empty.

    + + + protected + validateNonEmptyString(string $value, string $fieldName) : void + +
    +
    + + +
    Parameters
    +
    +
    + $value + : string +
    +
    +

    The value to validate

    +
    + +
    +
    + $fieldName + : string +
    +
    +

    The field name for error messages

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If value is empty

    +
    + +
    +
    + + + + +
    +
    +

    + validateNumericRange() + + +

    + + +

    Validate that min < max when both are provided.

    + + + protected + validateNumericRange(float|null $min, float|null $max, string $minField, string $maxField) : void + +
    +
    + + +
    Parameters
    +
    +
    + $min + : float|null +
    +
    +

    The minimum value

    +
    + +
    +
    + $max + : float|null +
    +
    +

    The maximum value

    +
    + +
    +
    + $minField + : string +
    +
    +

    The minimum field name for error messages

    +
    + +
    +
    + $maxField + : string +
    +
    +

    The maximum field name for error messages

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If min >= max

    +
    + +
    +
    + + + + +
    +
    +

    + validatePositiveInteger() + + +

    + + +

    Validate that an integer is positive if provided.

    + + + protected + validatePositiveInteger(int|null $value, string $fieldName) : void + +
    +
    + + +
    Parameters
    +
    +
    + $value + : int|null +
    +
    +

    The value to validate

    +
    + +
    +
    + $fieldName + : string +
    +
    +

    The field name for error messages

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If value is not positive

    +
    + +
    +
    + + + + +
    +
    +

    + validatePositiveNumber() + + +

    + + +

    Validate that a number (int or float) is positive if provided.

    + + + protected + validatePositiveNumber(int|float|null $value, string $fieldName) : void + +
    +
    + + +
    Parameters
    +
    +
    + $value + : int|float|null +
    +
    +

    The value to validate

    +
    + +
    +
    + $fieldName + : string +
    +
    +

    The field name for error messages

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If value is not positive

    +
    + +
    +
    + + + + +
    +
    +

    + validateResolution() + + +

    + + +

    Validate resolution format.

    + + + protected + validateResolution(string $resolution) : void + +
    +
    + +

    Valid resolutions: minutely, hourly, daily, weekly, monthly, yearly, +or numeric with optional suffix (1, 3, 5, 15, 30, 45, H, 1H, 2H, D, 1D, 2D, etc.)

    +
    + +
    Parameters
    +
    +
    + $resolution + : string +
    +
    +

    The resolution to validate

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If resolution is invalid

    +
    + +
    +
    + + + + +
    +
    +

    + validateSymbols() + + +

    + + +

    Validate symbols array (trim and ensure non-empty).

    + + + protected + validateSymbols(array<string|int, mixed> $symbols) : void + +
    +
    + + +
    Parameters
    +
    +
    + $symbols + : array<string|int, mixed> +
    +
    +

    The symbols array to validate

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If symbols array is invalid

    +
    + +
    +
    + + + +
    @@ -689,6 +1681,8 @@
    Return values
    if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } @@ -780,8 +1774,20 @@
    Return values
  • diff --git a/docs/classes/MarketDataApp-Endpoints-Options.html b/docs/classes/MarketDataApp-Endpoints-Options.html index 85edbed7..82a29e54 100644 --- a/docs/classes/MarketDataApp-Endpoints-Options.html +++ b/docs/classes/MarketDataApp-Endpoints-Options.html @@ -80,6 +80,14 @@

  • Exceptions +
  • +
  • + Logging + +
  • +
  • + Retry +
  • Traits @@ -131,7 +139,7 @@

    uses - UniversalParameters + UniversalParameters, ValidatesInputs

    @@ -142,7 +150,7 @@

    @@ -154,10 +162,8 @@

    - - - - + +

    Table of Contents @@ -243,7 +249,7 @@

     : Quotes -
    Get a current or historical end of day quote for a single options contract.
    +
    Get current or historical end of day quotes for one or more options contracts.
    strikes() @@ -251,8 +257,14 @@

     : Strikes

    Get a list of current or historical options strikes for an underlying symbol. If no optional parameters are -used, -the endpoint returns the strikes for every expiration in the chain.
    +used, the endpoint returns the strikes for every expiration in the chain. + +
    + canParseAsDate() + +  : bool +
    +
    Check if a string can be parsed as a date.
    execute() @@ -268,6 +280,104 @@

    Execute multiple API requests in parallel with universal parameters.
    +
    + mergeParameters() + +  : Parameters +
    +
    Merge method-level parameters with client default parameters.
    + +
    + mergeQuotesResponses() + +  : Quotes +
    +
    Merge multiple quotes responses into a single Quotes object.
    + +
    + parseDateToTimestamp() + +  : int|null +
    +
    Parse a date string to unix timestamp.
    + +
    + quotesMultiple() + +  : Quotes +
    +
    Get quotes for multiple option symbols concurrently.
    + +
    + quotesMultipleCsv() + +  : Quotes +
    +
    Handle CSV format for multiple option symbols.
    + +
    + validateCountryCode() + +  : void +
    +
    Validate ISO 3166 two-letter country code.
    + +
    + validateDateRange() + +  : void +
    +
    Validate date range logic.
    + +
    + validateNonEmptyArray() + +  : void +
    +
    Validate that an array is non-empty.
    + +
    + validateNonEmptyString() + +  : void +
    +
    Validate that a string is non-empty.
    + +
    + validateNumericRange() + +  : void +
    +
    Validate that min < max when both are provided.
    + +
    + validatePositiveInteger() + +  : void +
    +
    Validate that an integer is positive if provided.
    + +
    + validatePositiveNumber() + +  : void +
    +
    Validate that a number (int or float) is positive if provided.
    + +
    + validateResolution() + +  : void +
    +
    Validate resolution format.
    + +
    + validateSymbols() + +  : void +
    +
    Validate symbols array (trim and ensure non-empty).
    + @@ -289,7 +399,7 @@

    @@ -308,9 +418,8 @@

    - - - + + @@ -325,19 +434,19 @@

    phpdocumentor-element -property -private - " + " >

    $client - +

    @@ -345,8 +454,8 @@

    - private - Client + private + Client $client @@ -354,7 +463,8 @@

    - + + @@ -379,7 +489,7 @@

    @@ -387,7 +497,7 @@

    public - __construct(Client $client) : mixed + __construct(Client $client) : mixed
    @@ -396,8 +506,8 @@

    Parameters
    - $client - : Client + $client + : Client

    The MarketDataApp API client instance.

    @@ -408,8 +518,8 @@
    Parameters
    + -
    @@ -435,17 +545,19 @@

    public - expirations(string $symbol[, int|null $strike = null ][, string|null $date = null ][, Parameters|null $parameters = null ]) : Expirations + expirations(string $symbol[, int|float|null $strike = null ][, string|null $date = null ][, Parameters|null $parameters = null ]) : Expirations
    +
    APIYes
    +

    Parameters
    - $symbol - : string + $symbol + : string

    The underlying ticker symbol for the options chain you wish to lookup.

    @@ -453,19 +565,20 @@
    Parameters
    - $strike - : int|null - = null
    + $strike + : int|float|null + = null

    Limit the lookup of expiration dates to the strike provided. This will cause -the endpoint to only return expiration dates that include this strike.

    +the endpoint to only return expiration dates that include this strike. +Accepts decimal values (e.g., 12.5) for non-standard strikes.

    - $date - : string|null - = null
    + $date + : string|null + = null

    Use to lookup a historical list of expiration dates from a specific previous trading day. If date is omitted the expiration dates will be from the current @@ -475,9 +588,9 @@

    Parameters
    - $parameters - : Parameters|null - = null
    + $parameters + : Parameters|null + = null

    Universal parameters for all methods (such as format).

    @@ -493,6 +606,46 @@
    + link +
    +
    +

    API Documentation

    +
    + +
    +
    + see +
    +
    + strikes() + +

    For available strike prices

    +
    + +
    +
    + see +
    +
    + option_chain() + +

    For full option chain data

    +
    + +
    +
    + example +
    +
    + +

    // Get all expiration dates for AAPL +$expirations = $client->options->expirations('AAPL');

    +

    // Get expirations that have a $200 strike +$expirations = $client->options->expirations('AAPL', strike: 200);

    +
    + +
    +
    throws
    @@ -502,8 +655,8 @@
    + -
    Return values
    Expirations @@ -524,7 +677,7 @@

    @@ -532,9 +685,11 @@

    public - lookup(string $input[, Parameters|null $parameters = null ]) : Lookup + lookup(string $input[, Parameters|null $parameters = null ]) : Lookup
    +
    APIYes
    +

    This endpoint converts text such as "AAPL 7/28/23 $200 Call" to OCC option symbol format: AAPL230728C00200000.

    @@ -543,8 +698,8 @@

    Parameters
    - $input - : string + $input + : string

    The human-readable string input that contains

    @@ -558,9 +713,9 @@
    Parameters
    - $parameters - : Parameters|null - = null
    + $parameters + : Parameters|null + = null

    Universal parameters for all methods (such as format).

    This endpoint will translate the user's input into a valid OCC option symbol. @@ -571,9 +726,45 @@

    Parameters
    +
    + Tags + - +
    +
    +
    + link +
    +
    +

    API Documentation

    +
    + +
    +
    + see +
    +
    + quotes() + +

    Use the returned OCC symbol to get option quotes

    +
    + +
    +
    + example +
    +
    + +

    // Convert human-readable description to OCC symbol +$lookup = $client->options->lookup('AAPL 7/28/23 $200 Call'); +echo $lookup->option_symbol; // AAPL230728C00200000

    +
    + +
    +
    + +
    Return values
    Lookup @@ -594,7 +785,7 @@

    @@ -604,22 +795,19 @@

    public - option_chain(string $symbol[, string|null $date = null ][, string|Expiration $expiration = Expiration::ALL ][, string|null $from = null ][, string|null $to = null ][, int|null $month = null ][, int|null $year = null ][, bool $weekly = true ][, bool $monthly = true ][, bool $quarterly = true ][, bool $non_standard = true ][, int|null $dte = null ][, float|null $delta = null ][, Side|null $side = null ][, Range $range = Range::ALL ][, string|null $strike = null ][, int|null $strike_limit = null ][, float|null $min_bid = null ][, float|null $max_bid = null ][, float|null $min_ask = null ][, float|null $max_ask = null ][, float|null $min_bid_ask_spread = null ][, float|null $max_bid_ask_spread_pct = null ][, int|null $min_open_interest = null ][, int|null $min_volume = null ][, Parameters|null $parameters = null ]) : OptionChains + option_chain(string $symbol[, string|null $date = null ][, string|Expiration $expiration = null ][, string|null $from = null ][, string|null $to = null ][, int|null $month = null ][, int|null $year = null ][, bool $weekly = true ][, bool $monthly = true ][, bool $quarterly = true ][, bool $non_standard = null ][, int|null $dte = null ][, string|float|null $delta = null ][, Side|null $side = null ][, Range $range = Range::ALL ][, string|null $strike = null ][, int|null $strike_limit = null ][, float|null $min_bid = null ][, float|null $max_bid = null ][, float|null $min_ask = null ][, float|null $max_ask = null ][, float|null $max_bid_ask_spread = null ][, float|null $max_bid_ask_spread_pct = null ][, int|null $min_open_interest = null ][, int|null $min_volume = null ][, bool|null $am = null ][, bool|null $pm = null ][, Parameters|null $parameters = null ]) : OptionChains
    +
    APIYes
    +
    -

    CAUTION: The from, to, month, year, weekly, monthly, and quarterly filtering parameters are not yet supported -for -real-time quotes. If you are requesting a real-time quote you must request a single expiration date or request -all expirations.

    -
    - +

    Parameters
    - $symbol - : string + $symbol + : string

    The ticker symbol of the underlying asset.

    @@ -627,9 +815,9 @@
    Parameters
    - $date - : string|null - = null
    + $date + : string|null + = null

    Use to lookup a historical end of day options chain from a specific trading day. If no date is specified the chain will be @@ -640,9 +828,9 @@

    Parameters
    - $expiration - : string|Expiration - = Expiration::ALL
    + $expiration + : string|Expiration + = null
                                                 - Limits the option chain to a specific expiration date.
                                                  Accepted date inputs: ISO 8601, unix, spreadsheet. This
    @@ -666,9 +854,9 @@ 
    Parameters
    - $from - : string|null - = null
    + $from + : string|null + = null

    Limit the option chain to expiration dates after from (inclusive). Should be combined with to create a range. @@ -677,9 +865,9 @@

    Parameters
    - $to - : string|null - = null
    + $to + : string|null + = null

    Limit the option chain to expiration dates before to (not inclusive). Should be combined with from to create a range. @@ -688,9 +876,9 @@

    Parameters
    - $month - : int|null - = null
    + $month + : int|null + = null

    Limit the option chain to options that expire in a specific month (1-12).

    @@ -698,9 +886,9 @@
    Parameters
    - $year - : int|null - = null
    + $year + : int|null + = null

    Limit the option chain to options that expire in a specific year.

    @@ -708,9 +896,9 @@
    Parameters
    - $weekly - : bool - = true
    + $weekly + : bool + = true

    Limit the option chain to weekly expirations by setting weekly to true and omitting the monthly and quarterly parameters. If @@ -719,9 +907,9 @@

    Parameters
    - $monthly - : bool - = true
    + $monthly + : bool + = true

    Limit the option chain to standard monthly expirations by setting monthly to true and omitting the weekly and quarterly @@ -731,9 +919,9 @@

    Parameters
    - $quarterly - : bool - = true
    + $quarterly + : bool + = true

    Limit the option chain to quarterly expirations by setting quarterly to true and omitting the weekly and monthly @@ -743,9 +931,9 @@

    Parameters
    - $non_standard - : bool - = true
    + $non_standard + : bool + = null

    Include non-standard contracts by nonstandard to true. If set to false, no non-standard options expirations will be returned. @@ -754,9 +942,9 @@

    Parameters
    - $dte - : int|null - = null
    + $dte + : int|null + = null

    Days to expiry. Limit the option chain to a single expiration date closest to the dte provided. Should not be used together @@ -768,9 +956,9 @@

    Parameters
    - $delta - : float|null - = null
    + $delta + : string|float|null + = null
                                                 - Limit the option chain to a single strike closest to the
                                                  delta provided. (e.g. .50)
    @@ -788,9 +976,9 @@ 
    Parameters
    - $side - : Side|null - = null
    + $side + : Side|null + = null

    Limit the option chain to either call or put. If omitted, both sides will be returned.

    @@ -798,9 +986,9 @@
    Parameters
    - $range - : Range - = Range::ALL
    + $range + : Range + = Range::ALL

    Limit the option chain to strikes that are in the money, out of the money, at the money, or include all. If omitted all options @@ -809,9 +997,9 @@

    Parameters
    - $strike - : string|null - = null
    + $strike + : string|null + = null
    • Limit the option chain to options with the specific strike @@ -827,9 +1015,9 @@
      Parameters
    - $strike_limit - : int|null - = null
    + $strike_limit + : int|null + = null

    Limit the number of total strikes returned by the option chain. For example, if a complete chain included 30 strikes and the @@ -845,9 +1033,9 @@

    Parameters
    - $min_bid - : float|null - = null
    + $min_bid + : float|null + = null

    Limit the option chain to options with a bid price greater than or equal to the number provided.

    @@ -855,9 +1043,9 @@
    Parameters
    - $max_bid - : float|null - = null
    + $max_bid + : float|null + = null

    Limit the option chain to options with a bid price less than or equal to the number provided.

    @@ -865,9 +1053,9 @@
    Parameters
    - $min_ask - : float|null - = null
    + $min_ask + : float|null + = null

    Limit the option chain to options with an ask price greater than or equal to the number provided.

    @@ -875,9 +1063,9 @@
    Parameters
    - $max_ask - : float|null - = null
    + $max_ask + : float|null + = null

    Limit the option chain to options with an ask price less than or equal to the number provided.

    @@ -885,9 +1073,9 @@
    Parameters
    - $min_bid_ask_spread - : float|null - = null
    + $max_bid_ask_spread + : float|null + = null

    Limit the option chain to options with a bid-ask spread less than or equal to the number provided.

    @@ -895,9 +1083,9 @@
    Parameters
    - $max_bid_ask_spread_pct - : float|null - = null
    + $max_bid_ask_spread_pct + : float|null + = null

    Limit the option chain to options with a bid-ask spread less than or equal to the percent provided (relative to the @@ -908,9 +1096,9 @@

    Parameters
    - $min_open_interest - : int|null - = null
    + $min_open_interest + : int|null + = null

    Limit the option chain to options with an open interest greater than or equal to the number provided.

    @@ -918,9 +1106,9 @@
    Parameters
    - $min_volume - : int|null - = null
    + $min_volume + : int|null + = null

    Limit the option chain to options with a volume transacted greater than or equal to the number provided.

    @@ -928,9 +1116,33 @@
    Parameters
    - $parameters - : Parameters|null - = null
    + $am + : bool|null + = null +
    +

    Limit the option chain to AM-settled index options. These are +options that settle based on the opening price of the index on +expiration day. Only applicable to index options like SPX. +When true, only AM-settled options are returned.

    +
    + +
    +
    + $pm + : bool|null + = null
    +
    +

    Limit the option chain to PM-settled index options. These are +options that settle based on the closing price of the index on +expiration day. Only applicable to index options like SPX. +When true, only PM-settled options are returned.

    +
    + +
    +
    + $parameters + : Parameters|null + = null

    Universal parameters for all methods (such as format).

    @@ -946,6 +1158,56 @@
    + link +
    +
    +

    API Documentation

    +
    + +
    +
    + see +
    +
    + expirations() + +

    For available expiration dates

    +
    + +
    +
    + see +
    +
    + strikes() + +

    For available strike prices

    +
    + +
    +
    + see +
    +
    + quotes() + +

    For individual option quotes

    +
    + +
    +
    + example +
    +
    + +

    // Get calls for a specific expiration +$chain = $client->options->option_chain('AAPL', expiration: '2025-01-17', side: Side::CALL);

    +

    // Get ATM options with delta filtering +$chain = $client->options->option_chain('SPY', expiration: '2025-01-17', delta: 0.50);

    +
    + +
    +
    throws
    @@ -955,8 +1217,8 @@
    + -
    Return values
    OptionChains @@ -977,37 +1239,43 @@

    -

    Get a current or historical end of day quote for a single options contract.

    +

    Get current or historical end of day quotes for one or more options contracts.

    public - quotes(string $option_symbol[, string|null $date = null ][, string|null $from = null ][, string|null $to = null ][, Parameters|null $parameters = null ]) : Quotes + quotes(string|array<string|int, mixed> $option_symbols[, string|null $date = null ][, string|null $from = null ][, string|null $to = null ][, Parameters|null $parameters = null ]) : Quotes
    +
    APIYes
    +
    - +

    When multiple option symbols are provided, requests are made concurrently using +a sliding window of up to 50 concurrent requests for optimal throughput.

    +
    +

    Parameters
    - $option_symbol - : string + $option_symbols + : string|array<string|int, mixed>
    -

    The option symbol (as defined by the OCC) for the option you wish to -lookup. Use the current OCC option symbol format, even for historic -options that quoted before the format change in 2010.

    +

    The option symbol(s) (as defined by the OCC) for the option(s) you wish +to lookup. Use the current OCC option symbol format, even for historic +options that quoted before the format change in 2010. +Can be a single string or an array of strings for multiple symbols.

    - $date - : string|null - = null
    + $date + : string|null + = null

    Use to lookup a historical end of day quote from a specific trading day. If no date is specified the quote will be the most current price available @@ -1017,37 +1285,35 @@

    Parameters
    - $from - : string|null - = null
    + $from + : string|null + = null

    Use to lookup a series of end of day quotes. From is the oldest (leftmost) date to return (inclusive). If from/to is not specified the quote will be the most current price available during market hours. When the market is closed the quote will be from the last trading day. Accepted timestamp -inputs: ISO -8601, unix, spreadsheet.

    +inputs: ISO 8601, unix, spreadsheet.

    - $to - : string|null - = null
    + $to + : string|null + = null
    -

    Use to lookup a series of end of day quotes. From is the newest -(rightmost) date to return -(exclusive). If from/to is not specified the quote will be the most -current price available during market hours. When the market is closed the -quote will be from the last trading day. Accepted timestamp inputs: ISO -8601, unix, spreadsheet.

    +

    Use to lookup a series of end of day quotes. To is the newest (rightmost) +date to return (exclusive). If from/to is not specified the quote will be +the most current price available during market hours. When the market is +closed the quote will be from the last trading day. Accepted timestamp +inputs: ISO 8601, unix, spreadsheet.

    - $parameters - : Parameters|null - = null
    + $parameters + : Parameters|null + = null

    Universal parameters for all methods (such as format).

    @@ -1063,17 +1329,57 @@
    + link +
    +
    +

    API Documentation

    +
    + +
    +
    + see +
    +
    + option_chain() + +

    For full option chain data

    +
    + +
    +
    + see +
    +
    + lookup() + +

    To convert human-readable descriptions to OCC symbols

    +
    + +
    +
    + example +
    +
    + +

    // Get quote for a single option +$quotes = $client->options->quotes('AAPL250117C00200000');

    +

    // Get quotes for multiple options (concurrent requests) +$quotes = $client->options->quotes(['AAPL250117C00180000', 'AAPL250117C00200000']);

    +
    + +
    +
    throws
    - ApiException|GuzzleException + ApiException|GuzzleException|Throwable
    + -
    Return values
    Quotes @@ -1094,27 +1400,28 @@

    Get a list of current or historical options strikes for an underlying symbol. If no optional parameters are -used, -the endpoint returns the strikes for every expiration in the chain.

    +used, the endpoint returns the strikes for every expiration in the chain.

    public - strikes(string $symbol[, string|null $expiration = null ][, string|null $date = null ][, Parameters|null $parameters = null ]) : Strikes + strikes(string $symbol[, string|null $expiration = null ][, string|null $date = null ][, Parameters|null $parameters = null ]) : Strikes
    +
    APIYes
    +

    Parameters
    - $symbol - : string + $symbol + : string

    The underlying ticker symbol for the options chain you wish to lookup.

    @@ -1122,9 +1429,9 @@
    Parameters
    - $expiration - : string|null - = null
    + $expiration + : string|null + = null

    Limit the lookup of strikes to options that expire on a specific expiration date.

    @@ -1132,9 +1439,9 @@
    Parameters
    - $date - : string|null - = null
    + $date + : string|null + = null

    Use to lookup a historical list of strikes from a specific previous trading day. If date is omitted the expiration dates will be from the current trading @@ -1144,9 +1451,9 @@

    Parameters
    - $parameters - : Parameters|null - = null
    + $parameters + : Parameters|null + = null

    Universal parameters for all methods (such as format).

    @@ -1162,6 +1469,46 @@
    + link +
    +
    +

    API Documentation

    +
    + +
    +
    + see +
    +
    + expirations() + +

    For available expiration dates

    +
    + +
    +
    + see +
    +
    + option_chain() + +

    For full option chain data

    +
    + +
    +
    + example +
    +
    + +

    // Get all strikes for AAPL +$strikes = $client->options->strikes('AAPL');

    +

    // Get strikes for a specific expiration +$strikes = $client->options->strikes('AAPL', expiration: '2025-01-17');

    +
    + +
    +
    throws
    @@ -1171,8 +1518,8 @@
    + -
    Return values
    Strikes @@ -1185,54 +1532,42 @@
    Return values
    -protected " > -

    - execute() - +

    + canParseAsDate() +

    -

    Execute a single API request with universal parameters.

    +

    Check if a string can be parsed as a date.

    protected - execute(string $method, array<string|int, mixed> $arguments, Parameters|null $parameters) : object + canParseAsDate(string|null $value) : bool
    - -
    Parameters
    -
    -
    - $method - : string -
    -
    -

    The API method to call.

    -
    - -
    -
    - $arguments - : array<string|int, mixed> -
    -
    -

    The arguments for the API call.

    +

    Similar to Python SDK's check_is_date() function. +Returns true if the value contains "-" or "/" (indicating parseable date format) +or is numeric (unix timestamp or spreadsheet format).

    +

    This allows relative dates ("today", "yesterday", "-5 days") and option +expiration dates ("December expiration") to pass through without validation.

    -
    +
    Parameters
    +
    - $parameters - : Parameters|null + $value + : string|null
    -

    Optional Parameters object for additional settings.

    +

    The value to check

    @@ -1240,13 +1575,13 @@
    Parameters
    + -
    Return values
    - object + bool — -

    The API response as an object.

    +

    True if the value can be parsed as a date

    @@ -1258,23 +1593,23 @@
    Return values
    -protected " > -

    - execute_in_parallel() - +

    + execute() +

    -

    Execute multiple API requests in parallel with universal parameters.

    +

    Execute a single API request with universal parameters.

    protected - execute_in_parallel(array<string|int, mixed> $calls[, Parameters|null $parameters = null ]) : array<string|int, mixed> + execute(string $method, array<string|int, mixed> $arguments, Parameters|null $parameters) : object
    @@ -1283,20 +1618,103 @@

    Parameters
    - $calls - : array<string|int, mixed> + $method + : string
    -

    An array of method calls, each containing the method name and arguments.

    +

    The API method to call.

    - $parameters - : Parameters|null - = null
    + $arguments + : array<string|int, mixed> +
    -

    Optional Parameters object for additional settings.

    +

    The arguments for the API call.

    +
    + +
    +
    + $parameters + : Parameters|null +
    +
    +

    Optional Parameters object for additional settings.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + object + — +

    The API response as an object.

    +
    + +
    + +

    +
    +

    + execute_in_parallel() + + +

    + + +

    Execute multiple API requests in parallel with universal parameters.

    + + + protected + execute_in_parallel(array<string|int, mixed> $calls[, Parameters|null $parameters = null ][, array<string|int, mixed>|null &$failedRequests = null ]) : array<string|int, mixed> + +
    +
    + + +
    Parameters
    +
    +
    + $calls + : array<string|int, mixed> +
    +
    +

    An array of method calls, each containing the method name and arguments.

    +
    + +
    +
    + $parameters + : Parameters|null + = null
    +
    +

    Optional Parameters object for additional settings.

    +
    + +
    +
    + $failedRequests + : array<string|int, mixed>|null + = null
    +
    +

    Optional by-reference array to collect failed requests instead of throwing. +When provided, exceptions are stored here keyed by their call index.

    @@ -1315,21 +1733,1121 @@
    Throwable - +

    When $failedRequests is not provided and any request fails.

    +
    +
    + -
    Return values
    array<string|int, mixed> — -

    An array of API responses.

    +

    An array of API responses. When $failedRequests is provided, results are keyed by original call index.

    +
    + +
    + +
    +
    +

    + mergeParameters() + + +

    + + +

    Merge method-level parameters with client default parameters.

    + + + protected + mergeParameters(Parameters|null $methodParams) : Parameters + +
    +
    + +

    Priority order (highest to lowest):

    +
      +
    1. Method-level parameters (if provided)
    2. +
    3. Client default parameters ($this->client->default_params)
    4. +
    5. Default Parameters() values
    6. +
    +
    + +
    Parameters
    +
    +
    + $methodParams + : Parameters|null +
    +
    +

    Method-level parameters, or null to use only client defaults.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + Parameters + — +

    Merged parameters instance.

    +
    + +
    + +
    +
    +

    + mergeQuotesResponses() + + +

    + + +

    Merge multiple quotes responses into a single Quotes object.

    + + + protected + mergeQuotesResponses(array<string|int, mixed> $responses[, array<string|int, mixed> $failedRequests = [] ][, array<string|int, mixed> $symbols = [] ]) : Quotes + +
    +
    + + +
    Parameters
    +
    +
    + $responses + : array<string|int, mixed> +
    +
    +

    Array of response objects from execute_in_parallel, keyed by call index.

    +
    + +
    +
    + $failedRequests + : array<string|int, mixed> + = []
    +
    +

    Array of exceptions from failed requests, keyed by call index.

    +
    + +
    +
    + $symbols + : array<string|int, mixed> + = []
    +
    +

    Original symbols array for error reporting.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + Quotes + — +

    Merged quotes response.

    +
    + +
    + +
    +
    +

    + parseDateToTimestamp() + + +

    + + +

    Parse a date string to unix timestamp.

    + + + protected + parseDateToTimestamp(string|null $value) : int|null + +
    +
    + +

    Handles ISO 8601, unix timestamps, spreadsheet dates, and American format.

    +
    + +
    Parameters
    +
    +
    + $value + : string|null +
    +
    +

    The date string to parse

    +
    + +
    +
    + + + + + +
    +
    Return values
    + int|null + — +

    Unix timestamp or null if cannot be parsed

    +
    +
    +

    + quotesMultiple() + + +

    + + +

    Get quotes for multiple option symbols concurrently.

    + + + protected + quotesMultiple(array<string|int, mixed> $option_symbols, string|null $date, string|null $from, string|null $to, Parameters|null $parameters) : Quotes + +
    +
    + +

    Uses a sliding window of up to 50 concurrent requests. As each request completes, +the next one starts immediately for optimal throughput.

    +
    + +
    Parameters
    +
    +
    + $option_symbols + : array<string|int, mixed> +
    +
    +

    Array of option symbols (OCC format).

    +
    + +
    +
    + $date + : string|null +
    +
    +

    Historical date for EOD quotes.

    +
    + +
    +
    + $from + : string|null +
    +
    +

    Start date for series of EOD quotes.

    +
    + +
    +
    + $to + : string|null +
    +
    +

    End date for series of EOD quotes.

    +
    + +
    +
    + $parameters + : Parameters|null +
    +
    +

    Universal parameters.

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + Throwable + + +
    +
    + + + +
    +
    Return values
    + Quotes + — +

    Merged quotes from all symbols.

    +
    + +
    + +
    +
    +

    + quotesMultipleCsv() + + +

    + + +

    Handle CSV format for multiple option symbols.

    + + + protected + quotesMultipleCsv(array<string|int, mixed> $symbols, string|null $date, string|null $from, string|null $to, Parameters|null $parameters, Parameters $mergedParams) : Quotes + +
    +
    + +

    Makes separate requests for each symbol, with headers=true on the first request +(unless user explicitly set add_headers=false) and headers=false on subsequent +requests. Combines all responses into a single CSV output.

    +
    + +
    Parameters
    +
    +
    + $symbols + : array<string|int, mixed> +
    +
    +

    Deduplicated and trimmed option symbols.

    +
    + +
    +
    + $date + : string|null +
    +
    +

    Historical date for EOD quotes.

    +
    + +
    +
    + $from + : string|null +
    +
    +

    Start date for series of EOD quotes.

    +
    + +
    +
    + $to + : string|null +
    +
    +

    End date for series of EOD quotes.

    +
    + +
    +
    + $parameters + : Parameters|null +
    +
    +

    Original parameters from caller.

    +
    + +
    +
    + $mergedParams + : Parameters +
    +
    +

    Merged parameters with defaults applied.

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + Throwable + + +
    +
    + + + +
    +
    Return values
    + Quotes + — +

    Quotes object containing combined CSV.

    +
    + +
    + +
    +
    +

    + validateCountryCode() + + +

    + + +

    Validate ISO 3166 two-letter country code.

    + + + protected + validateCountryCode(string $country) : void + +
    +
    + + +
    Parameters
    +
    +
    + $country + : string +
    +
    +

    The country code to validate

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If country code is invalid

    +
    + +
    +
    + + + + +
    +
    +

    + validateDateRange() + + +

    + + +

    Validate date range logic.

    + + + protected + validateDateRange(string|null $from, string|null $to[, int|null $countback = null ][, string $context = '' ]) : void + +
    +
    + +

    Rules:

    +
      +
    • If to is provided, it requires either from OR countback (but not both)
    • +
    • If both from and to are parseable dates, validates that from < to
    • +
    • If countback is provided, it must be a positive integer
    • +
    +

    This allows relative dates and option expiration dates to pass through without +strict format validation.

    +
    + +
    Parameters
    +
    +
    + $from + : string|null +
    +
    +

    The start date

    +
    + +
    +
    + $to + : string|null +
    +
    +

    The end date

    +
    + +
    +
    + $countback + : int|null + = null
    +
    +

    The countback value

    +
    + +
    +
    + $context + : string + = ''
    +
    +

    Optional context for error messages

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If validation fails

    +
    + +
    +
    + + + + +
    +
    +

    + validateNonEmptyArray() + + +

    + + +

    Validate that an array is non-empty.

    + + + protected + validateNonEmptyArray(array<string|int, mixed> $value, string $fieldName) : void + +
    +
    + + +
    Parameters
    +
    +
    + $value + : array<string|int, mixed> +
    +
    +

    The value to validate

    +
    + +
    +
    + $fieldName + : string +
    +
    +

    The field name for error messages

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If array is empty

    +
    + +
    +
    + + + + +
    +
    +

    + validateNonEmptyString() + + +

    + + +

    Validate that a string is non-empty.

    + + + protected + validateNonEmptyString(string $value, string $fieldName) : void + +
    +
    + + +
    Parameters
    +
    +
    + $value + : string +
    +
    +

    The value to validate

    +
    + +
    +
    + $fieldName + : string +
    +
    +

    The field name for error messages

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If value is empty

    +
    + +
    +
    + + + + +
    +
    +

    + validateNumericRange() + + +

    + + +

    Validate that min < max when both are provided.

    + + + protected + validateNumericRange(float|null $min, float|null $max, string $minField, string $maxField) : void + +
    +
    + + +
    Parameters
    +
    +
    + $min + : float|null +
    +
    +

    The minimum value

    +
    + +
    +
    + $max + : float|null +
    +
    +

    The maximum value

    +
    + +
    +
    + $minField + : string +
    +
    +

    The minimum field name for error messages

    +
    + +
    +
    + $maxField + : string +
    +
    +

    The maximum field name for error messages

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If min >= max

    +
    + +
    +
    + + + + +
    +
    +

    + validatePositiveInteger() + + +

    + + +

    Validate that an integer is positive if provided.

    + + + protected + validatePositiveInteger(int|null $value, string $fieldName) : void + +
    +
    + + +
    Parameters
    +
    +
    + $value + : int|null +
    +
    +

    The value to validate

    +
    + +
    +
    + $fieldName + : string +
    +
    +

    The field name for error messages

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If value is not positive

    +
    + +
    +
    + + + + +
    +
    +

    + validatePositiveNumber() + + +

    + + +

    Validate that a number (int or float) is positive if provided.

    + + + protected + validatePositiveNumber(int|float|null $value, string $fieldName) : void + +
    +
    + + +
    Parameters
    +
    +
    + $value + : int|float|null +
    +
    +

    The value to validate

    +
    + +
    +
    + $fieldName + : string +
    +
    +

    The field name for error messages

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If value is not positive

    +
    + +
    +
    + + + + +
    +
    +

    + validateResolution() + + +

    + + +

    Validate resolution format.

    + + + protected + validateResolution(string $resolution) : void + +
    +
    + +

    Valid resolutions: minutely, hourly, daily, weekly, monthly, yearly, +or numeric with optional suffix (1, 3, 5, 15, 30, 45, H, 1H, 2H, D, 1D, 2D, etc.)

    +
    + +
    Parameters
    +
    +
    + $resolution + : string +
    +
    +

    The resolution to validate

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If resolution is invalid

    +
    + +
    +
    + + + + +
    +
    +

    + validateSymbols() + + +

    + + +

    Validate symbols array (trim and ensure non-empty).

    + + + protected + validateSymbols(array<string|int, mixed> $symbols) : void + +
    +
    + + +
    Parameters
    +
    +
    + $symbols + : array<string|int, mixed> +
    +
    +

    The symbols array to validate

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If symbols array is invalid

    +
    + +
    +
    + + + +
    @@ -1369,6 +2887,8 @@
    Return values
    if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } @@ -1464,8 +2984,23 @@
    Return values
  • option_chain()
  • quotes()
  • strikes()
  • +
  • canParseAsDate()
  • execute()
  • execute_in_parallel()
  • +
  • mergeParameters()
  • +
  • mergeQuotesResponses()
  • +
  • parseDateToTimestamp()
  • +
  • quotesMultiple()
  • +
  • quotesMultipleCsv()
  • +
  • validateCountryCode()
  • +
  • validateDateRange()
  • +
  • validateNonEmptyArray()
  • +
  • validateNonEmptyString()
  • +
  • validateNumericRange()
  • +
  • validatePositiveInteger()
  • +
  • validatePositiveNumber()
  • +
  • validateResolution()
  • +
  • validateSymbols()
  • diff --git a/docs/classes/MarketDataApp-Endpoints-Requests-Parameters.html b/docs/classes/MarketDataApp-Endpoints-Requests-Parameters.html index a3095aca..324109f9 100644 --- a/docs/classes/MarketDataApp-Endpoints-Requests-Parameters.html +++ b/docs/classes/MarketDataApp-Endpoints-Requests-Parameters.html @@ -80,6 +80,14 @@

  • Exceptions +
  • +
  • + Logging + +
  • +
  • + Retry +
  • Traits @@ -129,6 +137,9 @@

    + + implements + Stringable

    @@ -140,20 +151,34 @@

    -

    Represents parameters for API requests.

    - - - - - - +

    Represents universal parameters for API requests.

    + + +

    Supported REST API universal parameters:

    +
      +
    • format: Response format (json, csv, html)
    • +
    • human: Human-readable values
    • +
    • mode: Data feed mode (live, cached, delayed)
    • +
    • maxage: Cache freshness threshold (with mode=cached)
    • +
    • dateformat: Date format for CSV/HTML
    • +
    • columns: Column selection for CSV/HTML
    • +
    • headers: Include headers in CSV/HTML
    • +
    +

    Intentionally unsupported (by design):

    +
      +
    • token: SDK uses Authorization header only
    • +
    • limit/offset: SDK uses concurrent parallel requests instead
    • +
    +
    + +

    Table of Contents @@ -162,6 +187,13 @@

    +

    + Interfaces + + +

    +
    +
    Stringable
    @@ -174,12 +206,55 @@

    +
    + $add_headers + +  : bool|null +
    + +
    + $columns + +  : array<string|int, mixed>|null +
    + +
    + $date_format + +  : DateFormat|null +
    + +
    + $filename + +  : string|null +
    +
    $format  : Format
    +
    + $maxage + +  : int|null +
    +
    Maximum acceptable age for cached data in seconds.
    + +
    + $mode + +  : Mode|null +
    + +
    + $use_human_readable + +  : bool|null +
    +

    @@ -195,6 +270,13 @@

    Parameters constructor.
    +
    + __toString() + +  : string +
    +
    Returns a string representation of the parameters.
    + @@ -213,27 +295,175 @@

    phpdocumentor-element -property -public - " + " +> +

    + $add_headers + + + + +

    + + + + + + public + bool|null + $add_headers + = null + + + + + + + + + +
    +

    + $columns + + + + +

    + + + + + + public + array<string|int, mixed>|null + $columns + = null + + + + + + + + +
    +
    +

    + $date_format + + + + +

    + + + + + + public + DateFormat|null + $date_format + = null + + + + + + + + +
    +
    +

    + $filename + + + + +

    + + + + + + public + string|null + $filename + = null + + + + + + + + +
    + +
    +

    + $maxage + + + + +

    + + +

    Maximum acceptable age for cached data in seconds.

    + + + public + int|null + $maxage + = null + +

    Converted from int, DateInterval, or CarbonInterval input.

    +
    + + + + + + + +
    +
    +

    + $mode + + + + +

    + + + + + + public + Mode|null + $mode + = null + + + + + + + + +
    +
    +

    + $use_human_readable + + + + +

    + + + + + + public + bool|null + $use_human_readable + = null + + + + + + +
    @@ -266,7 +611,7 @@

    @@ -274,7 +619,7 @@

    public - __construct([Format $format = Format::JSON ]) : mixed + __construct([Format $format = Format::JSON ][, bool|null $use_human_readable = null ][, Mode|null $mode = null ][, int|DateInterval|CarbonInterval|null $maxage = null ][, DateFormat|null $date_format = null ][, array<string|int, mixed>|null $columns = null ][, bool|null $add_headers = null ][, string|null $filename = null ]) : mixed
    @@ -283,21 +628,213 @@

    Parameters
    - $format - : Format - = Format::JSON
    + $format + : Format + = Format::JSON

    The format of the response. Defaults to JSON.

    +
    +
    + $use_human_readable + : bool|null + = null
    +
    +

    Whether to use human-readable format for values. Defaults to null.

    +
    + +
    +
    + $mode + : Mode|null + = null
    +
    +

    The data feed mode to use. Defaults to null.

    +
    + +
    +
    + $maxage + : int|DateInterval|CarbonInterval|null + = null
    +
    +

    Maximum acceptable age for cached data when using +mode=CACHED. Accepts seconds as int, DateInterval, or CarbonInterval. +Sets a threshold for data freshness - if no cached data exists within the +specified age window, the API returns a 204 empty response with no credit charge. +Examples: maxage: 300 (5 min), maxage: new DateInterval('PT5M'), +maxage: CarbonInterval::minutes(5). If most recent cache is 180 seconds old +and maxage=300, returns 203 with data (1 credit). If maxage=60, returns 204 +empty response (0 credits). Useful for implementing fallback logic: first try +cached with maxage threshold, then request live data on 204. +Can only be used when mode=CACHED. Defaults to null.

    +
    + +
    +
    + $date_format + : DateFormat|null + = null
    +
    +

    The date format for CSV and HTML responses. Can only be used when format=CSV or format=HTML. Defaults to null.

    +
    + +
    +
    + $columns + : array<string|int, mixed>|null + = null
    +
    +

    The columns to include in CSV and HTML responses. Can only be used when format=CSV or format=HTML. Defaults to null.

    +
    + +
    +
    + $add_headers + : bool|null + = null
    +
    +

    Whether to add headers to CSV and HTML responses. Can only be used when format=CSV or format=HTML. Defaults to null.

    +
    + +
    +
    + $filename + : string|null + = null
    +
    +

    File path for CSV and HTML output. Can only be used when format=CSV or format=HTML. Must end with .csv for CSV format or .html for HTML format. Directory must exist. File must not exist. Defaults to null.

    +
    +
    +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If date_format is set but format is not CSV or HTML.

    +
    + +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If columns is set but format is not CSV or HTML.

    +
    + +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If add_headers is set but format is not CSV or HTML.

    +
    + +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If filename is set but format is not CSV or HTML.

    +
    + +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If columns contains non-string elements.

    +
    + +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If filename has invalid extension, directory doesn't exist, or file already exists.

    +
    + +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If maxage is set but mode is not CACHED.

    +
    + +
    +
    + + + + + +
    +

    + __toString() + + +

    + + +

    Returns a string representation of the parameters.

    + + + public + __toString() : string +
    +
    + + + + +
    +
    Return values
    + string + — +

    Human-readable parameters summary.

    +
    + +
    +
    @@ -337,6 +874,8 @@
    Parameters
    if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } @@ -412,7 +951,14 @@
    Parameters
  • Properties
  • @@ -420,6 +966,7 @@

    Parameters
  • diff --git a/docs/classes/MarketDataApp-Endpoints-Responses-Markets-Status.html b/docs/classes/MarketDataApp-Endpoints-Responses-Markets-Status.html index fcd07481..db784bad 100644 --- a/docs/classes/MarketDataApp-Endpoints-Responses-Markets-Status.html +++ b/docs/classes/MarketDataApp-Endpoints-Responses-Markets-Status.html @@ -80,6 +80,14 @@

  • Exceptions +
  • +
  • + Logging + +
  • +
  • + Retry +
  • Traits @@ -131,6 +139,9 @@

    + + uses + FormatsForDisplay

    @@ -141,7 +152,7 @@

    @@ -151,10 +162,8 @@

    - - - - + +

    Table of Contents @@ -202,6 +211,76 @@

    Constructs a new Status instance.
    +
    + __toString() + +  : string +
    +
    Returns a string representation of the market status.
    + +
    + formatChange() + +  : string +
    +
    Format a change value with sign and currency (e.g., "+$1.25" or "-$0.50").
    + +
    + formatCurrency() + +  : string +
    +
    Format a float as currency (e.g., "$150.25").
    + +
    + formatDate() + +  : string +
    +
    Format a Carbon date without time (e.g., "Jan 24, 2026").
    + +
    + formatDateTime() + +  : string +
    +
    Format a Carbon date with time (e.g., "Jan 24, 2026 3:45 PM").
    + +
    + formatGreek() + +  : string +
    +
    Format a Greek value (4 decimal places, e.g., "0.4520").
    + +
    + formatNumber() + +  : string +
    +
    Format a number with commas (e.g., "15,234").
    + +
    + formatPercent() + +  : string +
    +
    Format a percentage with sign (e.g., "+3.25%" or "-1.50%").
    + +
    + formatPercentRaw() + +  : string +
    +
    Format a percentage that is already in percent form (e.g., "32.50%").
    + +
    + formatVolume() + +  : string +
    +
    Format volume with K/M/B suffixes (e.g., "54.9M", "12.3K").
    + @@ -220,27 +299,27 @@

    phpdocumentor-element -property -public - " + " >

    $date - +

    - public - Carbon + public + Carbon $date @@ -248,7 +327,8 @@

    - + +
    phpdocumentor-element -property -public - " + " >

    $status - +

    - public - string|null + public + string|null $status @@ -284,7 +364,8 @@

    - + +

    @@ -309,7 +390,7 @@

    @@ -317,7 +398,7 @@

    public - __construct(Carbon $date, string|null $status) : mixed + __construct(Carbon $date, string|null $status) : mixed
    @@ -326,8 +407,8 @@

    Parameters
    - $date - : Carbon + $date + : Carbon

    The date for which the market status is reported.

    @@ -335,8 +416,8 @@
    Parameters
    - $status - : string|null + $status + : string|null

    The market status. This will always be 'open' or 'closed' or null. Half days or @@ -349,9 +430,551 @@

    Parameters
    + + + + +
    +

    + __toString() + + +

    + + +

    Returns a string representation of the market status.

    + + + public + __toString() : string + +
    +
    + + + + + + +
    +
    Return values
    + string + — +

    Human-readable market status.

    +
    + +
    + +
    +
    +

    + formatChange() + +

    + + +

    Format a change value with sign and currency (e.g., "+$1.25" or "-$0.50").

    + + + protected + formatChange(float|null $value) : string + +
    +
    + +
    Parameters
    +
    +
    + $value + : float|null +
    +
    +

    The change value to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted change string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatCurrency() + + +

    + + +

    Format a float as currency (e.g., "$150.25").

    + + + protected + formatCurrency(float|null $value) : string + +
    +
    + + +
    Parameters
    +
    +
    + $value + : float|null +
    +
    +

    The value to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted currency string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatDate() + + +

    + + +

    Format a Carbon date without time (e.g., "Jan 24, 2026").

    + + + protected + formatDate(Carbon|null $date) : string + +
    +
    + + +
    Parameters
    +
    +
    + $date + : Carbon|null +
    +
    +

    The date to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted date string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatDateTime() + + +

    + + +

    Format a Carbon date with time (e.g., "Jan 24, 2026 3:45 PM").

    + + + protected + formatDateTime(Carbon|null $date) : string + +
    +
    + + +
    Parameters
    +
    +
    + $date + : Carbon|null +
    +
    +

    The date to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted date string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatGreek() + + +

    + + +

    Format a Greek value (4 decimal places, e.g., "0.4520").

    + + + protected + formatGreek(float|null $value) : string + +
    +
    + + +
    Parameters
    +
    +
    + $value + : float|null +
    +
    +

    The Greek value to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted Greek string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatNumber() + + +

    + + +

    Format a number with commas (e.g., "15,234").

    + + + protected + formatNumber(int|null $value) : string + +
    +
    + + +
    Parameters
    +
    +
    + $value + : int|null +
    +
    +

    The number to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted number string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatPercent() + + +

    + + +

    Format a percentage with sign (e.g., "+3.25%" or "-1.50%").

    + + + protected + formatPercent(float|null $value) : string + +
    +
    + +

    Assumes input is a decimal (0.30 = 30%).

    +
    + +
    Parameters
    +
    +
    + $value + : float|null +
    +
    +

    The decimal value to format as percentage.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted percentage string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatPercentRaw() + + +

    + + +

    Format a percentage that is already in percent form (e.g., "32.50%").

    + + + protected + formatPercentRaw(float|null $value) : string + +
    +
    + +

    Use this for values like implied volatility that are already percentages.

    +
    + +
    Parameters
    +
    +
    + $value + : float|null +
    +
    +

    The percentage value to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted percentage string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatVolume() + + +

    + + +

    Format volume with K/M/B suffixes (e.g., "54.9M", "12.3K").

    + + + protected + formatVolume(int|null $value) : string + +
    +
    + + +
    Parameters
    +
    +
    + $value + : int|null +
    +
    +

    The volume to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted volume string or "N/A" if null.

    +
    + +
    +
    @@ -391,6 +1014,8 @@
    Parameters
    if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } @@ -475,6 +1100,16 @@
    Parameters
  • diff --git a/docs/classes/MarketDataApp-Endpoints-Responses-Markets-Statuses.html b/docs/classes/MarketDataApp-Endpoints-Responses-Markets-Statuses.html index 3d41af2e..3afddada 100644 --- a/docs/classes/MarketDataApp-Endpoints-Responses-Markets-Statuses.html +++ b/docs/classes/MarketDataApp-Endpoints-Responses-Markets-Statuses.html @@ -80,6 +80,14 @@

  • Exceptions +
  • +
  • + Logging + +
  • +
  • + Retry +
  • Traits @@ -154,10 +162,8 @@

    - - - - + +

    Table of Contents @@ -178,6 +184,12 @@

    +
    + $_saved_filename + +  : string|null +
    +
    $status @@ -219,6 +231,13 @@

    Constructs a new Statuses instance from the given response object.
    +
    + __toString() + +  : string +
    +
    Returns a string representation of the market statuses collection.
    +
    getCsv() @@ -254,6 +273,13 @@

    Check if the response is in JSON format.
    +
    + saveToFile() + +  : string +
    +
    Save CSV/HTML content to a file.
    +
    @@ -272,14 +298,53 @@

    phpdocumentor-element -property -public - " + " +> +

    + $_saved_filename + + + + +

    + + + + + + public + string|null + $_saved_filename + = null + + +

    The filename where the response was saved (if filename parameter was used).

    +
    + + + + + + + +

    $status - +

    phpdocumentor-element -property -public - " + " >

    $statuses - +

    phpdocumentor-element -property -protected - " + " >

    $csv - +

    phpdocumentor-element -property -protected - " + " >

    $html - +

    @@ -447,7 +516,7 @@

    public - __construct(object $response) : mixed + __construct(object $response) : mixed
    @@ -456,8 +525,8 @@

    Parameters
    - $response - : object + $response + : object

    The response object containing market status data.

    @@ -468,9 +537,52 @@
    Parameters
    + + + + +
    +

    + __toString() + + +

    + + +

    Returns a string representation of the market statuses collection.

    + + + public + __toString() : string + +
    +
    + + + + +
    +
    Return values
    + string + — +

    Human-readable market statuses summary.

    +
    + +
    +
    @@ -502,9 +614,26 @@

    +

    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If the response is not in CSV format.

    +
    - +
    +
    + +
    Return values
    string @@ -529,7 +658,7 @@

    @@ -545,9 +674,26 @@

    +

    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If the response is not in HTML format.

    +
    - +
    +
    + +
    Return values
    string @@ -572,7 +718,7 @@

    @@ -589,8 +735,8 @@

    + -
    Return values
    bool @@ -615,7 +761,7 @@

    @@ -632,8 +778,8 @@

    + -
    Return values
    bool @@ -658,7 +804,7 @@

    @@ -675,8 +821,8 @@

    + -
    Return values
    bool @@ -686,6 +832,88 @@
    Return values
    +

    +
    +

    + saveToFile() + + +

    + + +

    Save CSV/HTML content to a file.

    + + + public + saveToFile(string $filename) : string + +
    +
    + + +
    Parameters
    +
    +
    + $filename + : string +
    +
    +

    The file path to save to.

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If filename is invalid (wrong extension, etc.).

    +
    + +
    +
    + throws +
    +
    + RuntimeException + +

    If file writing fails.

    +
    + +
    +
    + + + +
    +
    Return values
    + string + — +

    The absolute path of the saved file.

    +
    + +
    +
    @@ -725,6 +953,8 @@
    Return values
    if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } @@ -800,6 +1030,7 @@
    Return values
  • Properties
  • diff --git a/docs/classes/MarketDataApp-Endpoints-Responses-MutualFunds-Candle.html b/docs/classes/MarketDataApp-Endpoints-Responses-MutualFunds-Candle.html index a0833350..f4dd50df 100644 --- a/docs/classes/MarketDataApp-Endpoints-Responses-MutualFunds-Candle.html +++ b/docs/classes/MarketDataApp-Endpoints-Responses-MutualFunds-Candle.html @@ -80,6 +80,14 @@

  • Exceptions +
  • +
  • + Logging + +
  • +
  • + Retry +
  • Traits @@ -131,6 +139,9 @@

  • + + uses + FormatsForDisplay
  • @@ -141,7 +152,7 @@

    @@ -151,10 +162,8 @@

    - - - - + +

    Table of Contents @@ -220,6 +229,76 @@

    Constructs a new Candle instance.
    +
    + __toString() + +  : string +
    +
    Returns a string representation of the mutual fund candle.
    + +
    + formatChange() + +  : string +
    +
    Format a change value with sign and currency (e.g., "+$1.25" or "-$0.50").
    + +
    + formatCurrency() + +  : string +
    +
    Format a float as currency (e.g., "$150.25").
    + +
    + formatDate() + +  : string +
    +
    Format a Carbon date without time (e.g., "Jan 24, 2026").
    + +
    + formatDateTime() + +  : string +
    +
    Format a Carbon date with time (e.g., "Jan 24, 2026 3:45 PM").
    + +
    + formatGreek() + +  : string +
    +
    Format a Greek value (4 decimal places, e.g., "0.4520").
    + +
    + formatNumber() + +  : string +
    +
    Format a number with commas (e.g., "15,234").
    + +
    + formatPercent() + +  : string +
    +
    Format a percentage with sign (e.g., "+3.25%" or "-1.50%").
    + +
    + formatPercentRaw() + +  : string +
    +
    Format a percentage that is already in percent form (e.g., "32.50%").
    + +
    + formatVolume() + +  : string +
    +
    Format volume with K/M/B suffixes (e.g., "54.9M", "12.3K").
    + @@ -238,27 +317,27 @@

    phpdocumentor-element -property -public - " + " >

    $close - +

    - public - float + public + float $close @@ -266,7 +345,8 @@

    - + +
    phpdocumentor-element -property -public - " + " >

    $high - +

    - public - float + public + float $high @@ -302,7 +382,8 @@

    - + +

    phpdocumentor-element -property -public - " + " >

    $low - +

    - public - float + public + float $low @@ -338,7 +419,8 @@

    - + +

    phpdocumentor-element -property -public - " + " >

    $open - +

    - public - float + public + float $open @@ -374,7 +456,8 @@

    - + +

    phpdocumentor-element -property -public - " + " >

    $timestamp - +

    - public - Carbon + public + Carbon $timestamp @@ -410,7 +493,8 @@

    - + +

    @@ -435,7 +519,7 @@

    @@ -443,7 +527,7 @@

    public - __construct(float $open, float $high, float $low, float $close, Carbon $timestamp) : mixed + __construct(float $open, float $high, float $low, float $close, Carbon $timestamp) : mixed
    @@ -452,8 +536,8 @@

    Parameters
    - $open - : float + $open + : float

    Open price of the candle.

    @@ -461,8 +545,8 @@
    Parameters
    - $high - : float + $high + : float

    High price of the candle.

    @@ -470,8 +554,8 @@
    Parameters
    - $low - : float + $low + : float

    Low price of the candle.

    @@ -479,8 +563,8 @@
    Parameters
    - $close - : float + $close + : float

    Close price of the candle.

    @@ -488,8 +572,8 @@
    Parameters
    - $timestamp - : Carbon + $timestamp + : Carbon

    Candle time (Unix timestamp, UTC). Daily, weekly, monthly, yearly candles are returned @@ -501,9 +585,551 @@

    Parameters
    + + + + +
    +

    + __toString() + + +

    + + +

    Returns a string representation of the mutual fund candle.

    + + + public + __toString() : string + +
    +
    + + + + + + + +
    +
    Return values
    + string + — +

    Human-readable candle data.

    +
    + +
    + +
    +
    +

    + formatChange() + + +

    + + +

    Format a change value with sign and currency (e.g., "+$1.25" or "-$0.50").

    + + + protected + formatChange(float|null $value) : string + +
    +
    + + +
    Parameters
    +
    +
    + $value + : float|null +
    +
    +

    The change value to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted change string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatCurrency() + + +

    + + +

    Format a float as currency (e.g., "$150.25").

    + + + protected + formatCurrency(float|null $value) : string + +
    +
    + + +
    Parameters
    +
    +
    + $value + : float|null +
    +
    +

    The value to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted currency string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatDate() + + +

    + + +

    Format a Carbon date without time (e.g., "Jan 24, 2026").

    + + + protected + formatDate(Carbon|null $date) : string + +
    +
    + + +
    Parameters
    +
    +
    + $date + : Carbon|null +
    +
    +

    The date to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted date string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatDateTime() + + +

    + + +

    Format a Carbon date with time (e.g., "Jan 24, 2026 3:45 PM").

    + + + protected + formatDateTime(Carbon|null $date) : string + +
    +
    + + +
    Parameters
    +
    +
    + $date + : Carbon|null +
    +
    +

    The date to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted date string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatGreek() + + +

    + + +

    Format a Greek value (4 decimal places, e.g., "0.4520").

    + + + protected + formatGreek(float|null $value) : string + +
    +
    + + +
    Parameters
    +
    +
    + $value + : float|null +
    +
    +

    The Greek value to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted Greek string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatNumber() + + +

    + + +

    Format a number with commas (e.g., "15,234").

    + + + protected + formatNumber(int|null $value) : string + +
    +
    + + +
    Parameters
    +
    +
    + $value + : int|null +
    +
    +

    The number to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted number string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatPercent() + + +

    + + +

    Format a percentage with sign (e.g., "+3.25%" or "-1.50%").

    + + + protected + formatPercent(float|null $value) : string + +
    +
    + +

    Assumes input is a decimal (0.30 = 30%).

    +
    + +
    Parameters
    +
    +
    + $value + : float|null +
    +
    +

    The decimal value to format as percentage.

    +
    + +
    +
    + + + + +
    +
    Return values
    + string + — +

    Formatted percentage string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatPercentRaw() + + +

    + +

    Format a percentage that is already in percent form (e.g., "32.50%").

    + + + protected + formatPercentRaw(float|null $value) : string + +
    +
    +

    Use this for values like implied volatility that are already percentages.

    +
    + +
    Parameters
    +
    +
    + $value + : float|null +
    +
    +

    The percentage value to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted percentage string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatVolume() + + +

    + + +

    Format volume with K/M/B suffixes (e.g., "54.9M", "12.3K").

    + + + protected + formatVolume(int|null $value) : string + +
    +
    + + +
    Parameters
    +
    +
    + $value + : int|null +
    +
    +

    The volume to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted volume string or "N/A" if null.

    +
    + +
    +
    @@ -543,6 +1169,8 @@
    Parameters
    if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } @@ -630,6 +1258,16 @@
    Parameters
  • diff --git a/docs/classes/MarketDataApp-Endpoints-Responses-MutualFunds-Candles.html b/docs/classes/MarketDataApp-Endpoints-Responses-MutualFunds-Candles.html index 97df9b50..93adb266 100644 --- a/docs/classes/MarketDataApp-Endpoints-Responses-MutualFunds-Candles.html +++ b/docs/classes/MarketDataApp-Endpoints-Responses-MutualFunds-Candles.html @@ -80,6 +80,14 @@

  • Exceptions +
  • +
  • + Logging + +
  • +
  • + Retry +
  • Traits @@ -154,10 +162,8 @@

    - - - - + +

    Table of Contents @@ -178,6 +184,12 @@

    +
    + $_saved_filename + +  : string|null +
    +
    $candles @@ -188,7 +200,7 @@

    $next_time -  : int +  : int|null
    Unix time of the next quote if there is no data in the requested period, but there is data in a subsequent period.
    @@ -227,6 +239,13 @@

    Constructs a new Candles instance from the given response object.
    +
    + __toString() + +  : string +
    +
    Returns a string representation of the mutual funds candles collection.
    +
    getCsv() @@ -262,6 +281,13 @@

    Check if the response is in JSON format.
    +
    + saveToFile() + +  : string +
    +
    Save CSV/HTML content to a file.
    +
    @@ -280,14 +306,53 @@

    phpdocumentor-element -property -public - " + " +> +

    + $_saved_filename + + + + +

    + + + + + + public + string|null + $_saved_filename + = null + + +

    The filename where the response was saved (if filename parameter was used).

    +
    + + + + + + + +

    $candles - +

    phpdocumentor-element -property -public - " + " >

    $next_time - +

    phpdocumentor-element -property -public - " + " >

    $status - +

    phpdocumentor-element -property -protected - " + " >

    $csv - +

    phpdocumentor-element -property -protected - " + " >

    $html - +

    @@ -493,7 +563,7 @@

    public - __construct(object $response) : mixed + __construct(object $response) : mixed
    @@ -502,8 +572,8 @@

    Parameters
    - $response - : object + $response + : object

    The response object containing candle data.

    @@ -514,9 +584,52 @@
    Parameters
    + + + + +
    +

    + __toString() + + +

    + + +

    Returns a string representation of the mutual funds candles collection.

    + + + public + __toString() : string + +
    +
    + + + + +
    +
    Return values
    + string + — +

    Human-readable candles summary.

    +
    + +
    +
    @@ -548,9 +661,26 @@

    +

    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If the response is not in CSV format.

    +
    - +
    +
    + +
    Return values
    string @@ -575,7 +705,7 @@

    @@ -591,9 +721,26 @@

    +

    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If the response is not in HTML format.

    +
    - +
    +
    + +
    Return values
    string @@ -618,7 +765,7 @@

    @@ -635,8 +782,8 @@

    + -
    Return values
    bool @@ -661,7 +808,7 @@

    @@ -678,8 +825,8 @@

    + -
    Return values
    bool @@ -704,7 +851,7 @@

    @@ -721,8 +868,8 @@

    + -
    Return values
    bool @@ -732,6 +879,88 @@
    Return values
    +

    +
    +

    + saveToFile() + + +

    + + +

    Save CSV/HTML content to a file.

    + + + public + saveToFile(string $filename) : string + +
    +
    + + +
    Parameters
    +
    +
    + $filename + : string +
    +
    +

    The file path to save to.

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If filename is invalid (wrong extension, etc.).

    +
    + +
    +
    + throws +
    +
    + RuntimeException + +

    If file writing fails.

    +
    + +
    +
    + + + +
    +
    Return values
    + string + — +

    The absolute path of the saved file.

    +
    + +
    +
    @@ -771,6 +1000,8 @@
    Return values
    if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } @@ -846,6 +1077,7 @@
    Return values
  • Properties
  • diff --git a/docs/classes/MarketDataApp-Endpoints-Responses-Options-Expirations.html b/docs/classes/MarketDataApp-Endpoints-Responses-Options-Expirations.html index 526b788c..6ef58c2b 100644 --- a/docs/classes/MarketDataApp-Endpoints-Responses-Options-Expirations.html +++ b/docs/classes/MarketDataApp-Endpoints-Responses-Options-Expirations.html @@ -80,6 +80,14 @@

  • Exceptions +
  • +
  • + Logging + +
  • +
  • + Retry +
  • Traits @@ -134,6 +142,9 @@

  • + + uses + FormatsForDisplay
    @@ -144,7 +155,7 @@

    @@ -154,10 +165,8 @@

    - - - - + +

    Table of Contents @@ -178,6 +187,12 @@

    +
    + $_saved_filename + +  : string|null +
    +
    $expirations @@ -188,14 +203,14 @@

    $next_time -  : Carbon +  : Carbon|null
    Time of the next quote if there is no data in the requested period, but there is data in a subsequent period.
    $prev_time -  : Carbon +  : Carbon|null
    Time of the previous quote if there is no data in the requested period, but there is data in a previous period.
    @@ -210,7 +225,7 @@

    $updated -  : Carbon +  : Carbon|null
    The date and time this list of options strikes was updated in Unix time.
    @@ -241,6 +256,13 @@

    Constructs a new Expirations instance from the given response object.
    +
    + __toString() + +  : string +
    +
    Returns a string representation of the expirations collection.
    +
    getCsv() @@ -276,6 +298,76 @@

    Check if the response is in JSON format.
    +
    + saveToFile() + +  : string +
    +
    Save CSV/HTML content to a file.
    + +
    + formatChange() + +  : string +
    +
    Format a change value with sign and currency (e.g., "+$1.25" or "-$0.50").
    + +
    + formatCurrency() + +  : string +
    +
    Format a float as currency (e.g., "$150.25").
    + +
    + formatDate() + +  : string +
    +
    Format a Carbon date without time (e.g., "Jan 24, 2026").
    + +
    + formatDateTime() + +  : string +
    +
    Format a Carbon date with time (e.g., "Jan 24, 2026 3:45 PM").
    + +
    + formatGreek() + +  : string +
    +
    Format a Greek value (4 decimal places, e.g., "0.4520").
    + +
    + formatNumber() + +  : string +
    +
    Format a number with commas (e.g., "15,234").
    + +
    + formatPercent() + +  : string +
    +
    Format a percentage with sign (e.g., "+3.25%" or "-1.50%").
    + +
    + formatPercentRaw() + +  : string +
    +
    Format a percentage that is already in percent form (e.g., "32.50%").
    + +
    + formatVolume() + +  : string +
    +
    Format volume with K/M/B suffixes (e.g., "54.9M", "12.3K").
    +
    @@ -294,19 +386,58 @@

    phpdocumentor-element -property -public - " + " +> +

    + $_saved_filename + + + + +

    + + + + + + public + string|null + $_saved_filename + = null + + +

    The filename where the response was saved (if filename parameter was used).

    +
    + + + + + + + +

    $expirations - +

    @@ -314,8 +445,8 @@

    - public - array<string|int, Carbon> + public + array<string|int, Carbon> $expirations = [] @@ -323,7 +454,8 @@

    - + +

    phpdocumentor-element -property -public - " + " >

    $next_time - +

    @@ -351,16 +483,17 @@

    - public - Carbon + public + Carbon|null $next_time - + = null - + +

    phpdocumentor-element -property -public - " + " >

    $prev_time - +

    @@ -388,16 +521,17 @@

    - public - Carbon + public + Carbon|null $prev_time - + = null - + +

    phpdocumentor-element -property -public - " + " >

    $status - +

    @@ -426,16 +560,17 @@

    - public - string + public + string $status - + = 'no_data' - + +

    phpdocumentor-element -property -public - " + " >

    $updated - +

    @@ -463,10 +598,10 @@

    - public - Carbon + public + Carbon|null $updated - + = null

    For historical strikes, this number should match the date parameter.

    @@ -474,7 +609,8 @@

    - + +

    phpdocumentor-element -property -protected - " + " >

    $csv - +

    phpdocumentor-element -property -protected - " + " >

    $html - +

    @@ -575,7 +713,7 @@

    @@ -583,7 +721,7 @@

    public - __construct(object $response) : mixed + __construct(object $response) : mixed
    @@ -592,8 +730,8 @@

    Parameters
    - $response - : object + $response + : object

    The response object containing expirations data.

    @@ -604,9 +742,52 @@
    Parameters
    + + + + +
    +

    + __toString() + + +

    + + +

    Returns a string representation of the expirations collection.

    + + + public + __toString() : string + +
    +
    + + + + +
    +
    Return values
    + string + — +

    Human-readable expirations summary.

    +
    + +
    +
    @@ -638,9 +819,26 @@

    +

    + Tags + - +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If the response is not in CSV format.

    +
    + +
    +
    + +
    Return values
    string @@ -665,7 +863,7 @@

    @@ -681,9 +879,26 @@

    +

    + Tags + - +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If the response is not in HTML format.

    +
    +
    +
    + + +
    Return values
    string @@ -708,7 +923,7 @@

    @@ -725,8 +940,8 @@

    + -
    Return values
    bool @@ -751,7 +966,7 @@

    @@ -768,8 +983,8 @@

    + -
    Return values
    bool @@ -794,7 +1009,7 @@

    @@ -811,8 +1026,8 @@

    + -
    Return values
    bool @@ -822,6 +1037,587 @@
    Return values
    +

    +
    +

    + saveToFile() + + +

    + + +

    Save CSV/HTML content to a file.

    + + + public + saveToFile(string $filename) : string + +
    +
    + + +
    Parameters
    +
    +
    + $filename + : string +
    +
    +

    The file path to save to.

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If filename is invalid (wrong extension, etc.).

    +
    + +
    +
    + throws +
    +
    + RuntimeException + +

    If file writing fails.

    +
    + +
    +
    + + + +
    +
    Return values
    + string + — +

    The absolute path of the saved file.

    +
    + +
    + +
    +
    +

    + formatChange() + + +

    + + +

    Format a change value with sign and currency (e.g., "+$1.25" or "-$0.50").

    + + + protected + formatChange(float|null $value) : string + +
    +
    + + +
    Parameters
    +
    +
    + $value + : float|null +
    +
    +

    The change value to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted change string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatCurrency() + + +

    + + +

    Format a float as currency (e.g., "$150.25").

    + + + protected + formatCurrency(float|null $value) : string + +
    +
    + + +
    Parameters
    +
    +
    + $value + : float|null +
    +
    +

    The value to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted currency string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatDate() + + +

    + + +

    Format a Carbon date without time (e.g., "Jan 24, 2026").

    + + + protected + formatDate(Carbon|null $date) : string + +
    +
    + + +
    Parameters
    +
    +
    + $date + : Carbon|null +
    +
    +

    The date to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted date string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatDateTime() + + +

    + + +

    Format a Carbon date with time (e.g., "Jan 24, 2026 3:45 PM").

    + + + protected + formatDateTime(Carbon|null $date) : string + +
    +
    + + +
    Parameters
    +
    +
    + $date + : Carbon|null +
    +
    +

    The date to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted date string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatGreek() + + +

    + + +

    Format a Greek value (4 decimal places, e.g., "0.4520").

    + + + protected + formatGreek(float|null $value) : string + +
    +
    + + +
    Parameters
    +
    +
    + $value + : float|null +
    +
    +

    The Greek value to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted Greek string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatNumber() + + +

    + + +

    Format a number with commas (e.g., "15,234").

    + + + protected + formatNumber(int|null $value) : string + +
    +
    + + +
    Parameters
    +
    +
    + $value + : int|null +
    +
    +

    The number to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted number string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatPercent() + + +

    + + +

    Format a percentage with sign (e.g., "+3.25%" or "-1.50%").

    + + + protected + formatPercent(float|null $value) : string + +
    +
    + +

    Assumes input is a decimal (0.30 = 30%).

    +
    + +
    Parameters
    +
    +
    + $value + : float|null +
    +
    +

    The decimal value to format as percentage.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted percentage string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatPercentRaw() + + +

    + + +

    Format a percentage that is already in percent form (e.g., "32.50%").

    + + + protected + formatPercentRaw(float|null $value) : string + +
    +
    + +

    Use this for values like implied volatility that are already percentages.

    +
    + +
    Parameters
    +
    +
    + $value + : float|null +
    +
    +

    The percentage value to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted percentage string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatVolume() + + +

    + + +

    Format volume with K/M/B suffixes (e.g., "54.9M", "12.3K").

    + + + protected + formatVolume(int|null $value) : string + +
    +
    + + +
    Parameters
    +
    +
    + $value + : int|null +
    +
    +

    The volume to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted volume string or "N/A" if null.

    +
    + +
    +
    @@ -861,6 +1657,8 @@
    Return values
    if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } @@ -936,6 +1734,7 @@
    Return values
  • Properties
  • diff --git a/docs/classes/MarketDataApp-Endpoints-Responses-Options-Lookup.html b/docs/classes/MarketDataApp-Endpoints-Responses-Options-Lookup.html index 4ad6d5b3..12b76e90 100644 --- a/docs/classes/MarketDataApp-Endpoints-Responses-Options-Lookup.html +++ b/docs/classes/MarketDataApp-Endpoints-Responses-Options-Lookup.html @@ -80,6 +80,14 @@

  • Exceptions +
  • +
  • + Logging + +
  • +
  • + Retry +
  • Traits @@ -154,10 +162,8 @@

    - - - - + +

    Table of Contents @@ -178,10 +184,16 @@

    +
    + $_saved_filename + +  : string|null +
    +
    $option_symbol -  : string +  : string|null
    The generated OCC option symbol based on the user's input.
    @@ -219,6 +231,13 @@

    Constructs a new Lookup instance from the given response object.
    +
    + __toString() + +  : string +
    +
    Returns a string representation of the lookup result.
    +
    getCsv() @@ -254,6 +273,13 @@

    Check if the response is in JSON format.
    +
    + saveToFile() + +  : string +
    +
    Save CSV/HTML content to a file.
    +

    @@ -272,14 +298,53 @@

    phpdocumentor-element -property -public - " + " +> +

    + $_saved_filename + + + + +

    + + + + + + public + string|null + $_saved_filename + = null + + +

    The filename where the response was saved (if filename parameter was used).

    +
    + + + + + + + +

    $option_symbol - +

    phpdocumentor-element -property -public - " + " >

    $status - +

    phpdocumentor-element -property -protected - " + " >

    $csv - +

    phpdocumentor-element -property -protected - " + " >

    $html - +

    @@ -447,7 +516,7 @@

    public - __construct(object $response) : mixed + __construct(object $response) : mixed
    @@ -456,8 +525,8 @@

    Parameters
    - $response - : object + $response + : object

    The response object containing lookup data.

    @@ -468,9 +537,52 @@
    Parameters
    + + + + +
    +

    + __toString() + + +

    + + +

    Returns a string representation of the lookup result.

    + + + public + __toString() : string + +
    +
    + + + + +
    +
    Return values
    + string + — +

    Human-readable lookup result.

    +
    + +
    +
    @@ -502,9 +614,26 @@

    +

    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If the response is not in CSV format.

    +
    - +
    +
    + +
    Return values
    string @@ -529,7 +658,7 @@

    @@ -545,9 +674,26 @@

    +

    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If the response is not in HTML format.

    +
    - +
    +
    + +
    Return values
    string @@ -572,7 +718,7 @@

    @@ -589,8 +735,8 @@

    + -
    Return values
    bool @@ -615,7 +761,7 @@

    @@ -632,8 +778,8 @@

    + -
    Return values
    bool @@ -658,7 +804,7 @@

    @@ -675,8 +821,8 @@

    + -
    Return values
    bool @@ -686,6 +832,88 @@
    Return values
    +

    +
    +

    + saveToFile() + + +

    + + +

    Save CSV/HTML content to a file.

    + + + public + saveToFile(string $filename) : string + +
    +
    + + +
    Parameters
    +
    +
    + $filename + : string +
    +
    +

    The file path to save to.

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If filename is invalid (wrong extension, etc.).

    +
    + +
    +
    + throws +
    +
    + RuntimeException + +

    If file writing fails.

    +
    + +
    +
    + + + +
    +
    Return values
    + string + — +

    The absolute path of the saved file.

    +
    + +
    +
    @@ -725,6 +953,8 @@
    Return values
    if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } @@ -800,6 +1030,7 @@
    Return values
  • Properties
  • diff --git a/docs/classes/MarketDataApp-Endpoints-Responses-Options-OptionChains.html b/docs/classes/MarketDataApp-Endpoints-Responses-Options-OptionChains.html index f7d44981..c9ba509c 100644 --- a/docs/classes/MarketDataApp-Endpoints-Responses-Options-OptionChains.html +++ b/docs/classes/MarketDataApp-Endpoints-Responses-Options-OptionChains.html @@ -80,6 +80,14 @@

  • Exceptions +
  • +
  • + Logging + +
  • +
  • + Retry +
  • Traits @@ -154,10 +162,8 @@

    - - - - + +

    Table of Contents @@ -178,24 +184,30 @@

    +
    + $_saved_filename + +  : string|null +
    +
    $next_time -  : Carbon +  : Carbon|null
    Time of the next quote if there is no data in the requested period, but there is data in a subsequent period.
    $option_chains -  : array<string, array<string|int, OptionChainStrike>> +  : array<string, array<string|int, OptionQuote>>
    -
    Multidimensional array of OptionChainStrike objects organized by date.
    +
    Multidimensional array of OptionQuote objects organized by date.
    $prev_time -  : Carbon +  : Carbon|null
    Time of the previous quote if there is no data in the requested period, but there is data in a previous period.
    @@ -233,6 +245,41 @@

    Constructs a new OptionChains instance from the given response object.
    +
    + __toString() + +  : string +
    +
    Returns a string representation of the option chains collection.
    + +
    + count() + +  : int +
    +
    Get the total count of option quotes across all expirations.
    + +
    + getAllQuotes() + +  : array<string|int, OptionQuote> +
    +
    Get all option quotes as a flat array.
    + +
    + getByStrike() + +  : array<string|int, OptionQuote> +
    +
    Get option quotes for a specific strike price.
    + +
    + getCalls() + +  : array<string|int, OptionQuote> +
    +
    Get only call options from the chain.
    +
    getCsv() @@ -240,6 +287,13 @@

    Get the CSV content of the response.
    +
    + getExpirationDates() + +  : array<string|int, string> +
    +
    Get all expiration dates in the chain.
    +
    getHtml() @@ -247,6 +301,27 @@

    Get the HTML content of the response.
    +
    + getPuts() + +  : array<string|int, OptionQuote> +
    +
    Get only put options from the chain.
    + +
    + getQuotesByExpiration() + +  : array<string|int, OptionQuote> +
    +
    Get option quotes for a specific expiration date.
    + +
    + getStrikes() + +  : array<string|int, float> +
    +
    Get all unique strike prices in the chain, sorted ascending.
    +
    isCsv() @@ -268,6 +343,20 @@

    Check if the response is in JSON format.
    +
    + saveToFile() + +  : string +
    +
    Save CSV/HTML content to a file.
    + +
    + toQuotes() + +  : Quotes +
    +
    Convert the option chains to a flat Quotes object.
    +

    @@ -286,14 +375,53 @@

    phpdocumentor-element -property -public - " + " +> +

    + $_saved_filename + + + + +

    + + + + + + public + string|null + $_saved_filename + = null + + +

    The filename where the response was saved (if filename parameter was used).

    +
    + + + + + + + +

    $next_time - +

    phpdocumentor-element -property -public - " + " >

    $option_chains - +

    -

    Multidimensional array of OptionChainStrike objects organized by date.

    +

    Multidimensional array of OptionQuote objects organized by date.

    - public - array<string, array<string|int, OptionChainStrike>> + public + array<string, array<string|int, OptionQuote>> $option_chains = [] @@ -352,7 +481,8 @@

    - + +

    phpdocumentor-element -property -public - " + " >

    $prev_time - +

    phpdocumentor-element -property -public - " + " >

    $status - +

    phpdocumentor-element -property -protected - " + " >

    $csv - +

    phpdocumentor-element -property -protected - " + " >

    $html - +

    @@ -535,7 +669,7 @@

    public - __construct(object $response) : mixed + __construct(object $response) : mixed
    @@ -544,8 +678,8 @@

    Parameters
    - $response - : object + $response + : object

    The response object containing option chains data.

    @@ -556,8 +690,8 @@
    Parameters
    + -
    Parameters
  • -public " > -

    - getCsv() - +

    + __toString() +

    -

    Get the CSV content of the response.

    +

    Returns a string representation of the option chains collection.

    public - getCsv() : string + __toString() : string
    @@ -591,13 +725,13 @@

    + -
    Return values
    string — -

    The CSV content.

    +

    Human-readable option chains summary.

    @@ -609,23 +743,23 @@
    Return values
    -public " > -

    - getHtml() - +

    + count() +

    -

    Get the HTML content of the response.

    +

    Get the total count of option quotes across all expirations.

    public - getHtml() : string + count() : int
    @@ -634,13 +768,13 @@

    + -
    Return values
    - string + int — -

    The HTML content.

    +

    The total number of option quotes.

    @@ -652,23 +786,23 @@
    Return values
    -public " > -

    - isCsv() - +

    + getAllQuotes() +

    -

    Check if the response is in CSV format.

    +

    Get all option quotes as a flat array.

    public - isCsv() : bool + getAllQuotes() : array<string|int, OptionQuote>
    @@ -677,13 +811,13 @@

    + -
    Return values
    - bool + array<string|int, OptionQuote> — -

    True if the response is in CSV format, false otherwise.

    +

    All option quotes from all expiration dates.

    @@ -695,38 +829,93 @@
    Return values
    -public " > -

    - isHtml() - +

    + getByStrike() +

    -

    Check if the response is in HTML format.

    +

    Get option quotes for a specific strike price.

    public - isHtml() : bool + getByStrike(float $strike) : array<string|int, OptionQuote>
    +
    Parameters
    +
    +
    + $strike + : float +
    +
    +

    The strike price to filter by.

    +
    + +
    +
    + + + +
    +
    Return values
    + array<string|int, OptionQuote> + — +

    Array of option quotes with the given strike price.

    +
    + +
    + + +
    +

    + getCalls() + + +

    + + +

    Get only call options from the chain.

    + + + public + getCalls() : array<string|int, OptionQuote> +
    +
    + + + + +
    Return values
    - bool + array<string|int, OptionQuote> — -

    True if the response is in HTML format, false otherwise.

    +

    Array of call option quotes.

    @@ -738,23 +927,23 @@
    Return values
    -public " > -

    - isJson() - +

    + getCsv() +

    -

    Check if the response is in JSON format.

    +

    Get the CSV content of the response.

    public - isJson() : bool + getCsv() : string
    @@ -762,14 +951,533 @@

    +

    + Tags + - +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If the response is not in CSV format.

    +
    + +
    +
    + +
    Return values
    - bool + string — -

    True if the response is in JSON format, false otherwise.

    +

    The CSV content.

    +
    + +
    + +
    +
    +

    + getExpirationDates() + + +

    + + +

    Get all expiration dates in the chain.

    + + + public + getExpirationDates() : array<string|int, string> + +
    +
    + + + + + + + +
    +
    Return values
    + array<string|int, string> + — +

    Array of expiration date strings (YYYY-MM-DD format).

    +
    + +
    + +
    +
    +

    + getHtml() + + +

    + + +

    Get the HTML content of the response.

    + + + public + getHtml() : string + +
    +
    + + + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If the response is not in HTML format.

    +
    + +
    +
    + + + +
    +
    Return values
    + string + — +

    The HTML content.

    +
    + +
    + +
    +
    +

    + getPuts() + + +

    + + +

    Get only put options from the chain.

    + + + public + getPuts() : array<string|int, OptionQuote> + +
    +
    + + + + + + + +
    +
    Return values
    + array<string|int, OptionQuote> + — +

    Array of put option quotes.

    +
    + +
    + +
    +
    +

    + getQuotesByExpiration() + + +

    + + +

    Get option quotes for a specific expiration date.

    + + + public + getQuotesByExpiration(string $date) : array<string|int, OptionQuote> + +
    +
    + + +
    Parameters
    +
    +
    + $date + : string +
    +
    +

    The expiration date in YYYY-MM-DD format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + array<string|int, OptionQuote> + — +

    Array of option quotes for the given date, or empty array if not found.

    +
    + +
    + +
    +
    +

    + getStrikes() + + +

    + + +

    Get all unique strike prices in the chain, sorted ascending.

    + + + public + getStrikes() : array<string|int, float> + +
    +
    + + + + + + + +
    +
    Return values
    + array<string|int, float> + — +

    Array of unique strike prices.

    +
    + +
    + +
    +
    +

    + isCsv() + + +

    + + +

    Check if the response is in CSV format.

    + + + public + isCsv() : bool + +
    +
    + + + + + + + +
    +
    Return values
    + bool + — +

    True if the response is in CSV format, false otherwise.

    +
    + +
    + +
    +
    +

    + isHtml() + + +

    + + +

    Check if the response is in HTML format.

    + + + public + isHtml() : bool + +
    +
    + + + + + + + +
    +
    Return values
    + bool + — +

    True if the response is in HTML format, false otherwise.

    +
    + +
    + +
    +
    +

    + isJson() + + +

    + + +

    Check if the response is in JSON format.

    + + + public + isJson() : bool + +
    +
    + + + + + + + +
    +
    Return values
    + bool + — +

    True if the response is in JSON format, false otherwise.

    +
    + +
    + +
    +
    +

    + saveToFile() + + +

    + + +

    Save CSV/HTML content to a file.

    + + + public + saveToFile(string $filename) : string + +
    +
    + + +
    Parameters
    +
    +
    + $filename + : string +
    +
    +

    The file path to save to.

    +
    + +
    +
    + + +
    + Tags + + +
    +
    +
    + throws +
    +
    + InvalidArgumentException + +

    If filename is invalid (wrong extension, etc.).

    +
    + +
    +
    + throws +
    +
    + RuntimeException + +

    If file writing fails.

    +
    + +
    +
    + + + +
    +
    Return values
    + string + — +

    The absolute path of the saved file.

    +
    + +
    + +
    +
    +

    + toQuotes() + + +

    + + +

    Convert the option chains to a flat Quotes object.

    + + + public + toQuotes() : Quotes + +
    +
    + +

    This flattens all option quotes from all expiration dates into a single +Quotes container, useful when you want to treat a chain as a simple +collection of quotes.

    +
    + + + + + + +
    +
    Return values
    + Quotes + — +

    A Quotes object containing all option quotes from this chain.

    @@ -813,6 +1521,8 @@
    Return values
    if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } @@ -888,6 +1598,7 @@
    Return values
  • Properties
  • diff --git a/docs/classes/MarketDataApp-Endpoints-Responses-Options-OptionQuote.html b/docs/classes/MarketDataApp-Endpoints-Responses-Options-OptionQuote.html new file mode 100644 index 00000000..778f4879 --- /dev/null +++ b/docs/classes/MarketDataApp-Endpoints-Responses-Options-OptionQuote.html @@ -0,0 +1,2366 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
    +

    + MarketData SDK +

    + + + + + +
    + +
    +
    + + + + +
    +
    + + +
    +

    + OptionQuote + + +
    + in package + +
    + + + + uses + FormatsForDisplay +

    + +
    + + +
    + + + +

    Represents a single option quote with associated data.

    + + + + + + + +

    + Table of Contents + + +

    + + + + + + + + + +

    + Properties + + +

    +
    +
    + $ask + +  : float +
    + +
    + $ask_size + +  : int +
    + +
    + $bid + +  : float +
    + +
    + $bid_size + +  : int +
    + +
    + $delta + +  : float|null +
    + +
    + $dte + +  : int +
    + +
    + $expiration + +  : Carbon +
    + +
    + $extrinsic_value + +  : float +
    + +
    + $first_traded + +  : Carbon +
    + +
    + $gamma + +  : float|null +
    + +
    + $implied_volatility + +  : float|null +
    + +
    + $in_the_money + +  : bool +
    + +
    + $intrinsic_value + +  : float +
    + +
    + $last + +  : float|null +
    + +
    + $mid + +  : float +
    + +
    + $open_interest + +  : int +
    + +
    + $option_symbol + +  : string +
    + +
    + $side + +  : Side +
    + +
    + $strike + +  : float +
    + +
    + $theta + +  : float|null +
    + +
    + $underlying + +  : string +
    + +
    + $underlying_price + +  : float +
    + +
    + $updated + +  : Carbon +
    + +
    + $vega + +  : float|null +
    + +
    + $volume + +  : int +
    + +
    + +

    + Methods + + +

    +
    +
    + __construct() + +  : mixed +
    +
    Constructs a new OptionQuote instance.
    + +
    + __toString() + +  : string +
    +
    Returns a string representation of the option quote.
    + +
    + formatChange() + +  : string +
    +
    Format a change value with sign and currency (e.g., "+$1.25" or "-$0.50").
    + +
    + formatCurrency() + +  : string +
    +
    Format a float as currency (e.g., "$150.25").
    + +
    + formatDate() + +  : string +
    +
    Format a Carbon date without time (e.g., "Jan 24, 2026").
    + +
    + formatDateTime() + +  : string +
    +
    Format a Carbon date with time (e.g., "Jan 24, 2026 3:45 PM").
    + +
    + formatGreek() + +  : string +
    +
    Format a Greek value (4 decimal places, e.g., "0.4520").
    + +
    + formatNumber() + +  : string +
    +
    Format a number with commas (e.g., "15,234").
    + +
    + formatPercent() + +  : string +
    +
    Format a percentage with sign (e.g., "+3.25%" or "-1.50%").
    + +
    + formatPercentRaw() + +  : string +
    +
    Format a percentage that is already in percent form (e.g., "32.50%").
    + +
    + formatVolume() + +  : string +
    +
    Format volume with K/M/B suffixes (e.g., "54.9M", "12.3K").
    + +
    + + + + + + +
    +

    + Properties + + +

    +
    +

    + $ask + + + + +

    + + + + + + public + float + $ask + + + + + + + + + +
    +
    +

    + $ask_size + + + + +

    + + + + + + public + int + $ask_size + + + + + + + + + +
    +
    +

    + $bid + + + + +

    + + + + + + public + float + $bid + + + + + + + + + +
    +
    +

    + $bid_size + + + + +

    + + + + + + public + int + $bid_size + + + + + + + + + +
    +
    +

    + $delta + + + + +

    + + + + + + public + float|null + $delta + + + + + + + + + +
    +
    +

    + $dte + + + + +

    + + + + + + public + int + $dte + + + + + + + + + +
    +
    +

    + $expiration + + + + +

    + + + + + + public + Carbon + $expiration + + + + + + + + + +
    +
    +

    + $extrinsic_value + + + + +

    + + + + + + public + float + $extrinsic_value + + + + + + + + + +
    +
    +

    + $first_traded + + + + +

    + + + + + + public + Carbon + $first_traded + + + + + + + + + +
    +
    +

    + $gamma + + + + +

    + + + + + + public + float|null + $gamma + + + + + + + + + +
    +
    +

    + $implied_volatility + + + + +

    + + + + + + public + float|null + $implied_volatility + + + + + + + + + +
    +
    +

    + $in_the_money + + + + +

    + + + + + + public + bool + $in_the_money + + + + + + + + + +
    +
    +

    + $intrinsic_value + + + + +

    + + + + + + public + float + $intrinsic_value + + + + + + + + + +
    +
    +

    + $last + + + + +

    + + + + + + public + float|null + $last + + + + + + + + + +
    +
    +

    + $mid + + + + +

    + + + + + + public + float + $mid + + + + + + + + + +
    +
    +

    + $open_interest + + + + +

    + + + + + + public + int + $open_interest + + + + + + + + + +
    +
    +

    + $option_symbol + + + + +

    + + + + + + public + string + $option_symbol + + + + + + + + + +
    +
    +

    + $side + + + + +

    + + + + + + public + Side + $side + + + + + + + + + +
    +
    +

    + $strike + + + + +

    + + + + + + public + float + $strike + + + + + + + + + +
    +
    +

    + $theta + + + + +

    + + + + + + public + float|null + $theta + + + + + + + + + +
    +
    +

    + $underlying + + + + +

    + + + + + + public + string + $underlying + + + + + + + + + +
    +
    +

    + $underlying_price + + + + +

    + + + + + + public + float + $underlying_price + + + + + + + + + +
    +
    +

    + $updated + + + + +

    + + + + + + public + Carbon + $updated + + + + + + + + + +
    +
    +

    + $vega + + + + +

    + + + + + + public + float|null + $vega + + + + + + + + + +
    +
    +

    + $volume + + + + +

    + + + + + + public + int + $volume + + + + + + + + + +
    +
    + +
    +

    + Methods + + +

    +
    +

    + __construct() + + +

    + + +

    Constructs a new OptionQuote instance.

    + + + public + __construct(string $option_symbol, string $underlying, Carbon $expiration, Side $side, float $strike, Carbon $first_traded, int $dte, float $ask, int $ask_size, float $bid, int $bid_size, float $mid, float|null $last, int $volume, int $open_interest, float $underlying_price, bool $in_the_money, float $intrinsic_value, float $extrinsic_value, float|null $implied_volatility, float|null $delta, float|null $gamma, float|null $theta, float|null $vega, Carbon $updated) : mixed + +
    +
    + + +
    Parameters
    +
    +
    + $option_symbol + : string +
    +
    +

    The option symbol according to OCC symbology.

    +
    + +
    +
    + $underlying + : string +
    +
    +

    The ticker symbol of the underlying security.

    +
    + +
    +
    + $expiration + : Carbon +
    +
    +

    The option's expiration date in Unix time.

    +
    + +
    +
    + $side + : Side +
    +
    +

    The response will be call or put.

    +
    + +
    +
    + $strike + : float +
    +
    +

    The exercise price of the option.

    +
    + +
    +
    + $first_traded + : Carbon +
    +
    +

    The date the option was first traded.

    +
    + +
    +
    + $dte + : int +
    +
    +

    The number of days until the option expires.

    +
    + +
    +
    + $ask + : float +
    +
    +

    The ask price.

    +
    + +
    +
    + $ask_size + : int +
    +
    +

    The number of contracts offered at the ask price.

    +
    + +
    +
    + $bid + : float +
    +
    +

    The bid price.

    +
    + +
    +
    + $bid_size + : int +
    +
    +

    The number of contracts offered at the bid price.

    +
    + +
    +
    + $mid + : float +
    +
    +

    The midpoint price between the ask and the bid, also known as the mark +price.

    +
    + +
    +
    + $last + : float|null +
    +
    +

    The last price negotiated for this option contract at the time of this +quote.

    +
    + +
    +
    + $volume + : int +
    +
    +

    The number of contracts negotiated during the trading day at the time of +this quote.

    +
    + +
    +
    + $open_interest + : int +
    +
    +

    The total number of contracts that have not yet been settled at the time +of this quote.

    +
    + +
    +
    + $underlying_price + : float +
    +
    +

    The last price of the underlying security at the time of this quote.

    +
    + +
    +
    + $in_the_money + : bool +
    +
    +

    Specifies whether the option contract was in the money true or false at +the time of this quote.

    +
    + +
    +
    + $intrinsic_value + : float +
    +
    +

    The intrinsic value of the option.

    +
    + +
    +
    + $extrinsic_value + : float +
    +
    +

    The extrinsic value of the option.

    +
    + +
    +
    + $implied_volatility + : float|null +
    +
    +

    The implied volatility of the option.

    +
    + +
    +
    + $delta + : float|null +
    +
    +

    The delta of the option.

    +
    + +
    +
    + $gamma + : float|null +
    +
    +

    The gamma of the option.

    +
    + +
    +
    + $theta + : float|null +
    +
    +

    The theta of the option.

    +
    + +
    +
    + $vega + : float|null +
    +
    +

    The vega of the option.

    +
    + +
    +
    + $updated + : Carbon +
    +
    +

    The date/time of the quote.

    +
    + +
    +
    + + + + + + +
    +
    +

    + __toString() + + +

    + + +

    Returns a string representation of the option quote.

    + + + public + __toString() : string + +
    +
    + + + + + + + +
    +
    Return values
    + string + — +

    Human-readable option quote data.

    +
    + +
    + +
    +
    +

    + formatChange() + + +

    + + +

    Format a change value with sign and currency (e.g., "+$1.25" or "-$0.50").

    + + + protected + formatChange(float|null $value) : string + +
    +
    + + +
    Parameters
    +
    +
    + $value + : float|null +
    +
    +

    The change value to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted change string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatCurrency() + + +

    + + +

    Format a float as currency (e.g., "$150.25").

    + + + protected + formatCurrency(float|null $value) : string + +
    +
    + + +
    Parameters
    +
    +
    + $value + : float|null +
    +
    +

    The value to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted currency string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatDate() + + +

    + + +

    Format a Carbon date without time (e.g., "Jan 24, 2026").

    + + + protected + formatDate(Carbon|null $date) : string + +
    +
    + + +
    Parameters
    +
    +
    + $date + : Carbon|null +
    +
    +

    The date to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted date string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatDateTime() + + +

    + + +

    Format a Carbon date with time (e.g., "Jan 24, 2026 3:45 PM").

    + + + protected + formatDateTime(Carbon|null $date) : string + +
    +
    + + +
    Parameters
    +
    +
    + $date + : Carbon|null +
    +
    +

    The date to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted date string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatGreek() + + +

    + + +

    Format a Greek value (4 decimal places, e.g., "0.4520").

    + + + protected + formatGreek(float|null $value) : string + +
    +
    + + +
    Parameters
    +
    +
    + $value + : float|null +
    +
    +

    The Greek value to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted Greek string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatNumber() + + +

    + + +

    Format a number with commas (e.g., "15,234").

    + + + protected + formatNumber(int|null $value) : string + +
    +
    + + +
    Parameters
    +
    +
    + $value + : int|null +
    +
    +

    The number to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted number string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatPercent() + + +

    + + +

    Format a percentage with sign (e.g., "+3.25%" or "-1.50%").

    + + + protected + formatPercent(float|null $value) : string + +
    +
    + +

    Assumes input is a decimal (0.30 = 30%).

    +
    + +
    Parameters
    +
    +
    + $value + : float|null +
    +
    +

    The decimal value to format as percentage.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted percentage string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatPercentRaw() + + +

    + + +

    Format a percentage that is already in percent form (e.g., "32.50%").

    + + + protected + formatPercentRaw(float|null $value) : string + +
    +
    + +

    Use this for values like implied volatility that are already percentages.

    +
    + +
    Parameters
    +
    +
    + $value + : float|null +
    +
    +

    The percentage value to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted percentage string or "N/A" if null.

    +
    + +
    + +
    +
    +

    + formatVolume() + + +

    + + +

    Format volume with K/M/B suffixes (e.g., "54.9M", "12.3K").

    + + + protected + formatVolume(int|null $value) : string + +
    +
    + + +
    Parameters
    +
    +
    + $value + : int|null +
    +
    +

    The volume to format.

    +
    + +
    +
    + + + + + +
    +
    Return values
    + string + — +

    Formatted volume string or "N/A" if null.

    +
    + +
    + +
    +
    + +
    +
    +
    +
    +
    
    +        
    + +
    +
    + + + +
    +
    +
    + +
    + On this page + + +
    + +
    +
    +
    +
    +
    +

    Search results

    + +
    +
    +
      +
      +
      +
      +
      + + +
      + + + + + + + + diff --git a/docs/classes/MarketDataApp-Endpoints-Responses-Options-Quotes.html b/docs/classes/MarketDataApp-Endpoints-Responses-Options-Quotes.html index b08ffce8..eafdd97e 100644 --- a/docs/classes/MarketDataApp-Endpoints-Responses-Options-Quotes.html +++ b/docs/classes/MarketDataApp-Endpoints-Responses-Options-Quotes.html @@ -80,6 +80,14 @@

    • Exceptions +
    • +
    • + Logging + +
    • +
    • + Retry +
    • Traits @@ -144,7 +152,7 @@

      @@ -154,10 +162,8 @@

      - - - - + +

      Table of Contents @@ -178,26 +184,39 @@

      +
      + $_saved_filename + +  : string|null +
      + +
      + $errors + +  : array<string, string> +
      +
      Array of errors for failed symbol requests (multi-symbol requests only).
      +
      $next_time -  : Carbon +  : Carbon|null
      Time of the next quote if there is no data in the requested period, but there is data in a subsequent period.
      $prev_time -  : Carbon +  : Carbon|null
      Time of the previous quote if there is no data in the requested period, but there is data in a previous period.
      $quotes -  : array<string|int, Quote> +  : array<string|int, OptionQuote>
      -
      Array of Quote objects.
      +
      Array of OptionQuote objects.
      $status @@ -233,6 +252,20 @@

      Constructs a new Quotes instance from the given response object.
      +
      + __toString() + +  : string +
      +
      Returns a string representation of the option quotes collection.
      + +
      + createMerged() + +  : self +
      +
      Create a Quotes object from pre-merged data.
      +
      getCsv() @@ -268,6 +301,13 @@

      Check if the response is in JSON format.
      +
      + saveToFile() + +  : string +
      +
      Save CSV/HTML content to a file.
      +
      @@ -286,19 +326,100 @@

      phpdocumentor-element -property -public - " + " +> +

      + $_saved_filename + + + + +

      + + + + + + public + string|null + $_saved_filename + = null + + +

      The filename where the response was saved (if filename parameter was used).

      +
      + + + + + + +
    • +
      +

      + $errors + + + + +

      + + +

      Array of errors for failed symbol requests (multi-symbol requests only).

      + + + + public + array<string, string> + $errors + = [] + +

      This property is populated only when using multi-symbol quotes() requests. +Each key is the option symbol that failed, and the value is the error message. +Empty array means no errors occurred.

      +
      + + + + + + + +
      +

      $next_time - +

      @@ -306,16 +427,17 @@

      - public - Carbon + public + Carbon|null $next_time - + = null - + +

      phpdocumentor-element -property -public - " + " >

      $prev_time - +

      @@ -343,16 +465,17 @@

      - public - Carbon + public + Carbon|null $prev_time - + = null - + +

      phpdocumentor-element -property -public - " + " >

      $quotes - +

      -

      Array of Quote objects.

      +

      Array of OptionQuote objects.

      - public - array<string|int, Quote> + public + array<string|int, OptionQuote> $quotes = [] @@ -389,7 +512,8 @@

      - + +

      phpdocumentor-element -property -public - " + " >

      $status - +

      @@ -417,16 +541,17 @@

      - public - string + public + string $status - + = 'no_data' - + +

      phpdocumentor-element -property -protected - " + " >

      $csv - +

      phpdocumentor-element -property -protected - " + " >

      $html - +

      @@ -527,7 +654,7 @@

      @@ -535,7 +662,7 @@

      public - __construct(object $response) : mixed + __construct(object $response) : mixed
      @@ -544,8 +671,8 @@

      Parameters
      - $response - : object + $response + : object

      The response object containing quotes data.

      @@ -556,9 +683,146 @@
      Parameters
      + + + +
      +

      + __toString() + + +

      + + +

      Returns a string representation of the option quotes collection.

      + + + public + __toString() : string + +
      +
      + + + + + + +
      +
      Return values
      + string + — +

      Human-readable option quotes summary.

      +
      + +
      + +
      +
      +

      + createMerged() + + +

      + + +

      Create a Quotes object from pre-merged data.

      + + + public + static createMerged(string $status, array<string|int, OptionQuote$quotes[, Carbon|null $nextTime = null ][, Carbon|null $prevTime = null ][, array<string, string> $errors = [] ]) : self + +
      +
      + +

      This static factory method is used by the concurrent request feature +to create a Quotes object from multiple merged responses.

      +
      + +
      Parameters
      +
      +
      + $status + : string +
      +
      +

      The overall status ('ok' or 'no_data').

      +
      + +
      +
      + $quotes + : array<string|int, OptionQuote> +
      +
      +

      Array of OptionQuote objects.

      +
      + +
      +
      + $nextTime + : Carbon|null + = null
      +
      +

      Time of next quote if no data (for no_data status).

      +
      + +
      +
      + $prevTime + : Carbon|null + = null
      +
      +

      Time of previous quote if no data (for no_data status).

      +
      + +
      +
      + $errors + : array<string, string> + = []
      +
      +

      Array of errors for failed symbols (symbol => error message).

      +
      + +
      +
      + + + + + +
      +
      Return values
      + self + — +

      A new Quotes instance with the merged data.

      +
      + +
      +
      @@ -590,9 +854,26 @@

      +

      + Tags + - +
      +
      +
      + throws +
      +
      + InvalidArgumentException + +

      If the response is not in CSV format.

      +
      + +
      +
      + +
      Return values
      string @@ -617,7 +898,7 @@

      @@ -633,9 +914,26 @@

      +

      + Tags + - +
      +
      +
      + throws +
      +
      + InvalidArgumentException + +

      If the response is not in HTML format.

      +
      + +
      +
      + +
      Return values
      string @@ -660,7 +958,7 @@

      @@ -677,8 +975,8 @@

      + -
      Return values
      bool @@ -703,7 +1001,7 @@

      @@ -720,8 +1018,8 @@

      + -
      Return values
      bool @@ -746,7 +1044,7 @@

      @@ -763,8 +1061,8 @@

      + -
      Return values
      bool @@ -774,6 +1072,88 @@
      Return values
      +

      +
      +

      + saveToFile() + + +

      + + +

      Save CSV/HTML content to a file.

      + + + public + saveToFile(string $filename) : string + +
      +
      + + +
      Parameters
      +
      +
      + $filename + : string +
      +
      +

      The file path to save to.

      +
      + +
      +
      + + +
      + Tags + + +
      +
      +
      + throws +
      +
      + InvalidArgumentException + +

      If filename is invalid (wrong extension, etc.).

      +
      + +
      +
      + throws +
      +
      + RuntimeException + +

      If file writing fails.

      +
      + +
      +
      + + + +
      +
      Return values
      + string + — +

      The absolute path of the saved file.

      +
      + +
      +
      @@ -813,6 +1193,8 @@
      Return values
      if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } @@ -888,6 +1270,8 @@
      Return values
    • Properties
    • diff --git a/docs/classes/MarketDataApp-Endpoints-Responses-Options-Strikes.html b/docs/classes/MarketDataApp-Endpoints-Responses-Options-Strikes.html index 5f842c19..52e3dc89 100644 --- a/docs/classes/MarketDataApp-Endpoints-Responses-Options-Strikes.html +++ b/docs/classes/MarketDataApp-Endpoints-Responses-Options-Strikes.html @@ -80,6 +80,14 @@

    • Exceptions +
    • +
    • + Logging + +
    • +
    • + Retry +
    • Traits @@ -154,10 +162,8 @@

      - - - - + +

      Table of Contents @@ -178,6 +184,12 @@

      +
      + $_saved_filename + +  : string|null +
      +
      $dates @@ -188,14 +200,14 @@

      $next_time -  : Carbon +  : Carbon|null
      Time of the next quote if there is no data in the requested period, but there is data in a subsequent period.
      $prev_time -  : Carbon +  : Carbon|null
      Time of the previous quote if there is no data in the requested period, but there is data in a previous period.
      @@ -209,7 +221,7 @@

      $updated -  : Carbon +  : Carbon|null
      The date and time of this list of options strikes was updated in Unix time.
      @@ -240,6 +252,13 @@

      Constructs a new Strikes instance from the given response object.
      +
      + __toString() + +  : string +
      +
      Returns a string representation of the strikes collection.
      +
      getCsv() @@ -275,6 +294,13 @@

      Check if the response is in JSON format.
      +
      + saveToFile() + +  : string +
      +
      Save CSV/HTML content to a file.
      +
      @@ -293,14 +319,53 @@

      phpdocumentor-element -property -public - " + " +> +

      + $_saved_filename + + + + +

      + + + + + + public + string|null + $_saved_filename + = null + + +

      The filename where the response was saved (if filename parameter was used).

      +
      + + + + + + + +

      $dates - +

      phpdocumentor-element -property -public - " + " >

      $next_time - +

      phpdocumentor-element -property -public - " + " >

      $prev_time - +

      phpdocumentor-element -property -public - " + " >

      $status - +

      phpdocumentor-element -property -public - " + " >

      $updated - +

      phpdocumentor-element -property -protected - " + " >

      $csv - +

      phpdocumentor-element -property -protected - " + " >

      $html - +

    • @@ -581,7 +653,7 @@

      public - __construct(object $response) : mixed + __construct(object $response) : mixed
      @@ -590,8 +662,8 @@

      Parameters
      - $response - : object + $response + : object

      The response object containing strikes data.

      @@ -602,9 +674,52 @@
      Parameters
      + + + + +
      +

      + __toString() + + +

      + + +

      Returns a string representation of the strikes collection.

      + + + public + __toString() : string + +
      +
      + + + + +
      +
      Return values
      + string + — +

      Human-readable strikes summary.

      +
      + +
      +
      @@ -636,9 +751,26 @@

      +

      + Tags + - +
      +
      +
      + throws +
      +
      + InvalidArgumentException + +

      If the response is not in CSV format.

      +
      + +
      +
      + +
      Return values
      string @@ -663,7 +795,7 @@

      @@ -679,9 +811,26 @@

      +

      + Tags + - +
      +
      +
      + throws +
      +
      + InvalidArgumentException + +

      If the response is not in HTML format.

      +
      + +
      +
      + +
      Return values
      string @@ -706,7 +855,7 @@

      @@ -723,8 +872,8 @@

      + -
      Return values
      bool @@ -749,7 +898,7 @@

      @@ -766,8 +915,8 @@

      + -
      Return values
      bool @@ -792,7 +941,7 @@

      @@ -809,8 +958,8 @@

      + -
      Return values
      bool @@ -820,6 +969,88 @@
      Return values
      +

      +
      +

      + saveToFile() + + +

      + + +

      Save CSV/HTML content to a file.

      + + + public + saveToFile(string $filename) : string + +
      +
      + + +
      Parameters
      +
      +
      + $filename + : string +
      +
      +

      The file path to save to.

      +
      + +
      +
      + + +
      + Tags + + +
      +
      +
      + throws +
      +
      + InvalidArgumentException + +

      If filename is invalid (wrong extension, etc.).

      +
      + +
      +
      + throws +
      +
      + RuntimeException + +

      If file writing fails.

      +
      + +
      +
      + + + +
      +
      Return values
      + string + — +

      The absolute path of the saved file.

      +
      + +
      +
      @@ -859,6 +1090,8 @@
      Return values
      if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } @@ -934,6 +1167,7 @@
      Return values
    • Properties
    • diff --git a/docs/classes/MarketDataApp-Endpoints-Responses-ResponseBase.html b/docs/classes/MarketDataApp-Endpoints-Responses-ResponseBase.html index 0d2cab85..6edce196 100644 --- a/docs/classes/MarketDataApp-Endpoints-Responses-ResponseBase.html +++ b/docs/classes/MarketDataApp-Endpoints-Responses-ResponseBase.html @@ -80,6 +80,14 @@

    • Exceptions +
    • +
    • + Logging + +
    • +
    • + Retry +
    • Traits @@ -152,10 +160,8 @@

      - - - - + +

      Table of Contents @@ -176,6 +182,12 @@

      +
      + $_saved_filename + +  : string|null +
      +
      $csv @@ -238,6 +250,13 @@

      Check if the response is in JSON format.
      +
      + saveToFile() + +  : string +
      +
      Save CSV/HTML content to a file.
      +
      @@ -252,18 +271,57 @@

      +

      + $_saved_filename + + + + +

      + + + + + + public + string|null + $_saved_filename + = null + + +

      The filename where the response was saved (if filename parameter was used).

      +
      + + + + + + +
      +

      $csv - +

      phpdocumentor-element -property -protected - " + " >

      $html - +

    • @@ -349,7 +409,7 @@

      @@ -357,7 +417,7 @@

      public - __construct(object $response) : mixed + __construct(object $response) : mixed
      @@ -366,8 +426,8 @@

      Parameters
      - $response - : object + $response + : object

      The raw response object from the API.

      @@ -378,8 +438,8 @@
      Parameters
      + -
      @@ -412,9 +472,26 @@

      +

      + Tags + - +
      +
      +
      + throws +
      +
      + InvalidArgumentException + +

      If the response is not in CSV format.

      +
      + +
      +
      + +
      Return values
      string @@ -439,7 +516,7 @@

      @@ -455,9 +532,26 @@

      +

      + Tags + - +
      +
      +
      + throws +
      +
      + InvalidArgumentException + +

      If the response is not in HTML format.

      +
      + +
      +
      + +
      Return values
      string @@ -482,7 +576,7 @@

      @@ -499,8 +593,8 @@

      + -
      Return values
      bool @@ -525,7 +619,7 @@

      @@ -542,8 +636,8 @@

      + -
      Return values
      bool @@ -568,7 +662,7 @@

      @@ -585,8 +679,8 @@

      + -
      Return values
      bool @@ -596,6 +690,88 @@
      Return values
      +

      +
      +

      + saveToFile() + + +

      + + +

      Save CSV/HTML content to a file.

      + + + public + saveToFile(string $filename) : string + +
      +
      + + +
      Parameters
      +
      +
      + $filename + : string +
      +
      +

      The file path to save to.

      +
      + +
      +
      + + +
      + Tags + + +
      +
      +
      + throws +
      +
      + InvalidArgumentException + +

      If filename is invalid (wrong extension, etc.).

      +
      + +
      +
      + throws +
      +
      + RuntimeException + +

      If file writing fails.

      +
      + +
      +
      + + + +
      +
      Return values
      + string + — +

      The absolute path of the saved file.

      +
      + +
      +
      @@ -635,6 +811,8 @@
      Return values
      if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } @@ -710,6 +888,7 @@
      Return values
    • Properties
    • @@ -724,6 +903,7 @@
      Return values
    • isCsv()
    • isHtml()
    • isJson()
    • +
    • saveToFile()
    • diff --git a/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-BulkCandles.html b/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-BulkCandles.html index a2d7739f..5ed8cffa 100644 --- a/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-BulkCandles.html +++ b/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-BulkCandles.html @@ -80,6 +80,14 @@

    • Exceptions +
    • +
    • + Logging + +
    • +
    • + Retry +
    • Traits @@ -154,10 +162,8 @@

      - - - - + +

      Table of Contents @@ -178,6 +184,12 @@

      +
      + $_saved_filename + +  : string|null +
      +
      $candles @@ -219,6 +231,13 @@

      Constructs a new BulkCandles instance from the given response object.
      +
      + __toString() + +  : string +
      +
      Returns a string representation of the bulk candles collection.
      +
      getCsv() @@ -254,6 +273,13 @@

      Check if the response is in JSON format.
      +
      + saveToFile() + +  : string +
      +
      Save CSV/HTML content to a file.
      +
      @@ -272,14 +298,53 @@

      phpdocumentor-element -property -public - " + " +> +

      + $_saved_filename + + + + +

      + + + + + + public + string|null + $_saved_filename + = null + + +

      The filename where the response was saved (if filename parameter was used).

      +
      + + + + + + + +

      $candles - +

      phpdocumentor-element -property -public - " + " >

      $status - +

      phpdocumentor-element -property -protected - " + " >

      $csv - +

      phpdocumentor-element -property -protected - " + " >

      $html - +

      @@ -447,7 +516,7 @@

      public - __construct(object $response) : mixed + __construct(object $response) : mixed
      @@ -456,8 +525,8 @@

      Parameters
      - $response - : object + $response + : object

      The response object containing bulk candles data.

      @@ -468,9 +537,52 @@
      Parameters
      + + + + +
      +

      + __toString() + + +

      + + +

      Returns a string representation of the bulk candles collection.

      + + + public + __toString() : string + +
      +
      + + + + +
      +
      Return values
      + string + — +

      Human-readable bulk candles summary.

      +
      + +
      +
      @@ -502,9 +614,26 @@

      +

      + Tags + + +
      +
      +
      + throws +
      +
      + InvalidArgumentException + +

      If the response is not in CSV format.

      +
      - +
      +
      + +
      Return values
      string @@ -529,7 +658,7 @@

      @@ -545,9 +674,26 @@

      +

      + Tags + + +
      +
      +
      + throws +
      +
      + InvalidArgumentException + +

      If the response is not in HTML format.

      +
      - +
      +
      + +
      Return values
      string @@ -572,7 +718,7 @@

      @@ -589,8 +735,8 @@

      + -
      Return values
      bool @@ -615,7 +761,7 @@

      @@ -632,8 +778,8 @@

      + -
      Return values
      bool @@ -658,7 +804,7 @@

      @@ -675,8 +821,8 @@

      + -
      Return values
      bool @@ -686,6 +832,88 @@
      Return values
      +

      +
      +

      + saveToFile() + + +

      + + +

      Save CSV/HTML content to a file.

      + + + public + saveToFile(string $filename) : string + +
      +
      + + +
      Parameters
      +
      +
      + $filename + : string +
      +
      +

      The file path to save to.

      +
      + +
      +
      + + +
      + Tags + + +
      +
      +
      + throws +
      +
      + InvalidArgumentException + +

      If filename is invalid (wrong extension, etc.).

      +
      + +
      +
      + throws +
      +
      + RuntimeException + +

      If file writing fails.

      +
      + +
      +
      + + + +
      +
      Return values
      + string + — +

      The absolute path of the saved file.

      +
      + +
      +
      @@ -725,6 +953,8 @@
      Return values
      if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } @@ -800,6 +1030,7 @@
      Return values
    • Properties
    • diff --git a/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-Candle.html b/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-Candle.html index 74617144..776a6775 100644 --- a/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-Candle.html +++ b/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-Candle.html @@ -80,6 +80,14 @@

    • Exceptions +
    • +
    • + Logging + +
    • +
    • + Retry +
    • Traits @@ -131,6 +139,9 @@

    • + + uses + FormatsForDisplay
      @@ -141,7 +152,7 @@

      @@ -151,10 +162,8 @@

      - - - - + +

      Table of Contents @@ -199,6 +208,12 @@

       : float +
      + $symbol + +  : string|null +
      +
      $timestamp @@ -226,6 +241,76 @@

      Constructs a new Candle instance.
      +
      + __toString() + +  : string +
      +
      Returns a string representation of the candle.
      + +
      + formatChange() + +  : string +
      +
      Format a change value with sign and currency (e.g., "+$1.25" or "-$0.50").
      + +
      + formatCurrency() + +  : string +
      +
      Format a float as currency (e.g., "$150.25").
      + +
      + formatDate() + +  : string +
      +
      Format a Carbon date without time (e.g., "Jan 24, 2026").
      + +
      + formatDateTime() + +  : string +
      +
      Format a Carbon date with time (e.g., "Jan 24, 2026 3:45 PM").
      + +
      + formatGreek() + +  : string +
      +
      Format a Greek value (4 decimal places, e.g., "0.4520").
      + +
      + formatNumber() + +  : string +
      +
      Format a number with commas (e.g., "15,234").
      + +
      + formatPercent() + +  : string +
      +
      Format a percentage with sign (e.g., "+3.25%" or "-1.50%").
      + +
      + formatPercentRaw() + +  : string +
      +
      Format a percentage that is already in percent form (e.g., "32.50%").
      + +
      + formatVolume() + +  : string +
      +
      Format volume with K/M/B suffixes (e.g., "54.9M", "12.3K").
      + @@ -244,27 +329,27 @@

      phpdocumentor-element -property -public - " + " >

      $close - +

      - public - float + public + float $close @@ -272,7 +357,8 @@

      - + +
      phpdocumentor-element -property -public - " + " >

      $high - +

      - public - float + public + float $high @@ -308,7 +394,8 @@

      - + +

      phpdocumentor-element -property -public - " + " >

      $low - +

      - public - float + public + float $low @@ -344,7 +431,8 @@

      - + +

      phpdocumentor-element -property -public - " + " >

      $open - +

      - public - float + public + float $open @@ -380,7 +468,45 @@

      + + + +

      +
      +

      + $symbol + + + + +

      + + + + + public + string|null + $symbol + = null + + + + + + +
      phpdocumentor-element -property -public - " + " >

      $timestamp - +

      - public - Carbon + public + Carbon $timestamp @@ -416,7 +542,8 @@

      - + +

      phpdocumentor-element -property -public - " + " >

      $volume - +

      - public - int + public + int $volume @@ -452,7 +579,8 @@

      - + +

      @@ -477,7 +605,7 @@

      @@ -485,7 +613,7 @@

      public - __construct(float $open, float $high, float $low, float $close, int $volume, Carbon $timestamp) : mixed + __construct(float $open, float $high, float $low, float $close, int $volume, Carbon $timestamp[, string|null $symbol = null ]) : mixed
      @@ -494,8 +622,8 @@

      Parameters
      - $open - : float + $open + : float

      Open price of the candle.

      @@ -503,8 +631,8 @@
      Parameters
      - $high - : float + $high + : float

      High price of the candle.

      @@ -512,8 +640,8 @@
      Parameters
      - $low - : float + $low + : float

      Low price of the candle.

      @@ -521,8 +649,8 @@
      Parameters
      - $close - : float + $close + : float

      Close price of the candle.

      @@ -530,8 +658,8 @@
      Parameters
      - $volume - : int + $volume + : int

      Trading volume during the candle period.

      @@ -539,12 +667,22 @@
      Parameters
      - $timestamp - : Carbon + $timestamp + : Carbon
      -

      Candle time (Unix timestamp, UTC). Daily, weekly, monthly, yearly candles are returned -without times.

      +

      Candle time (Unix timestamp, UTC). Daily, weekly, monthly, yearly candles are +returned without times.

      +
      + +
      +
      + $symbol + : string|null + = null
      +
      +

      The stock symbol this candle belongs to. Populated for bulkCandles() responses +and single-symbol candles() requests.

      @@ -552,9 +690,551 @@
      Parameters
      + + + +
      +

      + __toString() + +

      + + +

      Returns a string representation of the candle.

      + + + public + __toString() : string + +
      +
      + + + + + + + +
      +
      Return values
      + string + — +

      Human-readable candle data.

      +
      + +
      + +
      +
      +

      + formatChange() + + +

      + + +

      Format a change value with sign and currency (e.g., "+$1.25" or "-$0.50").

      + + + protected + formatChange(float|null $value) : string + +
      +
      + + +
      Parameters
      +
      +
      + $value + : float|null +
      +
      +

      The change value to format.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted change string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatCurrency() + + +

      + + +

      Format a float as currency (e.g., "$150.25").

      + + + protected + formatCurrency(float|null $value) : string + +
      +
      + +
      Parameters
      +
      +
      + $value + : float|null +
      +
      +

      The value to format.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted currency string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatDate() + + +

      + + +

      Format a Carbon date without time (e.g., "Jan 24, 2026").

      + + + protected + formatDate(Carbon|null $date) : string + +
      +
      + + +
      Parameters
      +
      +
      + $date + : Carbon|null +
      +
      +

      The date to format.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted date string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatDateTime() + + +

      + + +

      Format a Carbon date with time (e.g., "Jan 24, 2026 3:45 PM").

      + + + protected + formatDateTime(Carbon|null $date) : string + +
      +
      + + +
      Parameters
      +
      +
      + $date + : Carbon|null +
      +
      +

      The date to format.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted date string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatGreek() + + +

      + + +

      Format a Greek value (4 decimal places, e.g., "0.4520").

      + + + protected + formatGreek(float|null $value) : string + +
      +
      + + +
      Parameters
      +
      +
      + $value + : float|null +
      +
      +

      The Greek value to format.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted Greek string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatNumber() + + +

      + + +

      Format a number with commas (e.g., "15,234").

      + + + protected + formatNumber(int|null $value) : string + +
      +
      + + +
      Parameters
      +
      +
      + $value + : int|null +
      +
      +

      The number to format.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted number string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatPercent() + + +

      + + +

      Format a percentage with sign (e.g., "+3.25%" or "-1.50%").

      + + + protected + formatPercent(float|null $value) : string + +
      +
      + +

      Assumes input is a decimal (0.30 = 30%).

      +
      + +
      Parameters
      +
      +
      + $value + : float|null +
      +
      +

      The decimal value to format as percentage.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted percentage string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatPercentRaw() + + +

      + + +

      Format a percentage that is already in percent form (e.g., "32.50%").

      + + + protected + formatPercentRaw(float|null $value) : string + +
      +
      + +

      Use this for values like implied volatility that are already percentages.

      +
      + +
      Parameters
      +
      +
      + $value + : float|null +
      +
      +

      The percentage value to format.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted percentage string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatVolume() + + +

      + + +

      Format volume with K/M/B suffixes (e.g., "54.9M", "12.3K").

      + + + protected + formatVolume(int|null $value) : string + +
      +
      + + +
      Parameters
      +
      +
      + $value + : int|null +
      +
      +

      The volume to format.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted volume string or "N/A" if null.

      +
      + +
      +
      @@ -594,6 +1274,8 @@
      Parameters
      if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } @@ -673,6 +1355,7 @@
      Parameters
    • $high
    • $low
    • $open
    • +
    • $symbol
    • $timestamp
    • $volume
    • @@ -682,6 +1365,16 @@
      Parameters
    • diff --git a/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-Candles.html b/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-Candles.html index a382759d..5d9133a1 100644 --- a/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-Candles.html +++ b/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-Candles.html @@ -80,6 +80,14 @@

    • Exceptions +
    • +
    • + Logging + +
    • +
    • + Retry +
    • Traits @@ -156,10 +164,8 @@

      - - - - + +

      Table of Contents @@ -180,6 +186,12 @@

      +
      + $_saved_filename + +  : string|null +
      +
      $candles @@ -190,7 +202,7 @@

      $next_time -  : int +  : int|null
      Unix time of the next quote if there is no data in the requested period, but there is data in a subsequent period.
      @@ -229,6 +241,20 @@

      Constructs a new Candles object and parses the response data.
      +
      + __toString() + +  : string +
      +
      Returns a string representation of the candles collection.
      + +
      + createMerged() + +  : self +
      +
      Create a Candles object from pre-merged data.
      +
      getCsv() @@ -264,6 +290,13 @@

      Check if the response is in JSON format.
      +
      + saveToFile() + +  : string +
      +
      Save CSV/HTML content to a file.
      +
      @@ -282,14 +315,53 @@

      phpdocumentor-element -property -public - " + " +> +

      + $_saved_filename + + + + +

      + + + + + + public + string|null + $_saved_filename + = null + + +

      The filename where the response was saved (if filename parameter was used).

      +
      + + + + + + + +

      $candles - +

      phpdocumentor-element -property -public - " + " >

      $next_time - +

      phpdocumentor-element -property -public - " + " >

      $status - +

      phpdocumentor-element -property -protected - " + " >

      $csv - +

      phpdocumentor-element -property -protected - " + " >

      $html - +

      @@ -487,7 +564,7 @@

      @@ -495,7 +572,7 @@

      public - __construct(object $response) : mixed + __construct(object $response[, string|null $symbol = null ]) : mixed
      @@ -504,21 +581,150 @@

      Parameters
      - $response - : object + $response + : object

      The raw response object to be parsed.

      +
      +
      + $symbol + : string|null + = null
      +
      +

      Optional symbol to associate with each candle. Used when the caller +knows the symbol (e.g., single-symbol candles() requests).

      +
      +
      + + + + +
      +

      + __toString() + + +

      + + +

      Returns a string representation of the candles collection.

      + + + public + __toString() : string + +
      +
      + + + + + + + +
      +
      Return values
      + string + — +

      Human-readable candles summary.

      +
      + +
      + +
      +
      +

      + createMerged() + + +

      + + +

      Create a Candles object from pre-merged data.

      + + + public + static createMerged(string $status, array<string|int, Candle$candles[, int|null $nextTime = null ]) : self + +
      +
      + +

      This static factory method is used by the automatic concurrent request +feature to create a Candles object from multiple merged responses.

      +
      + +
      Parameters
      +
      +
      + $status + : string +
      +
      +

      The overall status ('ok' or 'no_data').

      +
      + +
      +
      + $candles + : array<string|int, Candle> +
      +
      +

      Array of Candle objects.

      +
      + +
      +
      + $nextTime + : int|null + = null
      +
      +

      Unix timestamp of next available data (for no_data status).

      +
      + +
      +
      + + +
      +
      Return values
      + self + — +

      A new Candles instance with the merged data.

      +
      + +
      +
      @@ -550,9 +756,26 @@

      +

      + Tags + + +
      +
      +
      + throws +
      +
      + InvalidArgumentException + +

      If the response is not in CSV format.

      +
      - +
      +
      + +
      Return values
      string @@ -577,7 +800,7 @@

      @@ -593,9 +816,26 @@

      +

      + Tags + + +
      +
      +
      + throws +
      +
      + InvalidArgumentException + +

      If the response is not in HTML format.

      +
      - +
      +
      + +
      Return values
      string @@ -620,7 +860,7 @@

      @@ -637,8 +877,8 @@

      + -
      Return values
      bool @@ -663,7 +903,7 @@

      @@ -680,8 +920,8 @@

      + -
      Return values
      bool @@ -706,7 +946,7 @@

      @@ -723,8 +963,8 @@

      + -
      Return values
      bool @@ -734,6 +974,88 @@
      Return values
      +

      +
      +

      + saveToFile() + + +

      + + +

      Save CSV/HTML content to a file.

      + + + public + saveToFile(string $filename) : string + +
      +
      + + +
      Parameters
      +
      +
      + $filename + : string +
      +
      +

      The file path to save to.

      +
      + +
      +
      + + +
      + Tags + + +
      +
      +
      + throws +
      +
      + InvalidArgumentException + +

      If filename is invalid (wrong extension, etc.).

      +
      + +
      +
      + throws +
      +
      + RuntimeException + +

      If file writing fails.

      +
      + +
      +
      + + + +
      +
      Return values
      + string + — +

      The absolute path of the saved file.

      +
      + +
      +
      @@ -773,6 +1095,8 @@
      Return values
      if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } @@ -848,6 +1172,7 @@
      Return values
    • Properties
    • diff --git a/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-Earning.html b/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-Earning.html index e79b8adf..61bb6a16 100644 --- a/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-Earning.html +++ b/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-Earning.html @@ -80,6 +80,14 @@

    • Exceptions +
    • +
    • + Logging + +
    • +
    • + Retry +
    • Traits @@ -131,6 +139,9 @@

    • + + uses + FormatsForDisplay
      @@ -141,7 +152,7 @@

      @@ -153,10 +164,8 @@

      - - - - + +

      Table of Contents @@ -180,7 +189,7 @@

      $currency -  : string +  : string|null
      @@ -264,6 +273,76 @@

      Constructs a new Earning object with detailed earnings information.
      +
      + __toString() + +  : string +
      +
      Returns a string representation of the earnings data.
      + +
      + formatChange() + +  : string +
      +
      Format a change value with sign and currency (e.g., "+$1.25" or "-$0.50").
      + +
      + formatCurrency() + +  : string +
      +
      Format a float as currency (e.g., "$150.25").
      + +
      + formatDate() + +  : string +
      +
      Format a Carbon date without time (e.g., "Jan 24, 2026").
      + +
      + formatDateTime() + +  : string +
      +
      Format a Carbon date with time (e.g., "Jan 24, 2026 3:45 PM").
      + +
      + formatGreek() + +  : string +
      +
      Format a Greek value (4 decimal places, e.g., "0.4520").
      + +
      + formatNumber() + +  : string +
      +
      Format a number with commas (e.g., "15,234").
      + +
      + formatPercent() + +  : string +
      +
      Format a percentage with sign (e.g., "+3.25%" or "-1.50%").
      + +
      + formatPercentRaw() + +  : string +
      +
      Format a percentage that is already in percent form (e.g., "32.50%").
      + +
      + formatVolume() + +  : string +
      +
      Format volume with K/M/B suffixes (e.g., "54.9M", "12.3K").
      + @@ -282,27 +361,27 @@

      phpdocumentor-element -property -public - " + " >

      $currency - +

      - public - string + public + string|null $currency @@ -310,7 +389,8 @@

      - + +
      phpdocumentor-element -property -public - " + " >

      $date - +

      - public - Carbon + public + Carbon $date @@ -346,7 +426,8 @@

      - + +

      phpdocumentor-element -property -public - " + " >

      $estimated_eps - +

      - public - float|null + public + float|null $estimated_eps @@ -382,7 +463,8 @@

      - + +

      phpdocumentor-element -property -public - " + " >

      $fiscal_quarter - +

      - public - int + public + int $fiscal_quarter @@ -418,7 +500,8 @@

      - + +

      phpdocumentor-element -property -public - " + " >

      $fiscal_year - +

      - public - int + public + int $fiscal_year @@ -454,7 +537,8 @@

      - + +

      phpdocumentor-element -property -public - " + " >

      $report_date - +

      - public - Carbon + public + Carbon $report_date @@ -490,7 +574,8 @@

      - + +

      phpdocumentor-element -property -public - " + " >

      $report_time - +

      - public - string + public + string $report_time @@ -526,7 +611,8 @@

      - + +

      phpdocumentor-element -property -public - " + " >

      $reported_eps - +

      - public - float|null + public + float|null $reported_eps @@ -562,7 +648,8 @@

      - + +

      phpdocumentor-element -property -public - " + " >

      $surprise_eps - +

      - public - float|null + public + float|null $surprise_eps @@ -598,7 +685,8 @@

      - + +

      phpdocumentor-element -property -public - " + " >

      $surprise_eps_pct - +

      - public - float|null + public + float|null $surprise_eps_pct @@ -634,7 +722,8 @@

      - + +

      phpdocumentor-element -property -public - " + " >

      $symbol - +

      - public - string + public + string $symbol @@ -670,7 +759,8 @@

      - + +

      phpdocumentor-element -property -public - " + " >

      $updated - +

      - public - Carbon + public + Carbon $updated @@ -706,7 +796,8 @@

      - + +

      @@ -731,7 +822,7 @@

      @@ -739,7 +830,7 @@

      public - __construct(string $symbol, int $fiscal_year, int $fiscal_quarter, Carbon $date, Carbon $report_date, string $report_time, string $currency, float|null $reported_eps, float|null $estimated_eps, float|null $surprise_eps, float|null $surprise_eps_pct, Carbon $updated) : mixed + __construct(string $symbol, int $fiscal_year, int $fiscal_quarter, Carbon $date, Carbon $report_date, string $report_time, string|null $currency, float|null $reported_eps, float|null $estimated_eps, float|null $surprise_eps, float|null $surprise_eps_pct, Carbon $updated) : mixed
      @@ -748,8 +839,8 @@

      Parameters
      - $symbol - : string + $symbol + : string

      The symbol of the stock.

      @@ -757,8 +848,8 @@
      Parameters
      - $fiscal_year - : int + $fiscal_year + : int

      The fiscal year of the earnings report. This may not always align with the @@ -767,8 +858,8 @@

      Parameters
      - $fiscal_quarter - : int + $fiscal_quarter + : int

      The fiscal quarter of the earnings report. This may not always align with @@ -777,8 +868,8 @@

      Parameters
      - $date - : Carbon + $date + : Carbon

      The last calendar day that corresponds to this earnings report.

      @@ -786,8 +877,8 @@
      Parameters
      - $report_date - : Carbon + $report_date + : Carbon

      The date the earnings report was released or is projected to be released.

      @@ -795,8 +886,8 @@
      Parameters
      - $report_time - : string + $report_time + : string

      The value will be either before market open, after market close, or during @@ -805,17 +896,17 @@

      Parameters
      - $currency - : string + $currency + : string|null
      -

      The currency of the earnings report.

      +

      The currency of the earnings report. May be null for future/estimated earnings reports.

      - $reported_eps - : float|null + $reported_eps + : float|null

      The earnings per share reported by the company. Earnings reported are @@ -824,8 +915,8 @@

      Parameters
      - $estimated_eps - : float|null + $estimated_eps + : float|null

      The average consensus estimate by Wall Street analysts.

      @@ -833,8 +924,8 @@
      Parameters
      - $surprise_eps - : float|null + $surprise_eps + : float|null

      The difference (in earnings per share) between the estimated earnings per @@ -843,8 +934,8 @@

      Parameters
      - $surprise_eps_pct - : float|null + $surprise_eps_pct + : float|null

      The difference in percentage terms between the estimated EPS and the @@ -853,8 +944,8 @@

      Parameters
      - $updated - : Carbon + $updated + : Carbon

      The date/time the earnings data for this ticker was last updated.

      @@ -865,9 +956,551 @@
      Parameters
      + + + + +
      +

      + __toString() + + +

      + + +

      Returns a string representation of the earnings data.

      + + + public + __toString() : string + +
      +
      + + + + + + + +
      +
      Return values
      + string + — +

      Human-readable earnings summary.

      +
      + +
      + +
      +
      +

      + formatChange() + + +

      + + +

      Format a change value with sign and currency (e.g., "+$1.25" or "-$0.50").

      + + + protected + formatChange(float|null $value) : string + +
      +
      + + +
      Parameters
      +
      +
      + $value + : float|null +
      +
      +

      The change value to format.

      +
      + +
      +
      + + + + +
      +
      Return values
      + string + — +

      Formatted change string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatCurrency() + + +

      + + +

      Format a float as currency (e.g., "$150.25").

      + + + protected + formatCurrency(float|null $value) : string +
      +
      + +
      Parameters
      +
      +
      + $value + : float|null +
      +
      +

      The value to format.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted currency string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatDate() + + +

      + + +

      Format a Carbon date without time (e.g., "Jan 24, 2026").

      + + + protected + formatDate(Carbon|null $date) : string + +
      +
      + + +
      Parameters
      +
      +
      + $date + : Carbon|null +
      +
      +

      The date to format.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted date string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatDateTime() + + +

      + + +

      Format a Carbon date with time (e.g., "Jan 24, 2026 3:45 PM").

      + + + protected + formatDateTime(Carbon|null $date) : string + +
      +
      + + +
      Parameters
      +
      +
      + $date + : Carbon|null +
      +
      +

      The date to format.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted date string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatGreek() + + +

      + + +

      Format a Greek value (4 decimal places, e.g., "0.4520").

      + + + protected + formatGreek(float|null $value) : string + +
      +
      + + +
      Parameters
      +
      +
      + $value + : float|null +
      +
      +

      The Greek value to format.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted Greek string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatNumber() + + +

      + + +

      Format a number with commas (e.g., "15,234").

      + + + protected + formatNumber(int|null $value) : string + +
      +
      + + +
      Parameters
      +
      +
      + $value + : int|null +
      +
      +

      The number to format.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted number string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatPercent() + + +

      + + +

      Format a percentage with sign (e.g., "+3.25%" or "-1.50%").

      + + + protected + formatPercent(float|null $value) : string + +
      +
      + +

      Assumes input is a decimal (0.30 = 30%).

      +
      + +
      Parameters
      +
      +
      + $value + : float|null +
      +
      +

      The decimal value to format as percentage.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted percentage string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatPercentRaw() + + +

      + + +

      Format a percentage that is already in percent form (e.g., "32.50%").

      + + + protected + formatPercentRaw(float|null $value) : string + +
      +
      + +

      Use this for values like implied volatility that are already percentages.

      +
      + +
      Parameters
      +
      +
      + $value + : float|null +
      +
      +

      The percentage value to format.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted percentage string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatVolume() + + +

      + + +

      Format volume with K/M/B suffixes (e.g., "54.9M", "12.3K").

      + + + protected + formatVolume(int|null $value) : string + +
      +
      + + +
      Parameters
      +
      +
      + $value + : int|null +
      +
      +

      The volume to format.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted volume string or "N/A" if null.

      +
      + +
      +
      @@ -907,6 +1540,8 @@
      Parameters
      if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } @@ -1001,6 +1636,16 @@
      Parameters
    • diff --git a/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-Earnings.html b/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-Earnings.html index f8ba2166..2ed169a1 100644 --- a/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-Earnings.html +++ b/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-Earnings.html @@ -80,6 +80,14 @@

    • Exceptions +
    • +
    • + Logging + +
    • +
    • + Retry +
    • Traits @@ -156,10 +164,8 @@

      - - - - + +

      Table of Contents @@ -180,6 +186,12 @@

      +
      + $_saved_filename + +  : string|null +
      +
      $earnings @@ -221,6 +233,13 @@

      Constructs a new Earnings object and parses the response data.
      +
      + __toString() + +  : string +
      +
      Returns a string representation of the earnings collection.
      +
      getCsv() @@ -256,6 +275,13 @@

      Check if the response is in JSON format.
      +
      + saveToFile() + +  : string +
      +
      Save CSV/HTML content to a file.
      +
      @@ -274,14 +300,53 @@

      phpdocumentor-element -property -public - " + " +> +

      + $_saved_filename + + + + +

      + + + + + + public + string|null + $_saved_filename + = null + + +

      The filename where the response was saved (if filename parameter was used).

      +
      + + + + + + + +

      $earnings - +

      phpdocumentor-element -property -public - " + " >

      $status - +

      phpdocumentor-element -property -protected - " + " >

      $csv - +

      phpdocumentor-element -property -protected - " + " >

      $html - +

      @@ -449,7 +518,7 @@

      public - __construct(object $response) : mixed + __construct(object $response) : mixed
      @@ -458,8 +527,8 @@

      Parameters
      - $response - : object + $response + : object

      The raw response object to be parsed.

      @@ -470,9 +539,52 @@
      Parameters
      + + + +
      +

      + __toString() + +

      + + +

      Returns a string representation of the earnings collection.

      + + + public + __toString() : string + +
      +
      + + + + + + +
      +
      Return values
      + string + — +

      Human-readable earnings summary.

      +
      + +
      +
      @@ -504,9 +616,26 @@

      +

      + Tags + + +
      +
      +
      + throws +
      +
      + InvalidArgumentException + +

      If the response is not in CSV format.

      +
      - +
      +
      + +
      Return values
      string @@ -531,7 +660,7 @@

      @@ -547,9 +676,26 @@

      +

      + Tags + + +
      +
      +
      + throws +
      +
      + InvalidArgumentException + +

      If the response is not in HTML format.

      +
      - +
      +
      + +
      Return values
      string @@ -574,7 +720,7 @@

      @@ -591,8 +737,8 @@

      + -
      Return values
      bool @@ -617,7 +763,7 @@

      @@ -634,8 +780,8 @@

      + -
      Return values
      bool @@ -660,7 +806,7 @@

      @@ -677,8 +823,8 @@

      + -
      Return values
      bool @@ -688,6 +834,88 @@
      Return values
      +

      +
      +

      + saveToFile() + + +

      + + +

      Save CSV/HTML content to a file.

      + + + public + saveToFile(string $filename) : string + +
      +
      + + +
      Parameters
      +
      +
      + $filename + : string +
      +
      +

      The file path to save to.

      +
      + +
      +
      + + +
      + Tags + + +
      +
      +
      + throws +
      +
      + InvalidArgumentException + +

      If filename is invalid (wrong extension, etc.).

      +
      + +
      +
      + throws +
      +
      + RuntimeException + +

      If file writing fails.

      +
      + +
      +
      + + + +
      +
      Return values
      + string + — +

      The absolute path of the saved file.

      +
      + +
      +
      @@ -727,6 +955,8 @@
      Return values
      if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } @@ -802,6 +1032,7 @@
      Return values
    • Properties
    • diff --git a/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-News.html b/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-News.html index 5dd87c1a..0835a998 100644 --- a/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-News.html +++ b/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-News.html @@ -80,6 +80,14 @@

    • Exceptions +
    • +
    • + Logging + +
    • +
    • + Retry +
    • Traits @@ -134,6 +142,9 @@

    • + + uses + FormatsForDisplay
      @@ -144,7 +155,7 @@

      @@ -156,10 +167,8 @@

      - - - - + +

      Table of Contents @@ -180,6 +189,12 @@

      +
      + $_saved_filename + +  : string|null +
      +
      $content @@ -197,7 +212,7 @@

      $publication_date -  : Carbon +  : Carbon|null
      The date the news was published on the source website.
      @@ -249,6 +264,13 @@

      Constructs a new News object and parses the response data.
      +
      + __toString() + +  : string +
      +
      Returns a string representation of the news article.
      +
      getCsv() @@ -284,6 +306,76 @@

      Check if the response is in JSON format.
      +
      + saveToFile() + +  : string +
      +
      Save CSV/HTML content to a file.
      + +
      + formatChange() + +  : string +
      +
      Format a change value with sign and currency (e.g., "+$1.25" or "-$0.50").
      + +
      + formatCurrency() + +  : string +
      +
      Format a float as currency (e.g., "$150.25").
      + +
      + formatDate() + +  : string +
      +
      Format a Carbon date without time (e.g., "Jan 24, 2026").
      + +
      + formatDateTime() + +  : string +
      +
      Format a Carbon date with time (e.g., "Jan 24, 2026 3:45 PM").
      + +
      + formatGreek() + +  : string +
      +
      Format a Greek value (4 decimal places, e.g., "0.4520").
      + +
      + formatNumber() + +  : string +
      +
      Format a number with commas (e.g., "15,234").
      + +
      + formatPercent() + +  : string +
      +
      Format a percentage with sign (e.g., "+3.25%" or "-1.50%").
      + +
      + formatPercentRaw() + +  : string +
      +
      Format a percentage that is already in percent form (e.g., "32.50%").
      + +
      + formatVolume() + +  : string +
      +
      Format volume with K/M/B suffixes (e.g., "54.9M", "12.3K").
      +
      @@ -302,19 +394,58 @@

      phpdocumentor-element -property -public - " + " +> +

      + $_saved_filename + + + + +

      + + + + + + public + string|null + $_saved_filename + = null + + +

      The filename where the response was saved (if filename parameter was used).

      +
      + + + + + + + +

      $content - +

      @@ -322,10 +453,10 @@

      - public - string + public + string $content - + = ''

      TIP: Please be aware that this may or may not include the full content of the news article. Additionally, it may include captions of images, copyright notices, syndication information, and other elements that may not be @@ -335,7 +466,8 @@

      - + +

      phpdocumentor-element -property -public - " + " >

      $headline - +

      @@ -363,16 +495,17 @@

      - public - string + public + string $headline - + = '' - + +

      phpdocumentor-element -property -public - " + " >

      $publication_date - +

      @@ -400,16 +533,17 @@

      - public - Carbon + public + Carbon|null $publication_date - + = null - + +

      phpdocumentor-element -property -public - " + " >

      $source - +

      @@ -437,16 +571,17 @@

      - public - string + public + string $source - + = '' - + +

      phpdocumentor-element -property -public - " + " >

      $status - +

      @@ -474,16 +609,17 @@

      - public - string + public + string $status - + = 'no_data' - + +

      phpdocumentor-element -property -public - " + " >

      $symbol - +

      @@ -511,16 +647,17 @@

      - public - string + public + string $symbol - + = '' - + +

      phpdocumentor-element -property -protected - " + " >

      $csv - +

      phpdocumentor-element -property -protected - " + " >

      $html - +

      @@ -621,7 +760,7 @@

      @@ -629,7 +768,7 @@

      public - __construct(object $response) : mixed + __construct(object $response) : mixed
      @@ -638,8 +777,8 @@

      Parameters
      - $response - : object + $response + : object

      The raw response object to be parsed.

      @@ -650,9 +789,52 @@
      Parameters
      + + + + +
      +

      + __toString() + + +

      + + +

      Returns a string representation of the news article.

      + + + public + __toString() : string + +
      +
      + + + + +
      +
      Return values
      + string + — +

      Human-readable news summary.

      +
      + +
      +
      @@ -684,9 +866,26 @@

      +

      + Tags + - +
      +
      +
      + throws +
      +
      + InvalidArgumentException + +

      If the response is not in CSV format.

      +
      + +
      +
      + +
      Return values
      string @@ -711,7 +910,7 @@

      @@ -727,9 +926,26 @@

      +

      + Tags + - +
      +
      +
      + throws +
      +
      + InvalidArgumentException + +

      If the response is not in HTML format.

      +
      +
      +
      + + +
      Return values
      string @@ -754,7 +970,7 @@

      @@ -771,8 +987,8 @@

      + -
      Return values
      bool @@ -797,7 +1013,7 @@

      @@ -814,8 +1030,8 @@

      + -
      Return values
      bool @@ -840,7 +1056,7 @@

      @@ -857,8 +1073,8 @@

      + -
      Return values
      bool @@ -868,6 +1084,587 @@
      Return values
      +

      +
      +

      + saveToFile() + + +

      + + +

      Save CSV/HTML content to a file.

      + + + public + saveToFile(string $filename) : string + +
      +
      + + +
      Parameters
      +
      +
      + $filename + : string +
      +
      +

      The file path to save to.

      +
      + +
      +
      + + +
      + Tags + + +
      +
      +
      + throws +
      +
      + InvalidArgumentException + +

      If filename is invalid (wrong extension, etc.).

      +
      + +
      +
      + throws +
      +
      + RuntimeException + +

      If file writing fails.

      +
      + +
      +
      + + + +
      +
      Return values
      + string + — +

      The absolute path of the saved file.

      +
      + +
      + +
      +
      +

      + formatChange() + + +

      + + +

      Format a change value with sign and currency (e.g., "+$1.25" or "-$0.50").

      + + + protected + formatChange(float|null $value) : string + +
      +
      + + +
      Parameters
      +
      +
      + $value + : float|null +
      +
      +

      The change value to format.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted change string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatCurrency() + + +

      + + +

      Format a float as currency (e.g., "$150.25").

      + + + protected + formatCurrency(float|null $value) : string + +
      +
      + + +
      Parameters
      +
      +
      + $value + : float|null +
      +
      +

      The value to format.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted currency string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatDate() + + +

      + + +

      Format a Carbon date without time (e.g., "Jan 24, 2026").

      + + + protected + formatDate(Carbon|null $date) : string + +
      +
      + + +
      Parameters
      +
      +
      + $date + : Carbon|null +
      +
      +

      The date to format.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted date string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatDateTime() + + +

      + + +

      Format a Carbon date with time (e.g., "Jan 24, 2026 3:45 PM").

      + + + protected + formatDateTime(Carbon|null $date) : string + +
      +
      + + +
      Parameters
      +
      +
      + $date + : Carbon|null +
      +
      +

      The date to format.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted date string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatGreek() + + +

      + + +

      Format a Greek value (4 decimal places, e.g., "0.4520").

      + + + protected + formatGreek(float|null $value) : string + +
      +
      + + +
      Parameters
      +
      +
      + $value + : float|null +
      +
      +

      The Greek value to format.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted Greek string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatNumber() + + +

      + + +

      Format a number with commas (e.g., "15,234").

      + + + protected + formatNumber(int|null $value) : string + +
      +
      + + +
      Parameters
      +
      +
      + $value + : int|null +
      +
      +

      The number to format.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted number string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatPercent() + + +

      + + +

      Format a percentage with sign (e.g., "+3.25%" or "-1.50%").

      + + + protected + formatPercent(float|null $value) : string + +
      +
      + +

      Assumes input is a decimal (0.30 = 30%).

      +
      + +
      Parameters
      +
      +
      + $value + : float|null +
      +
      +

      The decimal value to format as percentage.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted percentage string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatPercentRaw() + + +

      + + +

      Format a percentage that is already in percent form (e.g., "32.50%").

      + + + protected + formatPercentRaw(float|null $value) : string + +
      +
      + +

      Use this for values like implied volatility that are already percentages.

      +
      + +
      Parameters
      +
      +
      + $value + : float|null +
      +
      +

      The percentage value to format.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted percentage string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatVolume() + + +

      + + +

      Format volume with K/M/B suffixes (e.g., "54.9M", "12.3K").

      + + + protected + formatVolume(int|null $value) : string + +
      +
      + + +
      Parameters
      +
      +
      + $value + : int|null +
      +
      +

      The volume to format.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted volume string or "N/A" if null.

      +
      + +
      +
      @@ -907,6 +1704,8 @@
      Return values
      if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } @@ -982,6 +1781,7 @@
      Return values
    • Properties
    • diff --git a/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-Prices.html b/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-Prices.html new file mode 100644 index 00000000..1c034d9d --- /dev/null +++ b/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-Prices.html @@ -0,0 +1,1848 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
      +

      + MarketData SDK +

      + + + + + +
      + +
      +
      + + + + +
      +
      + + +
      +

      + Prices + + + extends ResponseBase + + +
      + in package + +
      + + + + uses + FormatsForDisplay +

      + +
      + + +
      + + + +

      Class Prices

      + + +

      Represents stock prices and handles the response parsing for stock prices data. +This endpoint returns real-time midpoint prices for one or more stocks using the SmartMid model.

      +
      + + + + + +

      + Table of Contents + + +

      + + + + + + + + + +

      + Properties + + +

      +
      +
      + $_saved_filename + +  : string|null +
      + +
      + $change + +  : array<string|int, mixed> +
      +
      Array of price changes in currency units compared to the closing price of the previous primary trading session.
      + +
      + $changepct + +  : array<string|int, mixed> +
      +
      Array of price changes in percent, expressed as a decimal, compared to the closing price of the previous day.
      + +
      + $mid + +  : array<string|int, mixed> +
      +
      Array of midpoint prices, as calculated by the SmartMid model.
      + +
      + $status + +  : string +
      +
      The status of the response. Will be "ok" when there is data, "no_data" when no prices can be found, +or "error" if the request produces an error response.
      + +
      + $symbols + +  : array<string|int, mixed> +
      +
      Array of ticker symbols that were requested.
      + +
      + $updated + +  : array<string|int, mixed> +
      +
      Array of date/times for each stock price.
      + +
      + $csv + +  : string +
      + +
      + $html + +  : string +
      + +
      + +

      + Methods + + +

      +
      +
      + __construct() + +  : mixed +
      +
      Constructs a new Prices object and parses the response data.
      + +
      + __toString() + +  : string +
      +
      Returns a string representation of the prices collection.
      + +
      + getCsv() + +  : string +
      +
      Get the CSV content of the response.
      + +
      + getHtml() + +  : string +
      +
      Get the HTML content of the response.
      + +
      + isCsv() + +  : bool +
      +
      Check if the response is in CSV format.
      + +
      + isHtml() + +  : bool +
      +
      Check if the response is in HTML format.
      + +
      + isJson() + +  : bool +
      +
      Check if the response is in JSON format.
      + +
      + saveToFile() + +  : string +
      +
      Save CSV/HTML content to a file.
      + +
      + formatChange() + +  : string +
      +
      Format a change value with sign and currency (e.g., "+$1.25" or "-$0.50").
      + +
      + formatCurrency() + +  : string +
      +
      Format a float as currency (e.g., "$150.25").
      + +
      + formatDate() + +  : string +
      +
      Format a Carbon date without time (e.g., "Jan 24, 2026").
      + +
      + formatDateTime() + +  : string +
      +
      Format a Carbon date with time (e.g., "Jan 24, 2026 3:45 PM").
      + +
      + formatGreek() + +  : string +
      +
      Format a Greek value (4 decimal places, e.g., "0.4520").
      + +
      + formatNumber() + +  : string +
      +
      Format a number with commas (e.g., "15,234").
      + +
      + formatPercent() + +  : string +
      +
      Format a percentage with sign (e.g., "+3.25%" or "-1.50%").
      + +
      + formatPercentRaw() + +  : string +
      +
      Format a percentage that is already in percent form (e.g., "32.50%").
      + +
      + formatVolume() + +  : string +
      +
      Format volume with K/M/B suffixes (e.g., "54.9M", "12.3K").
      + +
      + + + + + + +
      +

      + Properties + + +

      +
      +

      + $_saved_filename + + + + +

      + + + + + + public + string|null + $_saved_filename + = null + + +

      The filename where the response was saved (if filename parameter was used).

      +
      + + + + + + +
      +
      +

      + $change + + + + +

      + + +

      Array of price changes in currency units compared to the closing price of the previous primary trading session.

      + + + + public + array<string|int, mixed> + $change + = [] + + + + + + + + +
      +
      +

      + $changepct + + + + +

      + + +

      Array of price changes in percent, expressed as a decimal, compared to the closing price of the previous day.

      + + + + public + array<string|int, mixed> + $changepct + = [] + +

      For example, a 3% change will be represented as 0.03.

      +
      + + + + + + + +
      +
      +

      + $mid + + + + +

      + + +

      Array of midpoint prices, as calculated by the SmartMid model.

      + + + + public + array<string|int, mixed> + $mid + = [] + + + + + + + + +
      +
      +

      + $status + + + + +

      + + +

      The status of the response. Will be "ok" when there is data, "no_data" when no prices can be found, +or "error" if the request produces an error response.

      + + + + public + string + $status + = 'no_data' + + + + + + + + +
      +
      +

      + $symbols + + + + +

      + + +

      Array of ticker symbols that were requested.

      + + + + public + array<string|int, mixed> + $symbols + = [] + + + + + + + + +
      +
      +

      + $updated + + + + +

      + + +

      Array of date/times for each stock price.

      + + + + public + array<string|int, mixed> + $updated + = [] + + + + + + + + +
      +
      +

      + $csv + + + + +

      + + + + + + protected + string + $csv + + + +

      The CSV content of the response.

      +
      + + + + + + +
      +
      +

      + $html + + + + +

      + + + + + + protected + string + $html + + + +

      The HTML content of the response.

      +
      + + + + + + +
      +
      + +
      +

      + Methods + + +

      +
      +

      + __construct() + + +

      + + +

      Constructs a new Prices object and parses the response data.

      + + + public + __construct(object $response) : mixed + +
      +
      + + +
      Parameters
      +
      +
      + $response + : object +
      +
      +

      The raw response object to be parsed.

      +
      + +
      +
      + + + + + + +
      +
      +

      + __toString() + + +

      + + +

      Returns a string representation of the prices collection.

      + + + public + __toString() : string + +
      +
      + + + + + + + +
      +
      Return values
      + string + — +

      Human-readable prices summary.

      +
      + +
      + +
      +
      +

      + getCsv() + + +

      + + +

      Get the CSV content of the response.

      + + + public + getCsv() : string + +
      +
      + + + + +
      + Tags + + +
      +
      +
      + throws +
      +
      + InvalidArgumentException + +

      If the response is not in CSV format.

      +
      + +
      +
      + + + +
      +
      Return values
      + string + — +

      The CSV content.

      +
      + +
      + +
      +
      +

      + getHtml() + + +

      + + +

      Get the HTML content of the response.

      + + + public + getHtml() : string + +
      +
      + + + + +
      + Tags + + +
      +
      +
      + throws +
      +
      + InvalidArgumentException + +

      If the response is not in HTML format.

      +
      + +
      +
      + + + +
      +
      Return values
      + string + — +

      The HTML content.

      +
      + +
      + +
      +
      +

      + isCsv() + + +

      + + +

      Check if the response is in CSV format.

      + + + public + isCsv() : bool + +
      +
      + + + + + + + +
      +
      Return values
      + bool + — +

      True if the response is in CSV format, false otherwise.

      +
      + +
      + +
      +
      +

      + isHtml() + + +

      + + +

      Check if the response is in HTML format.

      + + + public + isHtml() : bool + +
      +
      + + + + + + + +
      +
      Return values
      + bool + — +

      True if the response is in HTML format, false otherwise.

      +
      + +
      + +
      +
      +

      + isJson() + + +

      + + +

      Check if the response is in JSON format.

      + + + public + isJson() : bool + +
      +
      + + + + + + + +
      +
      Return values
      + bool + — +

      True if the response is in JSON format, false otherwise.

      +
      + +
      + +
      +
      +

      + saveToFile() + + +

      + + +

      Save CSV/HTML content to a file.

      + + + public + saveToFile(string $filename) : string + +
      +
      + + +
      Parameters
      +
      +
      + $filename + : string +
      +
      +

      The file path to save to.

      +
      + +
      +
      + + +
      + Tags + + +
      +
      +
      + throws +
      +
      + InvalidArgumentException + +

      If filename is invalid (wrong extension, etc.).

      +
      + +
      +
      + throws +
      +
      + RuntimeException + +

      If file writing fails.

      +
      + +
      +
      + + + +
      +
      Return values
      + string + — +

      The absolute path of the saved file.

      +
      + +
      + +
      +
      +

      + formatChange() + + +

      + + +

      Format a change value with sign and currency (e.g., "+$1.25" or "-$0.50").

      + + + protected + formatChange(float|null $value) : string + +
      +
      + + +
      Parameters
      +
      +
      + $value + : float|null +
      +
      +

      The change value to format.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted change string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatCurrency() + + +

      + + +

      Format a float as currency (e.g., "$150.25").

      + + + protected + formatCurrency(float|null $value) : string + +
      +
      + + +
      Parameters
      +
      +
      + $value + : float|null +
      +
      +

      The value to format.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted currency string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatDate() + + +

      + + +

      Format a Carbon date without time (e.g., "Jan 24, 2026").

      + + + protected + formatDate(Carbon|null $date) : string + +
      +
      + + +
      Parameters
      +
      +
      + $date + : Carbon|null +
      +
      +

      The date to format.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted date string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatDateTime() + + +

      + + +

      Format a Carbon date with time (e.g., "Jan 24, 2026 3:45 PM").

      + + + protected + formatDateTime(Carbon|null $date) : string + +
      +
      + + +
      Parameters
      +
      +
      + $date + : Carbon|null +
      +
      +

      The date to format.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted date string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatGreek() + + +

      + + +

      Format a Greek value (4 decimal places, e.g., "0.4520").

      + + + protected + formatGreek(float|null $value) : string + +
      +
      + + +
      Parameters
      +
      +
      + $value + : float|null +
      +
      +

      The Greek value to format.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted Greek string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatNumber() + + +

      + + +

      Format a number with commas (e.g., "15,234").

      + + + protected + formatNumber(int|null $value) : string + +
      +
      + + +
      Parameters
      +
      +
      + $value + : int|null +
      +
      +

      The number to format.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted number string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatPercent() + + +

      + + +

      Format a percentage with sign (e.g., "+3.25%" or "-1.50%").

      + + + protected + formatPercent(float|null $value) : string + +
      +
      + +

      Assumes input is a decimal (0.30 = 30%).

      +
      + +
      Parameters
      +
      +
      + $value + : float|null +
      +
      +

      The decimal value to format as percentage.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted percentage string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatPercentRaw() + + +

      + + +

      Format a percentage that is already in percent form (e.g., "32.50%").

      + + + protected + formatPercentRaw(float|null $value) : string + +
      +
      + +

      Use this for values like implied volatility that are already percentages.

      +
      + +
      Parameters
      +
      +
      + $value + : float|null +
      +
      +

      The percentage value to format.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted percentage string or "N/A" if null.

      +
      + +
      + +
      +
      +

      + formatVolume() + + +

      + + +

      Format volume with K/M/B suffixes (e.g., "54.9M", "12.3K").

      + + + protected + formatVolume(int|null $value) : string + +
      +
      + + +
      Parameters
      +
      +
      + $value + : int|null +
      +
      +

      The volume to format.

      +
      + +
      +
      + + + + + +
      +
      Return values
      + string + — +

      Formatted volume string or "N/A" if null.

      +
      + +
      + +
      +
      + +
      +
      +
      +
      +
      
      +        
      + +
      +
      + + + +
      +
      +
      + +
      + On this page + + +
      + +
      +
      +
      +
      +
      +

      Search results

      + +
      +
      +
        +
        +
        +
        +
        + + +
        + + + + + + + + diff --git a/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-Quote.html b/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-Quote.html index 92562ee2..28842960 100644 --- a/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-Quote.html +++ b/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-Quote.html @@ -80,6 +80,14 @@

      • Exceptions +
      • +
      • + Logging + +
      • +
      • + Retry +
      • Traits @@ -134,6 +142,9 @@

      • + + uses + FormatsForDisplay
        @@ -144,7 +155,7 @@

        @@ -156,10 +167,8 @@

        - - - - + +

        Table of Contents @@ -180,31 +189,37 @@

        +
        + $_saved_filename + +  : string|null +
        +
        $ask -  : float +  : float|null
        The ask price of the stock.
        $ask_size -  : int +  : int|null
        The number of shares offered at the ask price.
        $bid -  : float +  : float|null
        The bid price.
        $bid_size -  : int +  : int|null
        The number of shares that may be sold at the bid price.
        @@ -242,14 +257,14 @@

        $last -  : float +  : float|null
        The last price the stock traded at.
        $mid -  : float +  : float|null
        The midpoint price between the ask and the bid.
        @@ -270,14 +285,14 @@

        $updated -  : Carbon +  : Carbon|null
        The date/time of the current stock quote.
        $volume -  : int +  : int|null
        The number of shares traded during the current session.
        @@ -308,6 +323,13 @@

        Constructs a new Quote object and parses the response data.
        +
        + __toString() + +  : string +
        +
        Returns a string representation of the quote.
        +
        getCsv() @@ -343,6 +365,76 @@

        Check if the response is in JSON format.
        +
        + saveToFile() + +  : string +
        +
        Save CSV/HTML content to a file.
        + +
        + formatChange() + +  : string +
        +
        Format a change value with sign and currency (e.g., "+$1.25" or "-$0.50").
        + +
        + formatCurrency() + +  : string +
        +
        Format a float as currency (e.g., "$150.25").
        + +
        + formatDate() + +  : string +
        +
        Format a Carbon date without time (e.g., "Jan 24, 2026").
        + +
        + formatDateTime() + +  : string +
        +
        Format a Carbon date with time (e.g., "Jan 24, 2026 3:45 PM").
        + +
        + formatGreek() + +  : string +
        +
        Format a Greek value (4 decimal places, e.g., "0.4520").
        + +
        + formatNumber() + +  : string +
        +
        Format a number with commas (e.g., "15,234").
        + +
        + formatPercent() + +  : string +
        +
        Format a percentage with sign (e.g., "+3.25%" or "-1.50%").
        + +
        + formatPercentRaw() + +  : string +
        +
        Format a percentage that is already in percent form (e.g., "32.50%").
        + +
        + formatVolume() + +  : string +
        +
        Format volume with K/M/B suffixes (e.g., "54.9M", "12.3K").
        +

        @@ -361,19 +453,58 @@

        phpdocumentor-element -property -public - " + " +> +

        + $_saved_filename + + + + +

        + + + + + + public + string|null + $_saved_filename + = null + + +

        The filename where the response was saved (if filename parameter was used).

        +
        + + + + + + + +

        $ask - +

        @@ -381,16 +512,17 @@

        - public - float + public + float|null $ask - + = null - + +

        phpdocumentor-element -property -public - " + " >

        $ask_size - +

        @@ -418,16 +550,17 @@

        - public - int + public + int|null $ask_size - + = null - + +

        phpdocumentor-element -property -public - " + " >

        $bid - +

        @@ -455,16 +588,17 @@

        - public - float + public + float|null $bid - + = null - + +

        phpdocumentor-element -property -public - " + " >

        $bid_size - +

        @@ -492,16 +626,17 @@

        - public - int + public + int|null $bid_size - + = null - + +

        phpdocumentor-element -property -public - " + " >

        $change - +

        @@ -530,16 +665,17 @@

        - public - float|null + public + float|null $change - + = null - + +

        phpdocumentor-element -property -public - " + " >

        $change_percent - +

        @@ -567,10 +703,10 @@

        - public - float|null + public + float|null $change_percent - + = null

        For example, a 30% change will be represented as 0.30.

        @@ -578,7 +714,8 @@

        - + +

        phpdocumentor-element -property -public - " + " >

        $fifty_two_week_high - +

        @@ -607,8 +744,8 @@

        - public - float|null + public + float|null $fifty_two_week_high = null @@ -616,7 +753,8 @@

        - + +

        phpdocumentor-element -property -public - " + " >

        $fifty_two_week_low - +

        @@ -645,8 +783,8 @@

        - public - float|null + public + float|null $fifty_two_week_low = null @@ -654,7 +792,8 @@

        - + +

        phpdocumentor-element -property -public - " + " >

        $last - +

        @@ -682,16 +821,17 @@

        - public - float + public + float|null $last - + = null - + +

        phpdocumentor-element -property -public - " + " >

        $mid - +

        @@ -719,16 +859,17 @@

        - public - float + public + float|null $mid - + = null - + +

        phpdocumentor-element -property -public - " + " >

        $status - +

        @@ -756,16 +897,17 @@

        - public - string + public + string $status - + = 'no_data' - + +

        phpdocumentor-element -property -public - " + " >

        $symbol - +

        @@ -793,16 +935,17 @@

        - public - string + public + string $symbol - + = '' - + +

        phpdocumentor-element -property -public - " + " >

        $updated - +

        @@ -830,16 +973,17 @@

        - public - Carbon + public + Carbon|null $updated - + = null - + +

        phpdocumentor-element -property -public - " + " >

        $volume - +

        @@ -867,16 +1011,17 @@

        - public - int + public + int|null $volume - + = null - + +

        phpdocumentor-element -property -protected - " + " >

        $csv - +

        phpdocumentor-element -property -protected - " + " >

        $html - +

        @@ -977,7 +1124,7 @@

        @@ -985,7 +1132,7 @@

        public - __construct(object $response) : mixed + __construct(object $response) : mixed
        @@ -994,8 +1141,8 @@

        Parameters
        - $response - : object + $response + : object

        The raw response object to be parsed.

        @@ -1006,9 +1153,52 @@
        Parameters
        + + + + +
        +

        + __toString() + + +

        + + +

        Returns a string representation of the quote.

        + + + public + __toString() : string + +
        +
        + + + + +
        +
        Return values
        + string + — +

        Human-readable quote data.

        +
        + +
        +
        @@ -1040,9 +1230,26 @@

        +

        + Tags + - +
        +
        +
        + throws +
        +
        + InvalidArgumentException + +

        If the response is not in CSV format.

        +
        +
        +
        + + +
        Return values
        string @@ -1067,7 +1274,7 @@

        @@ -1083,9 +1290,26 @@

        +

        + Tags + - +
        +
        +
        + throws +
        +
        + InvalidArgumentException + +

        If the response is not in HTML format.

        +
        + +
        +
        + +
        Return values
        string @@ -1110,7 +1334,7 @@

        @@ -1127,8 +1351,8 @@

        + -
        Return values
        bool @@ -1153,7 +1377,7 @@

        @@ -1170,8 +1394,8 @@

        + -
        Return values
        bool @@ -1196,7 +1420,7 @@

        @@ -1213,8 +1437,8 @@

        + -
        Return values
        bool @@ -1224,6 +1448,587 @@
        Return values
        +

        +
        +

        + saveToFile() + + +

        + + +

        Save CSV/HTML content to a file.

        + + + public + saveToFile(string $filename) : string + +
        +
        + + +
        Parameters
        +
        +
        + $filename + : string +
        +
        +

        The file path to save to.

        +
        + +
        +
        + + +
        + Tags + + +
        +
        +
        + throws +
        +
        + InvalidArgumentException + +

        If filename is invalid (wrong extension, etc.).

        +
        + +
        +
        + throws +
        +
        + RuntimeException + +

        If file writing fails.

        +
        + +
        +
        + + + +
        +
        Return values
        + string + — +

        The absolute path of the saved file.

        +
        + +
        + +
        +
        +

        + formatChange() + + +

        + + +

        Format a change value with sign and currency (e.g., "+$1.25" or "-$0.50").

        + + + protected + formatChange(float|null $value) : string + +
        +
        + + +
        Parameters
        +
        +
        + $value + : float|null +
        +
        +

        The change value to format.

        +
        + +
        +
        + + + + + +
        +
        Return values
        + string + — +

        Formatted change string or "N/A" if null.

        +
        + +
        + +
        +
        +

        + formatCurrency() + + +

        + + +

        Format a float as currency (e.g., "$150.25").

        + + + protected + formatCurrency(float|null $value) : string + +
        +
        + + +
        Parameters
        +
        +
        + $value + : float|null +
        +
        +

        The value to format.

        +
        + +
        +
        + + + + + +
        +
        Return values
        + string + — +

        Formatted currency string or "N/A" if null.

        +
        + +
        + +
        +
        +

        + formatDate() + + +

        + + +

        Format a Carbon date without time (e.g., "Jan 24, 2026").

        + + + protected + formatDate(Carbon|null $date) : string + +
        +
        + + +
        Parameters
        +
        +
        + $date + : Carbon|null +
        +
        +

        The date to format.

        +
        + +
        +
        + + + + + +
        +
        Return values
        + string + — +

        Formatted date string or "N/A" if null.

        +
        + +
        + +
        +
        +

        + formatDateTime() + + +

        + + +

        Format a Carbon date with time (e.g., "Jan 24, 2026 3:45 PM").

        + + + protected + formatDateTime(Carbon|null $date) : string + +
        +
        + + +
        Parameters
        +
        +
        + $date + : Carbon|null +
        +
        +

        The date to format.

        +
        + +
        +
        + + + + + +
        +
        Return values
        + string + — +

        Formatted date string or "N/A" if null.

        +
        + +
        + +
        +
        +

        + formatGreek() + + +

        + + +

        Format a Greek value (4 decimal places, e.g., "0.4520").

        + + + protected + formatGreek(float|null $value) : string + +
        +
        + + +
        Parameters
        +
        +
        + $value + : float|null +
        +
        +

        The Greek value to format.

        +
        + +
        +
        + + + + + +
        +
        Return values
        + string + — +

        Formatted Greek string or "N/A" if null.

        +
        + +
        + +
        +
        +

        + formatNumber() + + +

        + + +

        Format a number with commas (e.g., "15,234").

        + + + protected + formatNumber(int|null $value) : string + +
        +
        + + +
        Parameters
        +
        +
        + $value + : int|null +
        +
        +

        The number to format.

        +
        + +
        +
        + + + + + +
        +
        Return values
        + string + — +

        Formatted number string or "N/A" if null.

        +
        + +
        + +
        +
        +

        + formatPercent() + + +

        + + +

        Format a percentage with sign (e.g., "+3.25%" or "-1.50%").

        + + + protected + formatPercent(float|null $value) : string + +
        +
        + +

        Assumes input is a decimal (0.30 = 30%).

        +
        + +
        Parameters
        +
        +
        + $value + : float|null +
        +
        +

        The decimal value to format as percentage.

        +
        + +
        +
        + + + + + +
        +
        Return values
        + string + — +

        Formatted percentage string or "N/A" if null.

        +
        + +
        + +
        +
        +

        + formatPercentRaw() + + +

        + + +

        Format a percentage that is already in percent form (e.g., "32.50%").

        + + + protected + formatPercentRaw(float|null $value) : string + +
        +
        + +

        Use this for values like implied volatility that are already percentages.

        +
        + +
        Parameters
        +
        +
        + $value + : float|null +
        +
        +

        The percentage value to format.

        +
        + +
        +
        + + + + + +
        +
        Return values
        + string + — +

        Formatted percentage string or "N/A" if null.

        +
        + +
        + +
        +
        +

        + formatVolume() + + +

        + + +

        Format volume with K/M/B suffixes (e.g., "54.9M", "12.3K").

        + + + protected + formatVolume(int|null $value) : string + +
        +
        + + +
        Parameters
        +
        +
        + $value + : int|null +
        +
        +

        The volume to format.

        +
        + +
        +
        + + + + + +
        +
        Return values
        + string + — +

        Formatted volume string or "N/A" if null.

        +
        + +
        +
        @@ -1263,6 +2068,8 @@
        Return values
        if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } @@ -1338,6 +2145,7 @@
        Return values
      • Properties
      • diff --git a/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-Quotes.html b/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-Quotes.html index e3836cc3..4fde6e77 100644 --- a/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-Quotes.html +++ b/docs/classes/MarketDataApp-Endpoints-Responses-Stocks-Quotes.html @@ -80,6 +80,14 @@

      • Exceptions +
      • +
      • + Logging + +
      • +
      • + Retry +
      • Traits @@ -122,6 +130,9 @@

        Fil

        Quotes + + extends ResponseBase +
        in package @@ -141,7 +152,7 @@

        @@ -151,10 +162,8 @@

        - - - - + +

        Table of Contents @@ -175,6 +184,12 @@

        +
        + $_saved_filename + +  : string|null +
        +
        $quotes @@ -182,6 +197,18 @@

        Array of Quote objects.
        +
        + $csv + +  : string +
        + +
        + $html + +  : string +
        +

        @@ -197,6 +224,62 @@

        Quotes constructor.
        +
        + __toString() + +  : string +
        +
        Returns a string representation of the quotes collection.
        + +
        + getCsv() + +  : string +
        +
        Get the CSV content of the response.
        + +
        + getHtml() + +  : string +
        +
        Get the HTML content of the response.
        + +
        + isCsv() + +  : bool +
        +
        Check if the response is in CSV format.
        + +
        + isHtml() + +  : bool +
        +
        Check if the response is in HTML format.
        + +
        + isJson() + +  : bool +
        +
        Check if the response is in JSON format.
        + +
        + saveToFile() + +  : string +
        +
        Save CSV/HTML content to a file.
        + +
        + extractQuoteAtIndex() + +  : object +
        +
        Extract quote data at a specific index from the multi-symbol response.
        +

      • @@ -215,19 +298,58 @@

        phpdocumentor-element -property -public - " + " +> +

        + $_saved_filename + + + + +

        + + + + + + public + string|null + $_saved_filename + = null + + +

        The filename where the response was saved (if filename parameter was used).

        +
        + + + + + + + +

        $quotes - +

        @@ -235,8 +357,8 @@

        - public - array<string|int, Quote> + public + array<string|int, Quote> $quotes @@ -244,8 +366,87 @@

        + + + +

        +
        +

        + $csv + + + + +

        + + + + + + protected + string + $csv + + + +

        The CSV content of the response.

        +
        + + + + +
        +
        +

        + $html + + + + +

        + + + + + + protected + string + $html + + + +

        The HTML content of the response.

        +
        + + + + + +
        @@ -269,7 +470,7 @@

        @@ -277,7 +478,349 @@

        public - __construct(array<string|int, mixed> $quotes) : mixed + __construct(object $response) : mixed + +
        +
        + +

        Parses a multi-symbol quote response where each field contains an array of values, +one per symbol. Creates individual Quote objects for each symbol.

        +
        + +

        Parameters
        +
        +
        + $response + : object +
        +
        +

        The raw API response object containing arrays for each field.

        +
        + +
        +
        + + + + + + + +
        +

        + __toString() + + +

        + + +

        Returns a string representation of the quotes collection.

        + + + public + __toString() : string + +
        +
        + + + + + + + +
        +
        Return values
        + string + — +

        Human-readable quotes summary.

        +
        + +
        + +
        +
        +

        + getCsv() + + +

        + + +

        Get the CSV content of the response.

        + + + public + getCsv() : string + +
        +
        + + + + +
        + Tags + + +
        +
        +
        + throws +
        +
        + InvalidArgumentException + +

        If the response is not in CSV format.

        +
        + +
        +
        + + + +
        +
        Return values
        + string + — +

        The CSV content.

        +
        + +
        + +
        +
        +

        + getHtml() + + +

        + + +

        Get the HTML content of the response.

        + + + public + getHtml() : string + +
        +
        + + + + +
        + Tags + + +
        +
        +
        + throws +
        +
        + InvalidArgumentException + +

        If the response is not in HTML format.

        +
        + +
        +
        + + + +
        +
        Return values
        + string + — +

        The HTML content.

        +
        + +
        + +
        +
        +

        + isCsv() + + +

        + + +

        Check if the response is in CSV format.

        + + + public + isCsv() : bool + +
        +
        + + + + + + + +
        +
        Return values
        + bool + — +

        True if the response is in CSV format, false otherwise.

        +
        + +
        + +
        +
        +

        + isHtml() + + +

        + + +

        Check if the response is in HTML format.

        + + + public + isHtml() : bool + +
        +
        + + + + + + + +
        +
        Return values
        + bool + — +

        True if the response is in HTML format, false otherwise.

        +
        + +
        + +
        +
        +

        + isJson() + + +

        + + +

        Check if the response is in JSON format.

        + + + public + isJson() : bool + +
        +
        + + + + + + + +
        +
        Return values
        + bool + — +

        True if the response is in JSON format, false otherwise.

        +
        + +
        + +
        +
        +

        + saveToFile() + + +

        + + +

        Save CSV/HTML content to a file.

        + + + public + saveToFile(string $filename) : string
        @@ -286,21 +829,132 @@

        Parameters
        - $quotes - : array<string|int, mixed> + $filename + : string
        -

        Array of raw quote data.

        +

        The file path to save to.

        +
        + Tags + + +
        +
        +
        + throws +
        +
        + InvalidArgumentException + +

        If filename is invalid (wrong extension, etc.).

        +
        + +
        +
        + throws +
        +
        + RuntimeException + +

        If file writing fails.

        +
        + +
        +
        + + + +
        +
        Return values
        + string + — +

        The absolute path of the saved file.

        +
        + +
        + +
        +
        +

        + extractQuoteAtIndex() + +

        + + +

        Extract quote data at a specific index from the multi-symbol response.

        + + + private + extractQuoteAtIndex(object $response, int $index, bool $isHumanReadable) : object + +
        +
        +

        Creates a response object that looks like a single-symbol response +by extracting values at the given index from each array field.

        +
        + +
        Parameters
        +
        +
        + $response + : object +
        +
        +

        The full multi-symbol response.

        +
        + +
        +
        + $index + : int +
        +
        +

        The index of the symbol to extract.

        +
        + +
        +
        + $isHumanReadable + : bool +
        +
        +

        Whether the response uses human-readable keys.

        +
        + +
        +
        + + + +
        +
        Return values
        + object + — +

        A response object formatted for a single symbol.

        +
        + +
        +
        @@ -340,6 +994,8 @@
        Parameters
        if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } @@ -415,7 +1071,10 @@
        Parameters
      • Properties
      • @@ -423,6 +1082,14 @@
        Parameters
      • diff --git a/docs/classes/MarketDataApp-Endpoints-Responses-Utilities-ApiStatus.html b/docs/classes/MarketDataApp-Endpoints-Responses-Utilities-ApiStatus.html index 9843fc86..b752966f 100644 --- a/docs/classes/MarketDataApp-Endpoints-Responses-Utilities-ApiStatus.html +++ b/docs/classes/MarketDataApp-Endpoints-Responses-Utilities-ApiStatus.html @@ -80,6 +80,14 @@

      • Exceptions +
      • +
      • + Logging + +
      • +
      • + Retry +
      • Traits @@ -151,10 +159,8 @@

        - - - - + +

        Table of Contents @@ -204,6 +210,13 @@

        ApiStatus constructor.
        +
        + __toString() + +  : string +
        +
        Returns a string representation of the API status.
        + @@ -222,14 +235,14 @@

        phpdocumentor-element -property -public - " + " >

        $services - +

      • + + uses + FormatsForDisplay
        @@ -141,7 +152,7 @@

        @@ -151,10 +162,8 @@

        - - - - + +

        Table of Contents @@ -175,6 +184,12 @@

        +
        + $online + +  : bool +
        +
        $service @@ -220,6 +235,76 @@

        ServiceStatus constructor.
        +
        + __toString() + +  : string +
        +
        Returns a string representation of the service status.
        + +
        + formatChange() + +  : string +
        +
        Format a change value with sign and currency (e.g., "+$1.25" or "-$0.50").
        + +
        + formatCurrency() + +  : string +
        +
        Format a float as currency (e.g., "$150.25").
        + +
        + formatDate() + +  : string +
        +
        Format a Carbon date without time (e.g., "Jan 24, 2026").
        + +
        + formatDateTime() + +  : string +
        +
        Format a Carbon date with time (e.g., "Jan 24, 2026 3:45 PM").
        + +
        + formatGreek() + +  : string +
        +
        Format a Greek value (4 decimal places, e.g., "0.4520").
        + +
        + formatNumber() + +  : string +
        +
        Format a number with commas (e.g., "15,234").
        + +
        + formatPercent() + +  : string +
        +
        Format a percentage with sign (e.g., "+3.25%" or "-1.50%").
        + +
        + formatPercentRaw() + +  : string +
        +
        Format a percentage that is already in percent form (e.g., "32.50%").
        + +
        + formatVolume() + +  : string +
        +
        Format volume with K/M/B suffixes (e.g., "54.9M", "12.3K").
        +
        @@ -238,27 +323,64 @@

        phpdocumentor-element -property -public - " + " +> +

        + $online + + + + +

        + + + + + + public + bool + $online + + + + + + + + + + +

        $service - +

        - public - string + public + string $service @@ -266,7 +388,8 @@

        - + +

        phpdocumentor-element -property -public - " + " >

        $status - +

        - public - string + public + string $status @@ -302,7 +425,8 @@

        - + +

        phpdocumentor-element -property -public - " + " >

        $updated - +

        - public - Carbon + public + Carbon $updated @@ -338,7 +462,8 @@

        - + +

        phpdocumentor-element -property -public - " + " >

        $uptime_percentage_30d - +

        - public - float + public + float $uptime_percentage_30d @@ -374,7 +499,8 @@

        - + +

        phpdocumentor-element -property -public - " + " >

        $uptime_percentage_90d - +

        - public - float + public + float $uptime_percentage_90d @@ -410,7 +536,8 @@

        - + +

        @@ -435,7 +562,7 @@

        @@ -443,7 +570,7 @@

        public - __construct(string $service, string $status, float $uptime_percentage_30d, float $uptime_percentage_90d, Carbon $updated) : mixed + __construct(string $service, string $status, bool $online, float $uptime_percentage_30d, float $uptime_percentage_90d, Carbon $updated) : mixed
        @@ -452,8 +579,8 @@

        Parameters
        - $service - : string + $service + : string

        The service being monitored.

        @@ -461,8 +588,8 @@
        Parameters
        - $status - : string + $status + : string

        The current status of each service (online or offline).

        @@ -470,8 +597,17 @@
        Parameters
        - $uptime_percentage_30d - : float + $online + : bool +
        +
        +

        The boolean online status of the service.

        +
        + +
        +
        + $uptime_percentage_30d + : float

        The uptime percentage of each service over the last 30 days.

        @@ -479,8 +615,8 @@
        Parameters
        - $uptime_percentage_90d - : float + $uptime_percentage_90d + : float

        The uptime percentage of each service over the last 90 days.

        @@ -488,8 +624,8 @@
        Parameters
        - $updated - : Carbon + $updated + : Carbon

        The timestamp of the last update for each service's status.

        @@ -500,9 +636,551 @@
        Parameters
        + + + + +
        +

        + __toString() + + +

        + + +

        Returns a string representation of the service status.

        + + + public + __toString() : string + +
        +
        + + + + + + + +
        +
        Return values
        + string + — +

        Human-readable service status.

        +
        + +
        + +
        +
        +

        + formatChange() + + +

        + + +

        Format a change value with sign and currency (e.g., "+$1.25" or "-$0.50").

        + + + protected + formatChange(float|null $value) : string + +
        +
        + + +
        Parameters
        +
        +
        + $value + : float|null +
        +
        +

        The change value to format.

        +
        + +
        +
        + + + + + +
        +
        Return values
        + string + — +

        Formatted change string or "N/A" if null.

        +
        + +
        + +
        +
        +

        + formatCurrency() + + +

        + + +

        Format a float as currency (e.g., "$150.25").

        + + + protected + formatCurrency(float|null $value) : string + +
        +
        + + +
        Parameters
        +
        +
        + $value + : float|null +
        +
        +

        The value to format.

        +
        + +
        +
        + + + + + +
        +
        Return values
        + string + — +

        Formatted currency string or "N/A" if null.

        +
        + +
        + +
        +
        +

        + formatDate() + + +

        + + +

        Format a Carbon date without time (e.g., "Jan 24, 2026").

        + + + protected + formatDate(Carbon|null $date) : string + +
        +
        + + +
        Parameters
        +
        +
        + $date + : Carbon|null +
        +
        +

        The date to format.

        +
        + +
        +
        + + + + + +
        +
        Return values
        + string + — +

        Formatted date string or "N/A" if null.

        +
        + +
        + +
        +
        +

        + formatDateTime() + + +

        + + +

        Format a Carbon date with time (e.g., "Jan 24, 2026 3:45 PM").

        + + + protected + formatDateTime(Carbon|null $date) : string + +
        +
        + + +
        Parameters
        +
        +
        + $date + : Carbon|null +
        +
        +

        The date to format.

        +
        + +
        +
        + + +
        +
        Return values
        + string + — +

        Formatted date string or "N/A" if null.

        +
        + +
        + +
        +
        +

        + formatGreek() + + +

        + + +

        Format a Greek value (4 decimal places, e.g., "0.4520").

        + + + protected + formatGreek(float|null $value) : string + +
        +
        + + +
        Parameters
        +
        +
        + $value + : float|null +
        +
        +

        The Greek value to format.

        +
        + +
        +
        + + + + + +
        +
        Return values
        + string + — +

        Formatted Greek string or "N/A" if null.

        +
        + +
        + +
        +
        +

        + formatNumber() + + +

        + + +

        Format a number with commas (e.g., "15,234").

        + + + protected + formatNumber(int|null $value) : string + +
        +
        + + +
        Parameters
        +
        +
        + $value + : int|null +
        +
        +

        The number to format.

        +
        + +
        +
        + + + + + +
        +
        Return values
        + string + — +

        Formatted number string or "N/A" if null.

        +
        + +
        + +
        +
        +

        + formatPercent() + + +

        + + +

        Format a percentage with sign (e.g., "+3.25%" or "-1.50%").

        + + + protected + formatPercent(float|null $value) : string + +
        +
        + +

        Assumes input is a decimal (0.30 = 30%).

        +
        + +
        Parameters
        +
        +
        + $value + : float|null +
        +
        +

        The decimal value to format as percentage.

        +
        + +
        +
        + + + + + +
        +
        Return values
        + string + — +

        Formatted percentage string or "N/A" if null.

        +
        + +
        + +
        +
        +

        + formatPercentRaw() + + +

        + + +

        Format a percentage that is already in percent form (e.g., "32.50%").

        + + + protected + formatPercentRaw(float|null $value) : string + +
        +
        + +

        Use this for values like implied volatility that are already percentages.

        +
        + +
        Parameters
        +
        +
        + $value + : float|null +
        +
        +

        The percentage value to format.

        +
        + +
        +
        + + + + + +
        +
        Return values
        + string + — +

        Formatted percentage string or "N/A" if null.

        +
        + +
        + +
        +
        +

        + formatVolume() + + +

        + + +

        Format volume with K/M/B suffixes (e.g., "54.9M", "12.3K").

        + + + protected + formatVolume(int|null $value) : string + +
        +
        + + +
        Parameters
        +
        +
        + $value + : int|null +
        +
        +

        The volume to format.

        +
        + +
        +
        + + + + + +
        +
        Return values
        + string + — +

        Formatted volume string or "N/A" if null.

        +
        + +
        +
        @@ -542,6 +1220,8 @@
        Parameters
        if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } @@ -617,6 +1297,7 @@
        Parameters
      • Properties
      • diff --git a/docs/classes/MarketDataApp-Endpoints-Responses-Utilities-User.html b/docs/classes/MarketDataApp-Endpoints-Responses-Utilities-User.html new file mode 100644 index 00000000..ca246dd3 --- /dev/null +++ b/docs/classes/MarketDataApp-Endpoints-Responses-Utilities-User.html @@ -0,0 +1,520 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
        +

        + MarketData SDK +

        + + + + + +
        + +
        +
        + + + + +
        +
        + + +
        +

        + User + + +
        + in package + +
        + + +

        + +
        + + +
        + + + +

        Represents user/rate limit information from the API.

        + + +

        This class wraps the RateLimits value object to provide rate limit information +retrieved from the /user/ endpoint.

        +
        + + + + + +

        + Table of Contents + + +

        + + + + + + + + + +

        + Properties + + +

        +
        +
        + $rate_limits + +  : RateLimits +
        +
        The rate limit information.
        + +
        + +

        + Methods + + +

        +
        +
        + __construct() + +  : mixed +
        +
        User constructor.
        + +
        + __toString() + +  : string +
        +
        Returns a string representation of the user info.
        + +
        + + + + + + +
        +

        + Properties + + +

        +
        +

        + $rate_limits + + + + +

        + + +

        The rate limit information.

        + + + + public + RateLimits + $rate_limits + + + + + + + + + +
        +
        + +
        +

        + Methods + + +

        +
        +

        + __construct() + + +

        + + +

        User constructor.

        + + + public + __construct(RateLimits $rateLimits) : mixed + +
        +
        + + +
        Parameters
        +
        +
        + $rateLimits + : RateLimits +
        +
        +

        The rate limit information extracted from response headers.

        +
        + +
        +
        + + + + + + +
        +
        +

        + __toString() + + +

        + + +

        Returns a string representation of the user info.

        + + + public + __toString() : string + +
        +
        + + + + + + + +
        +
        Return values
        + string + — +

        Human-readable user/rate limit information.

        +
        + +
        + +
        +
        + +
        +
        +
        +
        +
        
        +        
        + +
        +
        + + + +
        +
        +
        + +
        + On this page + + +
        + +
        +
        +
        +
        +
        +

        Search results

        + +
        +
        +
          +
          +
          +
          +
          + + +
          + + + + + + + + diff --git a/docs/classes/MarketDataApp-Endpoints-Stocks.html b/docs/classes/MarketDataApp-Endpoints-Stocks.html index 647e59cc..43ba5874 100644 --- a/docs/classes/MarketDataApp-Endpoints-Stocks.html +++ b/docs/classes/MarketDataApp-Endpoints-Stocks.html @@ -80,6 +80,14 @@

        • Exceptions +
        • +
        • + Logging + +
        • +
        • + Retry +
        • Traits @@ -131,7 +139,7 @@

          uses - UniversalParameters + UniversalParameters, ValidatesInputs

          @@ -142,7 +150,7 @@

          @@ -152,10 +160,8 @@

          - - - - + +

          Table of Contents @@ -217,19 +223,12 @@

          Get bulk candle data for stocks.
          -
          - bulkQuotes() - -  : BulkQuotes -
          -
          Get real-time price quotes for multiple stocks in a single API request.
          -
          candles()  : Candles
          -
          Get historical price candles for an index.
          +
          Get historical price candles for a stock.
          earnings() @@ -243,7 +242,14 @@

           : News

          -
          Retrieve news articles for a given stock symbol within a specified date range.
          +
          Retrieve news articles for a given stock symbol.
          + +
          + prices() + +  : Prices +
          +
          Get real-time midpoint prices for one or more stocks.
          quote() @@ -257,7 +263,28 @@

           : Quotes

          -
          Get real-time price quotes for multiple stocks by doing parallel requests.
          +
          Get real-time price quotes for multiple stocks in a single API request.
          + +
          + candlesConcurrent() + +  : Candles +
          +
          Fetch candles concurrently by splitting date range into year-long chunks.
          + +
          + candlesConcurrentCsv() + +  : Candles +
          +
          Handle CSV format for concurrent candle requests.
          + +
          + canParseAsDate() + +  : bool +
          +
          Check if a string can be parsed as a date.
          execute() @@ -273,6 +300,125 @@

          Execute multiple API requests in parallel with universal parameters.
          +
          + isIntradayResolution() + +  : bool +
          +
          Check if a resolution is intraday (minutely or hourly).
          + +
          + isParseableDate() + +  : bool +
          +
          Check if a date string can be parsed as an absolute date.
          + +
          + mergeCandleResponses() + +  : Candles +
          +
          Merge multiple candle responses into a single Candles object.
          + +
          + mergeParameters() + +  : Parameters +
          +
          Merge method-level parameters with client default parameters.
          + +
          + needsAutomaticSplitting() + +  : bool +
          +
          Determine if a candles request needs automatic date range splitting.
          + +
          + parseDateToTimestamp() + +  : int|null +
          +
          Parse a date string to unix timestamp.
          + +
          + parseUserDate() + +  : Carbon +
          +
          Parse a user-provided date string into a Carbon instance.
          + +
          + splitDateRangeIntoYearChunks() + +  : array<string|int, mixed> +
          +
          Split a date range into year-long chunks for concurrent fetching.
          + +
          + validateCountryCode() + +  : void +
          +
          Validate ISO 3166 two-letter country code.
          + +
          + validateDateRange() + +  : void +
          +
          Validate date range logic.
          + +
          + validateNonEmptyArray() + +  : void +
          +
          Validate that an array is non-empty.
          + +
          + validateNonEmptyString() + +  : void +
          +
          Validate that a string is non-empty.
          + +
          + validateNumericRange() + +  : void +
          +
          Validate that min < max when both are provided.
          + +
          + validatePositiveInteger() + +  : void +
          +
          Validate that an integer is positive if provided.
          + +
          + validatePositiveNumber() + +  : void +
          +
          Validate that a number (int or float) is positive if provided.
          + +
          + validateResolution() + +  : void +
          +
          Validate resolution format.
          + +
          + validateSymbols() + +  : void +
          +
          Validate symbols array (trim and ensure non-empty).
          +

        • @@ -294,7 +440,7 @@

          @@ -314,9 +460,8 @@

          - - - + + @@ -331,27 +476,27 @@

          phpdocumentor-element -property -private - " + " >

          $client - +

          - private - Client + private + Client $client @@ -361,7 +506,8 @@

          - + + @@ -386,7 +532,7 @@

          @@ -394,7 +540,7 @@

          public - __construct(Client $client) : mixed + __construct(Client $client) : mixed
          @@ -403,8 +549,8 @@

          Parameters
          - $client - : Client + $client + : Client

          The Market Data API client instance.

          @@ -415,8 +561,8 @@
          Parameters
          + -
          @@ -441,9 +587,11 @@

          public - bulkCandles([array<string|int, mixed> $symbols = [] ][, string $resolution = 'D' ][, bool $snapshot = false ][, string|null $date = null ][, bool $adjust_splits = false ][, Parameters|null $parameters = null ]) : BulkCandles + bulkCandles([array<string|int, mixed> $symbols = [] ][, string $resolution = 'D' ][, bool $snapshot = false ][, string|null $date = null ][, bool $adjust_splits = null ][, Parameters|null $parameters = null ]) : BulkCandles
          +
          APIYes
          +

          Get bulk candle data for stocks. This endpoint returns bulk daily candle data for multiple stocks. Unlike the @@ -455,9 +603,9 @@

          Parameters
          - $symbols - : array<string|int, mixed> - = []
          + $symbols + : array<string|int, mixed> + = []

          The ticker symbols to return in the response, separated by commas. The symbols parameter may be omitted if the snapshot parameter is set to true.

          @@ -465,9 +613,9 @@
          Parameters
          - $resolution - : string - = 'D'
          + $resolution + : string + = 'D'

          The duration of each candle. Only daily candles are supported at this time. @@ -476,9 +624,9 @@

          Parameters
          - $snapshot - : bool - = false
          + $snapshot + : bool + = false

          Returns candles for all available symbols for the date indicated. The symbols parameter can be omitted if snapshot is set to true.

          @@ -486,9 +634,9 @@
          Parameters
          - $date - : string|null - = null
          + $date + : string|null + = null

          The date of the candles to be returned. If no date is specified, during market hours the candles returned will be from the current session. If the @@ -498,9 +646,9 @@

          Parameters
          - $adjust_splits - : bool - = false
          + $adjust_splits + : bool + = null

          Adjust historical data for historical splits and reverse splits. Market Data uses the CRSP methodology for adjustment. Daily candles default: @@ -509,9 +657,9 @@

          Parameters
          - $parameters - : Parameters|null - = null
          + $parameters + : Parameters|null + = null

          Universal parameters for all methods (such as format).

          @@ -527,108 +675,40 @@
          - throws + link
          - ApiException - - +

          API Documentation

          +
          +
          -
          - throws +
          + see
          - GuzzleException - - -
          -
          - - - -
          -
          Return values
          - BulkCandles -
          - -

          -
          -

          - bulkQuotes() - - -

          - - -

          Get real-time price quotes for multiple stocks in a single API request.

          - - - public - bulkQuotes([array<string|int, mixed> $symbols = [] ][, bool $snapshot = false ][, Parameters|null $parameters = null ]) : BulkQuotes - -
          -
          - -

          The bulkQuotes endpoint is designed to return hundreds of symbols at once or full market snapshots. Response -times for less than 50 symbols will be quicker using the standard quotes endpoint and sending your requests in -parallel.

          -
          - -
          Parameters
          -
          -
          - $symbols - : array<string|int, mixed> - = []
          -
          -

          The ticker symbols to return in the response, separated by commas. The -symbols parameter may be omitted if the snapshot parameter is set to true.

          -
          - -
          -
          - $snapshot - : bool - = false
          -
          -

          Returns a full market snapshot with quotes for all symbols when set to true. -The symbols parameter may be omitted if the snapshot parameter is set.

          + candles() + +

          For historical candles of a single symbol

          -
          -
          - $parameters - : Parameters|null - = null
          -
          -

          Universal parameters for all methods (such as format).

          +
          +
          + example +
          +
          + +

          // Get bulk candles for multiple symbols +$candles = $client->stocks->bulkCandles(['AAPL', 'MSFT', 'GOOGL']);

          +

          // Get a market snapshot of all symbols +$snapshot = $client->stocks->bulkCandles(snapshot: true);

          -
          -
          - - -
          - Tags - - -
          -
          -
          +
          +
          throws
          - GuzzleException + ApiException
          @@ -636,17 +716,17 @@
          throws
          - Exception + GuzzleException
          + -
          Return values
          - BulkQuotes + BulkCandles
          @@ -664,25 +744,27 @@

          -

          Get historical price candles for an index.

          +

          Get historical price candles for a stock.

          public - candles(string $symbol, string $from[, string|null $to = null ][, string $resolution = 'D' ][, int|null $countback = null ][, string|null $exchange = null ][, bool $extended = false ][, string|null $country = null ][, bool $adjust_splits = false ][, bool $adjust_dividends = false ][, Parameters|null $parameters = null ]) : Candles + candles(string $symbol, string $from[, string|null $to = null ][, string $resolution = 'D' ][, int|null $countback = null ][, bool $extended = false ][, bool $adjust_splits = null ][, Parameters|null $parameters = null ]) : Candles
          +
          APIYes
          +

          Parameters
          - $symbol - : string + $symbol + : string

          The company's ticker symbol.

          @@ -690,8 +772,8 @@
          Parameters
          - $from - : string + $from + : string

          The leftmost candle on a chart (inclusive). If you use countback, to is @@ -700,9 +782,9 @@

          Parameters
          - $to - : string|null - = null
          + $to + : string|null + = null

          The rightmost candle on a chart (inclusive). Accepted timestamp inputs: ISO 8601, unix, spreadsheet.

          @@ -710,9 +792,9 @@
          Parameters
          - $resolution - : string - = 'D'
          + $resolution + : string + = 'D'

          The duration of each candle.

            @@ -727,9 +809,9 @@
            Parameters
          - $countback - : int|null - = null
          + $countback + : int|null + = null

          Will fetch a number of candles before (to the left of) to. If you use from, countback is not required.

          @@ -737,22 +819,9 @@
          Parameters
          - $exchange - : string|null - = null
          -
          -

          Use to specify the exchange of the ticker. This is useful when you need -to specify a stock that quotes on several exchanges with the same -symbol. You may specify the exchange using the EXCHANGE ACRONYM, MIC -CODE, or two digit YAHOO FINANCE EXCHANGE CODE. If no exchange is -specified symbols will be matched to US exchanges first.

          -
          - -
          -
          - $extended - : bool - = false
          + $extended + : bool + = false

          Include extended hours trading sessions when returning intraday candles. Daily resolutions never return extended hours candles. The @@ -761,22 +830,9 @@

          Parameters
          - $country - : string|null - = null
          -
          -

          Use to specify the country of the exchange (not the country of the -company) in conjunction with the symbol argument. This argument is -useful when you know the ticker symbol and the country of the exchange, -but not the exchange code. Use the two digit ISO 3166 country code. If -no country is specified, US exchanges will be assumed.

          -
          - -
          -
          - $adjust_splits - : bool - = false
          + $adjust_splits + : bool + = null

          Adjust historical data for for historical splits and reverse splits. Market Data uses the CRSP methodology for adjustment. Daily candles @@ -785,21 +841,9 @@

          Parameters
          - $adjust_dividends - : bool - = false
          -
          -

          CAUTION: Adjusted dividend data is planned for the future, but not yet -implemented. All data is currently returned unadjusted for dividends. -Market Data uses the CRSP methodology for adjustment. Daily candles -default: true. Intraday candles default: false.

          -
          - -
          -
          - $parameters - : Parameters|null - = null
          + $parameters + : Parameters|null + = null

          Universal parameters for all methods (such as format).

          @@ -815,6 +859,36 @@
          + link +
          +
          +

          API Documentation

          +
          + +
          +
          + see +
          +
          + bulkCandles() + +

          For bulk daily candles across multiple symbols

          +
          + +
          +
          + example +
          +
          + +

          // Get daily candles for AAPL +$candles = $client->stocks->candles('AAPL', '2024-01-01', '2024-01-31');

          +

          // Get 5-minute candles with extended hours +$candles = $client->stocks->candles('AAPL', '2024-01-15', '2024-01-15', '5', extended: true);

          +
          + +
          +
          throws
          @@ -824,8 +898,8 @@
          + -
          Return values
          Candles @@ -846,7 +920,7 @@

          @@ -854,9 +928,11 @@

          public - earnings(string $symbol[, string|null $from = null ][, string|null $to = null ][, int|null $countback = null ][, string|null $date = null ][, string|null $datekey = null ][, Parameters|null $parameters = null ]) : Earnings + earnings(string $symbol[, string|null $from = null ][, string|null $to = null ][, int|null $countback = null ][, string|null $date = null ][, Parameters|null $parameters = null ]) : Earnings
          +
          APIYes
          +

          Premium subscription required.

          @@ -865,8 +941,8 @@

          Parameters
          - $symbol - : string + $symbol + : string

          The company's ticker symbol.

          @@ -874,58 +950,46 @@
          Parameters
          - $from - : string|null - = null
          -
          -

          The earliest earnings report to include in the output. If you use countback, -from is not required.

          -
          - -
          -
          - $to - : string|null - = null
          + $from + : string|null + = null
          -

          The latest earnings report to include in the output.

          +

          The earliest earnings report to include in the output. Optional - if omitted +without countback, returns recent/upcoming earnings.

          - $countback - : int|null - = null
          + $to + : string|null + = null
          -

          Countback will fetch a specific number of earnings reports before to. If you -use from, countback is not required.

          +

          The latest earnings report to include in the output. Optional.

          - $date - : string|null - = null
          + $countback + : int|null + = null
          -

          Retrieve a specific earnings report by date.

          +

          Countback will fetch a specific number of earnings reports before to. Optional.

          - $datekey - : string|null - = null
          + $date + : string|null + = null
          -

          Retrieve a specific earnings report by date and quarter. Example: 2023-Q4. -This allows you to retrieve a 4th quarter value without knowing the company's -specific fiscal year.

          +

          Retrieve a specific earnings report by date. Optional.

          - $parameters - : Parameters|null - = null
          + $parameters + : Parameters|null + = null

          Universal parameters for all methods (such as format).

          @@ -941,6 +1005,26 @@
          + link +
          +
          +

          API Documentation

          +
          + +
          +
          + example +
          +
          + +

          // Get upcoming earnings +$earnings = $client->stocks->earnings('AAPL');

          +

          // Get historical earnings for a date range +$earnings = $client->stocks->earnings('AAPL', from: '2023-01-01', to: '2023-12-31');

          +
          + +
          +
          throws
          @@ -958,8 +1042,8 @@
          + -
          Return values
          Earnings @@ -980,17 +1064,19 @@

          -

          Retrieve news articles for a given stock symbol within a specified date range.

          +

          Retrieve news articles for a given stock symbol.

          public - news(string $symbol[, string|null $from = null ][, string|null $to = null ][, int|null $countback = null ][, string|null $date = null ][, Parameters|null $parameters = null ]) : News + news(string $symbol[, string|null $from = null ][, string|null $to = null ][, int|null $countback = null ][, string|null $date = null ][, Parameters|null $parameters = null ]) : News
          +
          APIYes
          +

          CAUTION: This endpoint is in beta.

          @@ -999,8 +1085,8 @@

          Parameters
          - $symbol - : string + $symbol + : string

          The ticker symbol of the stock.

          @@ -1008,47 +1094,46 @@
          Parameters
          - $from - : string|null - = null
          + $from + : string|null + = null
          -

          The earliest news to include in the output. If you use countback, from is not -required.

          +

          The earliest news to include in the output. Optional - if omitted without +countback, returns recent news.

          - $to - : string|null - = null
          + $to + : string|null + = null
          -

          The latest news to include in the output.

          +

          The latest news to include in the output. Optional.

          - $countback - : int|null - = null
          + $countback + : int|null + = null
          -

          Countback will fetch a specific number of news before to. If you use from, -countback is not required.

          +

          Countback will fetch a specific number of news before to. Optional.

          - $date - : string|null - = null
          + $date + : string|null + = null
          -

          Retrieve news for a specific day.

          +

          Retrieve news for a specific day. Optional.

          - $parameters - : Parameters|null - = null
          + $parameters + : Parameters|null + = null

          Universal parameters for all methods (such as format).

          @@ -1064,17 +1149,37 @@
          - throws + link
          - InvalidArgumentException - - +

          API Documentation

          +
          +
          -
          - - +
          + example +
          +
          + +

          // Get recent news for a symbol +$news = $client->stocks->news('AAPL');

          +

          // Get news for a specific date range +$news = $client->stocks->news('AAPL', from: '2024-01-01', to: '2024-01-31');

          +
          + +
          +
          + throws +
          +
          + InvalidArgumentException + + +
          +
          + +
          Return values
          News @@ -1087,53 +1192,66 @@
          Return values
          -public " > -

          - quote() - +

          + prices() +

          -

          Get a real-time price quote for a stock.

          +

          Get real-time midpoint prices for one or more stocks.

          public - quote(string $symbol[, bool $fifty_two_week = false ][, Parameters|null $parameters = null ]) : Quote + prices(string|array<string|int, mixed> $symbols[, bool $extended = true ][, Parameters|null $parameters = null ]) : Prices
          +
          APIYes
          +
          - +

          This endpoint returns real-time prices for stocks, using the SmartMid model. +The endpoint supports both single symbol (path parameter) and multiple symbols (query parameter) formats.

          +
          +
          Parameters
          - $symbol - : string + $symbols + : string|array<string|int, mixed>
          -

          The company's ticker symbol.

          +

          The ticker symbol(s). Can be a single string or an array of strings.

          - $fifty_two_week - : bool - = false
          + $extended + : bool + = true
          -

          Enable the output of 52-week high and 52-week low data in the quote -output. By default this parameter is false if omitted.

          +

          Control the inclusion of extended hours data in the price output. +Defaults to true if omitted.

          +
            +
          • When set to true, the most recent price is always returned, without regard +to whether the market is open for primary trading or extended hours trading.
          • +
          • When set to false, only prices from the primary trading session are returned. +When the market is closed or in extended hours, a historical price from the +last closing bell of the primary trading session is returned instead of an +extended hours price.
          • +
          - $parameters - : Parameters|null - = null
          + $parameters + : Parameters|null + = null

          Universal parameters for all methods (such as format).

          @@ -1144,11 +1262,41 @@
          Parameters
          Tags - +
          + link +
          +
          +

          API Documentation

          +
          + +
          +
          + see +
          +
          + quote() + +

          For full quote data including bid/ask

          +
          + +
          +
          + example +
          +
          + +

          // Get price for a single symbol +$prices = $client->stocks->prices('AAPL');

          +

          // Get prices for multiple symbols +$prices = $client->stocks->prices(['AAPL', 'MSFT', 'GOOGL']);

          +
          + +
          +
          throws
          @@ -1158,11 +1306,11 @@
          + -
          Return values
          - Quote + Prices
          @@ -1172,53 +1320,74 @@
          Return values
          -public " > -

          - quotes() - +

          + quote() +

          -

          Get real-time price quotes for multiple stocks by doing parallel requests.

          +

          Get a real-time price quote for a stock.

          public - quotes(array<string|int, mixed> $symbols[, bool $fifty_two_week = false ][, Parameters|null $parameters = null ]) : Quotes + quote(string $symbol[, bool $fifty_two_week = false ][, bool $extended = true ][, Parameters|null $parameters = null ]) : Quote
          +
          APIYes
          +
          Parameters
          - $symbols - : array<string|int, mixed> + $symbol + : string
          -

          The ticker symbols to return in the response.

          +

          The company's ticker symbol.

          - $fifty_two_week - : bool - = false
          + $fifty_two_week + : bool + = false

          Enable the output of 52-week high and 52-week low data in the quote -output.

          +output. By default this parameter is false if omitted.

          +
          + +
          +
          + $extended + : bool + = true
          +
          +

          Control the inclusion of extended hours data in the quote output. +Defaults to true if omitted.

          +
            +
          • When set to true, the most recent quote is always returned, without +regard to whether the market is open for primary trading or extended +hours trading.
          • +
          • When set to false, only quotes from the primary trading session are +returned. When the market is closed or in extended hours, a historical +quote from the last closing bell of the primary trading session is +returned instead of an extended hours quote.
          • +
          - $parameters - : Parameters|null - = null
          + $parameters + : Parameters|null + = null

          Universal parameters for all methods (such as format).

          @@ -1229,98 +1398,213 @@
          Parameters
          Tags - +
          + link +
          +
          +

          API Documentation

          +
          + +
          +
          + see +
          +
          + quotes() + +

          For quotes of multiple symbols in a single request

          +
          + +
          +
          + see +
          +
          + prices() + +

          For SmartMid midpoint prices

          +
          + +
          +
          + example +
          +
          + +

          // Get a real-time quote +$quote = $client->stocks->quote('AAPL'); +echo $quote->last; // Last traded price

          +

          // Get quote with 52-week high/low +$quote = $client->stocks->quote('AAPL', fifty_two_week: true);

          +
          + +
          +
          throws
          - Throwable + GuzzleException|ApiException
          + -
          Return values
          - Quotes + Quote
          -

          - execute() - +

          + quotes() +

          -

          Execute a single API request with universal parameters.

          +

          Get real-time price quotes for multiple stocks in a single API request.

          - protected - execute(string $method, array<string|int, mixed> $arguments, Parameters|null $parameters) : object + public + quotes(array<string|int, mixed> $symbols[, bool $fifty_two_week = false ][, bool $extended = true ][, Parameters|null $parameters = null ]) : Quotes
          +
          APIYes
          +
          Parameters
          - $method - : string + $symbols + : array<string|int, mixed>
          -

          The API method to call.

          +

          The ticker symbols to return in the response.

          - $arguments - : array<string|int, mixed> -
          + $fifty_two_week + : bool + = false
          -

          The arguments for the API call.

          +

          Enable the output of 52-week high and 52-week low data in the quote +output.

          - $parameters - : Parameters|null -
          + $extended + : bool + = true
          -

          Optional Parameters object for additional settings.

          +

          Control the inclusion of extended hours data in the quote output. +Defaults to true if omitted.

          +
            +
          • When set to true, the most recent quote is always returned, without +regard to whether the market is open for primary trading or extended +hours trading.
          • +
          • When set to false, only quotes from the primary trading session are +returned. When the market is closed or in extended hours, a historical +quote from the last closing bell of the primary trading session is +returned instead of an extended hours quote.
          • +
          +
          + +
          +
          + $parameters + : Parameters|null + = null
          +
          +

          Universal parameters for all methods (such as format).

          +
          + Tags + - +
          +
          +
          + link +
          +
          +

          API Documentation

          +
          + +
          +
          + see +
          +
          + quote() + +

          For a single symbol quote

          +
          -
          -
          Return values
          - object - — -

          The API response as an object.

          +
          +
          + see +
          +
          + bulkCandles() + +

          For bulk daily candle data

          +
          + +
          +
          + example +
          +
          + +

          // Get quotes for multiple symbols +$quotes = $client->stocks->quotes(['AAPL', 'MSFT', 'GOOGL']); +foreach ($quotes->quotes as $q) { +echo "{$q->symbol}: ${$q->last}\n"; +}

          +
          +
          + throws +
          +
          + GuzzleException|ApiException + + +
          +
          + + + +
          +
          Return values
          + Quotes
          @@ -1330,45 +1614,100 @@
          Return values
          -protected " > -

          - execute_in_parallel() - +

          + candlesConcurrent() +

          -

          Execute multiple API requests in parallel with universal parameters.

          +

          Fetch candles concurrently by splitting date range into year-long chunks.

          protected - execute_in_parallel(array<string|int, mixed> $calls[, Parameters|null $parameters = null ]) : array<string|int, mixed> + candlesConcurrent(string $symbol, string $from, string $to, string $resolution, bool $extended, bool|null $adjust_splits, Parameters|null $parameters) : Candles
          - +

          This method is called automatically when:

          +
            +
          1. Resolution is intraday (minutely or hourly)
          2. +
          3. The date range spans more than 1 year
          4. +
          5. countback is not specified
          6. +
          +

          The date range is split into year-long chunks, which are fetched concurrently +(up to MAX_CONCURRENT_REQUESTS at a time). The responses are then merged +into a single Candles object.

          +
          +
          Parameters
          - $calls - : array<string|int, mixed> + $symbol + : string
          -

          An array of method calls, each containing the method name and arguments.

          +

          The stock symbol.

          - $parameters - : Parameters|null - = null
          + $from + : string +
          -

          Optional Parameters object for additional settings.

          +

          The start date.

          +
          + +
          +
          + $to + : string +
          +
          +

          The end date.

          +
          + +
          +
          + $resolution + : string +
          +
          +

          The candle resolution.

          +
          + +
          +
          + $extended + : bool +
          +
          +

          Include extended hours.

          +
          + +
          +
          + $adjust_splits + : bool|null +
          +
          +

          Adjust for splits.

          +
          + +
          +
          + $parameters + : Parameters|null +
          +
          +

          Universal parameters.

          @@ -1377,7 +1716,7 @@
          Parameters
          Tags - +
          @@ -1391,17 +1730,1579 @@
          + -
          Return values
          - array<string|int, mixed> + Candles — -

          An array of API responses.

          +

          The merged candles response.

          + +
          +

          + candlesConcurrentCsv() + + +

          + + +

          Handle CSV format for concurrent candle requests.

          + + + protected + candlesConcurrentCsv(string $symbol, string $from, string $to, string $resolution, bool $extended, bool|null $adjust_splits, Parameters|null $parameters, Parameters $mergedParams) : Candles + +
          +
          + +

          Makes separate requests for each date chunk, with headers=true on ALL requests +(unless user explicitly set add_headers=false). This ensures headers are present +even if the first chunk fails. Duplicate headers are stripped when combining.

          +
          + +
          Parameters
          +
          +
          + $symbol + : string +
          +
          +

          The stock symbol.

          +
          + +
          +
          + $from + : string +
          +
          +

          The start date.

          +
          + +
          +
          + $to + : string +
          +
          +

          The end date.

          +
          + +
          +
          + $resolution + : string +
          +
          +

          The candle resolution.

          +
          + +
          +
          + $extended + : bool +
          +
          +

          Include extended hours.

          +
          + +
          +
          + $adjust_splits + : bool|null +
          +
          +

          Adjust for splits.

          +
          + +
          +
          + $parameters + : Parameters|null +
          +
          +

          Original parameters from caller.

          +
          + +
          +
          + $mergedParams + : Parameters +
          +
          +

          Merged parameters with defaults applied.

          +
          + +
          +
          + + +
          + Tags + + +
          +
          +
          + throws +
          +
          + Throwable + + +
          +
          + + + +
          +
          Return values
          + Candles + — +

          Candles object containing combined CSV.

          +
          + +
          + +
          +
          +

          + canParseAsDate() + + +

          + + +

          Check if a string can be parsed as a date.

          + + + protected + canParseAsDate(string|null $value) : bool + +
          +
          + +

          Similar to Python SDK's check_is_date() function. +Returns true if the value contains "-" or "/" (indicating parseable date format) +or is numeric (unix timestamp or spreadsheet format).

          +

          This allows relative dates ("today", "yesterday", "-5 days") and option +expiration dates ("December expiration") to pass through without validation.

          +
          + +
          Parameters
          +
          +
          + $value + : string|null +
          +
          +

          The value to check

          +
          + +
          +
          + + + + + +
          +
          Return values
          + bool + — +

          True if the value can be parsed as a date

          +
          + +
          + +
          +
          +

          + execute() + + +

          + + +

          Execute a single API request with universal parameters.

          + + + protected + execute(string $method, array<string|int, mixed> $arguments, Parameters|null $parameters) : object + +
          +
          + + +
          Parameters
          +
          +
          + $method + : string +
          +
          +

          The API method to call.

          +
          + +
          +
          + $arguments + : array<string|int, mixed> +
          +
          +

          The arguments for the API call.

          +
          + +
          +
          + $parameters + : Parameters|null +
          +
          +

          Optional Parameters object for additional settings.

          +
          + +
          +
          + + + + + +
          +
          Return values
          + object + — +

          The API response as an object.

          +
          + +
          + +
          +
          +

          + execute_in_parallel() + + +

          + + +

          Execute multiple API requests in parallel with universal parameters.

          + + + protected + execute_in_parallel(array<string|int, mixed> $calls[, Parameters|null $parameters = null ][, array<string|int, mixed>|null &$failedRequests = null ]) : array<string|int, mixed> + +
          +
          + + +
          Parameters
          +
          +
          + $calls + : array<string|int, mixed> +
          +
          +

          An array of method calls, each containing the method name and arguments.

          +
          + +
          +
          + $parameters + : Parameters|null + = null
          +
          +

          Optional Parameters object for additional settings.

          +
          + +
          +
          + $failedRequests + : array<string|int, mixed>|null + = null
          +
          +

          Optional by-reference array to collect failed requests instead of throwing. +When provided, exceptions are stored here keyed by their call index.

          +
          + +
          +
          + + +
          + Tags + + +
          +
          +
          + throws +
          +
          + Throwable + +

          When $failedRequests is not provided and any request fails.

          +
          + +
          +
          + + + +
          +
          Return values
          + array<string|int, mixed> + — +

          An array of API responses. When $failedRequests is provided, results are keyed by original call index.

          +
          + +
          + +
          +
          +

          + isIntradayResolution() + + +

          + + +

          Check if a resolution is intraday (minutely or hourly).

          + + + protected + isIntradayResolution(string $resolution) : bool + +
          +
          + +

          Intraday resolutions include:

          +
            +
          • Minutely: 1, 3, 5, 15, 30, 45, minutely, or any number followed by optional suffix
          • +
          • Hourly: H, 1H, 2H, hourly, or any number followed by H
          • +
          +
          + +
          Parameters
          +
          +
          + $resolution + : string +
          +
          +

          The resolution to check.

          +
          + +
          +
          + + + + + +
          +
          Return values
          + bool + — +

          True if the resolution is intraday, false otherwise.

          +
          + +
          + +
          +
          +

          + isParseableDate() + + +

          + + +

          Check if a date string can be parsed as an absolute date.

          + + + protected + isParseableDate(string $date) : bool + +
          +
          + +

          This is used to determine if we can calculate date ranges for automatic splitting. +Relative dates (like "today", "-5 days") or unparseable dates will return false. +Unix timestamps (pure digit strings) are accepted.

          +
          + +
          Parameters
          +
          +
          + $date + : string +
          +
          +

          The date string to check.

          +
          + +
          +
          + + + + + +
          +
          Return values
          + bool + — +

          True if the date can be parsed, false otherwise.

          +
          + +
          + +
          +
          +

          + mergeCandleResponses() + + +

          + + +

          Merge multiple candle responses into a single Candles object.

          + + + protected + mergeCandleResponses(array<string|int, mixed> $responses, string $symbol) : Candles + +
          +
          + +

          This method combines candles from multiple API responses, typically from +concurrent requests for different date chunks. The candles are sorted by +timestamp to maintain chronological order.

          +
          + +
          Parameters
          +
          +
          + $responses + : array<string|int, mixed> +
          +
          +

          Array of raw response objects from the API.

          +
          + +
          +
          + $symbol + : string +
          +
          +

          The symbol to associate with all candles.

          +
          + +
          +
          + + + + + +
          +
          Return values
          + Candles + — +

          A single Candles object containing all candles.

          +
          + +
          + +
          +
          +

          + mergeParameters() + + +

          + + +

          Merge method-level parameters with client default parameters.

          + + + protected + mergeParameters(Parameters|null $methodParams) : Parameters + +
          +
          + +

          Priority order (highest to lowest):

          +
            +
          1. Method-level parameters (if provided)
          2. +
          3. Client default parameters ($this->client->default_params)
          4. +
          5. Default Parameters() values
          6. +
          +
          + +
          Parameters
          +
          +
          + $methodParams + : Parameters|null +
          +
          +

          Method-level parameters, or null to use only client defaults.

          +
          + +
          +
          + + + + + +
          +
          Return values
          + Parameters + — +

          Merged parameters instance.

          +
          + +
          + +
          +
          +

          + needsAutomaticSplitting() + + +

          + + +

          Determine if a candles request needs automatic date range splitting.

          + + + protected + needsAutomaticSplitting(string $resolution, string $from, string|null $to, int|null $countback) : bool + +
          +
          + +

          Splitting is needed when:

          +
            +
          1. Resolution is intraday (minutely or hourly)
          2. +
          3. Both from and to dates are parseable
          4. +
          5. The date range spans more than 1 year
          6. +
          7. countback is not specified (we can't split countback requests)
          8. +
          +
          + +
          Parameters
          +
          +
          + $resolution + : string +
          +
          +

          The candle resolution.

          +
          + +
          +
          + $from + : string +
          +
          +

          The start date.

          +
          + +
          +
          + $to + : string|null +
          +
          +

          The end date.

          +
          + +
          +
          + $countback + : int|null +
          +
          +

          The countback value.

          +
          + +
          +
          + + + + + +
          +
          Return values
          + bool + — +

          True if automatic splitting is needed, false otherwise.

          +
          + +
          + +
          +
          +

          + parseDateToTimestamp() + + +

          + + +

          Parse a date string to unix timestamp.

          + + + protected + parseDateToTimestamp(string|null $value) : int|null + +
          +
          + +

          Handles ISO 8601, unix timestamps, spreadsheet dates, and American format.

          +
          + +
          Parameters
          +
          +
          + $value + : string|null +
          +
          +

          The date string to parse

          +
          + +
          +
          + + + + + +
          +
          Return values
          + int|null + — +

          Unix timestamp or null if cannot be parsed

          +
          + +
          + +
          +
          +

          + parseUserDate() + + +

          + + +

          Parse a user-provided date string into a Carbon instance.

          + + + protected + parseUserDate(string $date) : Carbon + +
          +
          + +

          Handles both standard date formats and unix timestamps (9-10 digit strings). +This should be used whenever parsing user input that could be a unix timestamp.

          +
          + +
          Parameters
          +
          +
          + $date + : string +
          +
          +

          The date string to parse (ISO 8601, unix timestamp, etc.).

          +
          + +
          +
          + + + + + +
          +
          Return values
          + Carbon + — +

          The parsed Carbon instance.

          +
          + +
          + +
          +
          +

          + splitDateRangeIntoYearChunks() + + +

          + + +

          Split a date range into year-long chunks for concurrent fetching.

          + + + protected + splitDateRangeIntoYearChunks(string $from, string $to) : array<string|int, mixed> + +
          +
          + +

          This method splits a date range into chunks of approximately 1 year each, +which is the maximum recommended range for intraday data requests.

          +
          + +
          Parameters
          +
          +
          + $from + : string +
          +
          +

          The start date (ISO 8601 format).

          +
          + +
          +
          + $to + : string +
          +
          +

          The end date (ISO 8601 format).

          +
          + +
          +
          + + + + + +
          +
          Return values
          + array<string|int, mixed> + — +

          Array of [from, to] date pairs representing each chunk.

          +
          + +
          + +
          +
          +

          + validateCountryCode() + + +

          + + +

          Validate ISO 3166 two-letter country code.

          + + + protected + validateCountryCode(string $country) : void + +
          +
          + + +
          Parameters
          +
          +
          + $country + : string +
          +
          +

          The country code to validate

          +
          + +
          +
          + + +
          + Tags + + +
          +
          +
          + throws +
          +
          + InvalidArgumentException + +

          If country code is invalid

          +
          + +
          +
          + + + + +
          +
          +

          + validateDateRange() + + +

          + + +

          Validate date range logic.

          + + + protected + validateDateRange(string|null $from, string|null $to[, int|null $countback = null ][, string $context = '' ]) : void + +
          +
          + +

          Rules:

          +
            +
          • If to is provided, it requires either from OR countback (but not both)
          • +
          • If both from and to are parseable dates, validates that from < to
          • +
          • If countback is provided, it must be a positive integer
          • +
          +

          This allows relative dates and option expiration dates to pass through without +strict format validation.

          +
          + +
          Parameters
          +
          +
          + $from + : string|null +
          +
          +

          The start date

          +
          + +
          +
          + $to + : string|null +
          +
          +

          The end date

          +
          + +
          +
          + $countback + : int|null + = null
          +
          +

          The countback value

          +
          + +
          +
          + $context + : string + = ''
          +
          +

          Optional context for error messages

          +
          + +
          +
          + + +
          + Tags + + +
          +
          +
          + throws +
          +
          + InvalidArgumentException + +

          If validation fails

          +
          + +
          +
          + + + + +
          +
          +

          + validateNonEmptyArray() + + +

          + + +

          Validate that an array is non-empty.

          + + + protected + validateNonEmptyArray(array<string|int, mixed> $value, string $fieldName) : void + +
          +
          + + +
          Parameters
          +
          +
          + $value + : array<string|int, mixed> +
          +
          +

          The value to validate

          +
          + +
          +
          + $fieldName + : string +
          +
          +

          The field name for error messages

          +
          + +
          +
          + + +
          + Tags + + +
          +
          +
          + throws +
          +
          + InvalidArgumentException + +

          If array is empty

          +
          + +
          +
          + + + + +
          +
          +

          + validateNonEmptyString() + + +

          + + +

          Validate that a string is non-empty.

          + + + protected + validateNonEmptyString(string $value, string $fieldName) : void + +
          +
          + + +
          Parameters
          +
          +
          + $value + : string +
          +
          +

          The value to validate

          +
          + +
          +
          + $fieldName + : string +
          +
          +

          The field name for error messages

          +
          + +
          +
          + + +
          + Tags + + +
          +
          +
          + throws +
          +
          + InvalidArgumentException + +

          If value is empty

          +
          + +
          +
          + + + + +
          +
          +

          + validateNumericRange() + + +

          + + +

          Validate that min < max when both are provided.

          + + + protected + validateNumericRange(float|null $min, float|null $max, string $minField, string $maxField) : void + +
          +
          + + +
          Parameters
          +
          +
          + $min + : float|null +
          +
          +

          The minimum value

          +
          + +
          +
          + $max + : float|null +
          +
          +

          The maximum value

          +
          + +
          +
          + $minField + : string +
          +
          +

          The minimum field name for error messages

          +
          + +
          +
          + $maxField + : string +
          +
          +

          The maximum field name for error messages

          +
          + +
          +
          + + +
          + Tags + + +
          +
          +
          + throws +
          +
          + InvalidArgumentException + +

          If min >= max

          +
          + +
          +
          + + + + +
          +
          +

          + validatePositiveInteger() + + +

          + + +

          Validate that an integer is positive if provided.

          + + + protected + validatePositiveInteger(int|null $value, string $fieldName) : void + +
          +
          + + +
          Parameters
          +
          +
          + $value + : int|null +
          +
          +

          The value to validate

          +
          + +
          +
          + $fieldName + : string +
          +
          +

          The field name for error messages

          +
          + +
          +
          + + +
          + Tags + + +
          +
          +
          + throws +
          +
          + InvalidArgumentException + +

          If value is not positive

          +
          + +
          +
          + + + + +
          +
          +

          + validatePositiveNumber() + + +

          + + +

          Validate that a number (int or float) is positive if provided.

          + + + protected + validatePositiveNumber(int|float|null $value, string $fieldName) : void + +
          +
          + + +
          Parameters
          +
          +
          + $value + : int|float|null +
          +
          +

          The value to validate

          +
          + +
          +
          + $fieldName + : string +
          +
          +

          The field name for error messages

          +
          + +
          +
          + + +
          + Tags + + +
          +
          +
          + throws +
          +
          + InvalidArgumentException + +

          If value is not positive

          +
          + +
          +
          + + + + +
          +
          +

          + validateResolution() + + +

          + + +

          Validate resolution format.

          + + + protected + validateResolution(string $resolution) : void + +
          +
          + +

          Valid resolutions: minutely, hourly, daily, weekly, monthly, yearly, +or numeric with optional suffix (1, 3, 5, 15, 30, 45, H, 1H, 2H, D, 1D, 2D, etc.)

          +
          + +
          Parameters
          +
          +
          + $resolution + : string +
          +
          +

          The resolution to validate

          +
          + +
          +
          + + +
          + Tags + + +
          +
          +
          + throws +
          +
          + InvalidArgumentException + +

          If resolution is invalid

          +
          + +
          +
          + + + + +
          +
          +

          + validateSymbols() + + +

          + + +

          Validate symbols array (trim and ensure non-empty).

          + + + protected + validateSymbols(array<string|int, mixed> $symbols) : void + +
          +
          + + +
          Parameters
          +
          +
          + $symbols + : array<string|int, mixed> +
          +
          +

          The symbols array to validate

          +
          + +
          +
          + + +
          + Tags + + +
          +
          +
          + throws +
          +
          + InvalidArgumentException + +

          If symbols array is invalid

          +
          + +
          +
          + + + +
          @@ -1441,6 +3342,8 @@
          Return values
          if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } @@ -1532,14 +3435,34 @@
          Return values
          diff --git a/docs/classes/MarketDataApp-Endpoints-Utilities.html b/docs/classes/MarketDataApp-Endpoints-Utilities.html index 1ba01fc5..468e681f 100644 --- a/docs/classes/MarketDataApp-Endpoints-Utilities.html +++ b/docs/classes/MarketDataApp-Endpoints-Utilities.html @@ -80,6 +80,14 @@

        • Exceptions +
        • +
        • + Logging + +
        • +
        • + Retry +
        • Traits @@ -139,7 +147,7 @@

          @@ -151,10 +159,8 @@

          - - - - + +

          Table of Contents @@ -175,6 +181,12 @@

          +
          + $apiStatusData + +  : ApiStatusData +
          +
          $client @@ -203,6 +215,27 @@

          Check the current status of Market Data services.
          +
          + clearApiStatusCache() + +  : void +
          +
          Clear the API status cache (useful for testing).
          + +
          + getApiStatusData() + +  : ApiStatusData +
          +
          Get the singleton ApiStatusData instance.
          + +
          + getServiceStatus() + +  : ApiStatusResult +
          +
          Get the status of a specific service.
          +
          headers() @@ -210,6 +243,20 @@

          Retrieve the headers sent by the application.
          +
          + refreshApiStatus() + +  : bool +
          +
          Manually refresh the API status cache.
          + +
          + user() + +  : User +
          +
          Retrieve rate limit information for the current user.
          +
          @@ -228,27 +275,66 @@

          phpdocumentor-element -property -private - " + -static " +> +

          + $apiStatusData + + + + +

          + + + + + + private + static ApiStatusData + $apiStatusData + = null + + +

          Static singleton instance for API status caching.

          +
          + + + + + + + +
        • @@ -283,7 +370,7 @@

          @@ -291,7 +378,7 @@

          public - __construct(Client $client) : mixed + __construct(Client $client) : mixed
          @@ -300,8 +387,8 @@

          Parameters
          - $client - : Client + $client + : Client

          The Market Data API client instance.

          @@ -312,8 +399,8 @@
          Parameters
          + -
          @@ -341,12 +428,20 @@

          api_status() : ApiStatus
          +
          APIYes
          +

          Check the current status of Market Data services and historical uptime. The status of the Market Data API is updated every 5 minutes. Historical uptime is available for the last 30 and 90 days.

          TIP: This endpoint will continue to respond with the current status of the Market Data API, even if the API is offline. This endpoint is public and does not require a token.

          +

          Uses smart caching:

          +
            +
          • If cache is fresh (< 4min30sec): Return cached data immediately, no async update
          • +
          • If cache is in refresh window (4min30sec - 5min): Return cached data immediately AND trigger async refresh
          • +
          • If cache is stale (> 5min): Block and fetch fresh data
          • +
          @@ -358,6 +453,34 @@

          + link +
          +
          +

          API Documentation

          +
          + +
          +
          + see +
          +
          + getServiceStatus() + +

          Check status of a specific service

          +
          + +
          +
          + example +
          +
          + +

          $status = $client->utilities->api_status(); +echo "30-day uptime: " . $status->uptime_30d . "%\n";

          +
          + +
          +
          throws
          @@ -367,8 +490,8 @@
          + -
          Return values
          ApiStatus @@ -378,6 +501,157 @@
          Return values
          +
          +
          +

          + clearApiStatusCache() + + +

          + + +

          Clear the API status cache (useful for testing).

          + + + public + static clearApiStatusCache() : void + +
          +
          + + + + + + + + +
          +
          +

          + getApiStatusData() + + +

          + + +

          Get the singleton ApiStatusData instance.

          + + + public + static getApiStatusData() : ApiStatusData + +
          +
          + + + + + + + +
          +
          Return values
          + ApiStatusData + — +

          The singleton instance

          +
          + +
          + +
          +
          +

          + getServiceStatus() + + +

          + + +

          Get the status of a specific service.

          + + + public + getServiceStatus(string $service) : ApiStatusResult + +
          +
          + +

          Checks if a specific service (e.g., "/v1/stocks/quotes/") is online, offline, or unknown. +Uses the same smart caching logic as api_status().

          +
          + +
          Parameters
          +
          +
          + $service + : string +
          +
          +

          The service path to check (e.g., "/v1/stocks/quotes/").

          +
          + +
          +
          + + +
          + Tags + + +
          +
          +
          + throws +
          +
          + GuzzleException|ApiException + + +
          +
          + + + +
          +
          Return values
          + ApiStatusResult + — +

          The status result (ONLINE, OFFLINE, or UNKNOWN)

          +
          + +
          +
          @@ -404,6 +678,8 @@

          headers() : Headers
          +
          APIYes
          +

          This endpoint allows users to retrieve a JSON response of the headers their application is sending, aiding in @@ -421,6 +697,24 @@

          + link +
          +
          +

          API Documentation

          +
          + +
          +
          + example +
          +
          + +

          $headers = $client->utilities->headers(); +print_r($headers->headers);

          +
          + +
          +
          throws
          @@ -430,8 +724,8 @@
          + -
          Return values
          Headers @@ -441,6 +735,156 @@
          Return values
          +

          +
          +

          + refreshApiStatus() + + +

          + + +

          Manually refresh the API status cache.

          + + + public + refreshApiStatus([bool $blocking = false ]) : bool + +
          +
          + + +
          Parameters
          +
          +
          + $blocking + : bool + = false
          +
          +

          Whether to wait for response (true) or trigger async refresh (false).

          +
          + +
          +
          + + +
          + Tags + + +
          +
          +
          + throws +
          +
          + GuzzleException|ApiException + + +
          +
          + + + +
          +
          Return values
          + bool + — +

          True on success, false on failure (only meaningful for blocking mode)

          +
          + +
          + +
          +
          +

          + user() + + +

          + + +

          Retrieve rate limit information for the current user.

          + + + public + user() : User + +
          +
          APIYes
          + +
          + +

          This endpoint returns rate limit information from response headers, including:

          +
            +
          • The maximum number of credits permitted (per day for Free/Starter/Trader plans or per minute for Prime users)
          • +
          • The number of credits remaining in the current rate period
          • +
          • The quantity of credits consumed in the current request (not cumulative)
          • +
          • When the current rate limit window resets (UTC epoch seconds)
          • +
          +

          Note: Rate limits track credits, not requests. Most requests consume 1 credit, +but bulk requests or options requests may consume multiple credits.

          +
          + + + +
          + Tags + + +
          +
          +
          + example +
          +
          + +

          $user = $client->utilities->user(); +echo "Remaining: " . $user->remaining . " / " . $user->limit . " credits\n";

          +
          + +
          +
          + throws +
          +
          + GuzzleException|ApiException + + +
          +
          + + + +
          +
          Return values
          + User + — +

          The user/rate limit information.

          +
          + +
          +
          @@ -480,6 +924,8 @@
          Return values
          if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } @@ -555,6 +1001,7 @@
          Return values
        • Properties
        • @@ -564,7 +1011,12 @@
          Return values
          diff --git a/docs/classes/MarketDataApp-Enums-ApiStatusResult.html b/docs/classes/MarketDataApp-Enums-ApiStatusResult.html new file mode 100644 index 00000000..fd4c238f --- /dev/null +++ b/docs/classes/MarketDataApp-Enums-ApiStatusResult.html @@ -0,0 +1,438 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
          +

          + MarketData SDK +

          + + + + + +
          + +
          +
          + + + + +
          +
          + + +
          +

          + ApiStatusResult + + + : string + + +
          + in package + +
          + + +

          + + + +

          Enum representing the status result of an API service.

          + + +

          Matches the Python SDK's APIStatusResult enum.

          +
          + + + + + +

          + Table of Contents + + +

          + + + + + + + + +

          + Cases + + +

          +
          +
          + OFFLINE + +  = "offline" +
          + +
          + ONLINE + +  = "online" +
          + +
          + UNKNOWN + +  = "unknown" +
          + +
          + + + + + +
          +

          + Cases + + +

          + + + +
          + + +
          +
          +
          +
          +
          
          +        
          + +
          +
          + + + +
          +
          +
          + +
          + On this page + + +
          + +
          +
          +
          +
          +
          +

          Search results

          + +
          +
          +
            +
            +
            +
            +
            + + +
            + + + + + + + + diff --git a/docs/classes/MarketDataApp-Enums-DateFormat.html b/docs/classes/MarketDataApp-Enums-DateFormat.html new file mode 100644 index 00000000..fe32f70e --- /dev/null +++ b/docs/classes/MarketDataApp-Enums-DateFormat.html @@ -0,0 +1,445 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
            +

            + MarketData SDK +

            + + + + + +
            + +
            +
            + + + + +
            +
            + + +
            +

            + DateFormat + + + : string + + +
            + in package + +
            + + +

            + + + +

            Enum DateFormat

            + + +

            Represents the available date formats for CSV API responses. +Note: This parameter can only be used when format=CSV.

            +
            + + + + + +

            + Table of Contents + + +

            + + + + + + + + +

            + Cases + + +

            +
            +
            + SPREADSHEET + +  = 'spreadsheet' +
            +
            Spreadsheet-compatible format (Excel serial date numbers).
            + +
            + TIMESTAMP + +  = 'timestamp' +
            +
            ISO timestamp format (e.g., "2023-01-20T10:30:00Z").
            + +
            + UNIX + +  = 'unix' +
            +
            Unix timestamp format (seconds since epoch, e.g., 1674210600).
            + +
            + + + + + +
            +

            + Cases + + +

            +
            +

            + TIMESTAMP + + +

            + + +

            ISO timestamp format (e.g., "2023-01-20T10:30:00Z").

            + + + + + + + +
            +
            +

            + UNIX + + +

            + + +

            Unix timestamp format (seconds since epoch, e.g., 1674210600).

            + + + + + + + +
            +
            +

            + SPREADSHEET + + +

            + + +

            Spreadsheet-compatible format (Excel serial date numbers).

            + + + + + + + +
            +
            + + +
            +
            +
            +
            +
            
            +        
            + +
            +
            + + + +
            +
            +
            + +
            + On this page + + +
            + +
            +
            +
            +
            +
            +

            Search results

            + +
            +
            +
              +
              +
              +
              +
              + + +
              + + + + + + + + diff --git a/docs/classes/MarketDataApp-Enums-Expiration.html b/docs/classes/MarketDataApp-Enums-Expiration.html index 1704239e..c71e151b 100644 --- a/docs/classes/MarketDataApp-Enums-Expiration.html +++ b/docs/classes/MarketDataApp-Enums-Expiration.html @@ -80,6 +80,14 @@

            • Exceptions +
            • +
            • + Logging + +
            • +
            • + Retry +
            • Traits @@ -143,16 +151,14 @@

              Enum Expiration

              - -

              Represents expiration options for market data queries.

              + +

              Represents expiration options for market data queries.

              + - - - - +

              Table of Contents @@ -185,7 +191,6 @@

              -

              Cases @@ -217,9 +222,8 @@

              - - - + +

              @@ -259,6 +263,8 @@

              if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/classes/MarketDataApp-Enums-Format.html b/docs/classes/MarketDataApp-Enums-Format.html index ebe674d9..25769e8a 100644 --- a/docs/classes/MarketDataApp-Enums-Format.html +++ b/docs/classes/MarketDataApp-Enums-Format.html @@ -80,6 +80,14 @@

            • Exceptions +
            • +
            • + Logging + +
            • +
            • + Retry +
            • Traits @@ -143,16 +151,14 @@

              Enum Format

              - -

              Represents the available output formats for market data responses.

              + +

              Represents the available output formats for market data responses.

              + - - - - +

              Table of Contents @@ -199,7 +205,6 @@

              -

              Cases @@ -231,9 +236,8 @@

              - - - + +
              - - -
              + +

            • - - - + +
              @@ -345,6 +347,8 @@

              if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/classes/MarketDataApp-Enums-Mode.html b/docs/classes/MarketDataApp-Enums-Mode.html new file mode 100644 index 00000000..abb518a9 --- /dev/null +++ b/docs/classes/MarketDataApp-Enums-Mode.html @@ -0,0 +1,444 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
              +

              + MarketData SDK +

              + + + + + +
              + +
              +
              + + + + +
              +
              + + +
              +

              + Mode + + + : string + + +
              + in package + +
              + + +

              + + + +

              Enum Mode

              + + +

              Represents the available data feed modes for market data requests.

              +
              + + + + + +

              + Table of Contents + + +

              + + + + + + + + +

              + Cases + + +

              +
              +
              + CACHED + +  = 'cached' +
              +
              Represents cached data.
              + +
              + DELAYED + +  = 'delayed' +
              +
              Represents delayed data.
              + +
              + LIVE + +  = 'live' +
              +
              Represents live market data.
              + +
              + + + + + +
              +

              + Cases + + +

              +
              +

              + LIVE + + +

              + + +

              Represents live market data.

              + + + + + + + +
              +
              +

              + CACHED + + +

              + + +

              Represents cached data.

              + + + + + + + +
              +
              +

              + DELAYED + + +

              + + +

              Represents delayed data.

              + + + + + + + +
              +
              + + +
              +
              +
              +
              +
              
              +        
              + +
              +
              + + + +
              +
              +
              + +
              + On this page + + +
              + +
              +
              +
              +
              +
              +

              Search results

              + +
              +
              +
                +
                +
                +
                +
                + + +
                + + + + + + + + diff --git a/docs/classes/MarketDataApp-Enums-Range.html b/docs/classes/MarketDataApp-Enums-Range.html index 4110a0d3..e6077cd8 100644 --- a/docs/classes/MarketDataApp-Enums-Range.html +++ b/docs/classes/MarketDataApp-Enums-Range.html @@ -80,6 +80,14 @@

              • Exceptions +
              • +
              • + Logging + +
              • +
              • + Retry +
              • Traits @@ -143,16 +151,14 @@

                Enum Range

                - -

                Represents the range options for market data queries.

                + +

                Represents the range options for market data queries.

                + - - - - +

                Table of Contents @@ -199,7 +205,6 @@

                -

                Cases @@ -231,9 +236,8 @@

                - - - + +
                - - -
                + +
                - - -
                + +

                @@ -329,6 +331,8 @@

                if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/classes/MarketDataApp-Enums-Side.html b/docs/classes/MarketDataApp-Enums-Side.html index 75983b2e..8e3eae3f 100644 --- a/docs/classes/MarketDataApp-Enums-Side.html +++ b/docs/classes/MarketDataApp-Enums-Side.html @@ -80,6 +80,14 @@

              • Exceptions +
              • +
              • + Logging + +
              • +
              • + Retry +
              • Traits @@ -143,16 +151,14 @@

                Enum Side

                - -

                Represents the types of options in options trading.

                + +

                Represents the types of options in options trading.

                + - - - - +

                Table of Contents @@ -192,7 +198,6 @@

                -

                Cases @@ -227,9 +232,8 @@

                - - - + +
                - - -
                + +

                @@ -300,6 +303,8 @@

                if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/classes/MarketDataApp-Exceptions-ApiException.html b/docs/classes/MarketDataApp-Exceptions-ApiException.html index 80739b98..7a27f863 100644 --- a/docs/classes/MarketDataApp-Exceptions-ApiException.html +++ b/docs/classes/MarketDataApp-Exceptions-ApiException.html @@ -80,6 +80,14 @@

              • Exceptions +
              • +
              • + Logging + +
              • +
              • + Retry +
              • Traits @@ -121,7 +129,7 @@

                ApiException - extends Exception + extends MarketDataException
                @@ -142,23 +150,22 @@

                ApiException class

                -

                This exception is thrown when an API error occurs. It extends the base PHP Exception class -and adds functionality to store and retrieve the API response.

                +

                This exception is thrown when an API error occurs (business logic errors like +"no data found" or invalid symbol). It extends the base MarketDataException class +and provides access to request context for debugging and support.

                - - - - + +

                Table of Contents @@ -179,10 +186,28 @@

                -
                - $response +
                + $requestId + +  : string|null +
                + +
                + $requestUrl + +  : string|null +
                + +
                + $response + +  : ResponseInterface|null +
                + +
                + $timestamp -  : mixed +  : DateTimeImmutable
                @@ -201,11 +226,60 @@

                ApiException constructor.
                - getResponse() + __toString() -  : mixed +  : string +
                +
                Get string representation of the exception.
                + +
                + getRequestId() + +  : string|null +
                +
                Get the Cloudflare request ID for support tickets.
                + +
                + getRequestUrl() + +  : string|null +
                +
                Get the URL that was requested when the error occurred.
                + +
                + getResponse() + +  : ResponseInterface|null +
                +
                Get the HTTP response associated with this exception.
                + +
                + getSupportContext() + +  : array<string|int, mixed> +
                +
                Get all support ticket context as an associative array.
                + +
                + getSupportInfo() + +  : string +
                +
                Get a pre-formatted string with all information needed for a support ticket.
                + +
                + getTimestamp() + +  : DateTimeImmutable +
                +
                Get the timestamp when the exception occurred.
                + +
                + extractRequestId() + +  : string|null
                -
                Get the API response associated with this exception.
                +
                Extract the request ID (cf-ray header) from the response.

              • @@ -224,39 +298,157 @@

                class=" phpdocumentor-element -property - -private - " + -protected + " +> +

                + $requestId + + + + +

                + + + + + + protected + string|null + $requestId + + + +

                The Cloudflare request ID (cf-ray header) for support tickets.

                +
                + + + + + + + +
                +

                + $requestUrl + + + + +

                + + + + + + protected + string|null + $requestUrl + + + +

                The URL that was requested when the error occurred.

                +
                + + + + + + +
                +

                $response - + - +

                - private - mixed + protected + ResponseInterface|null $response -

                The API response associated with this exception.

                +

                The HTTP response associated with this exception.

                + + + +
                +
                +

                + $timestamp + + + + +

                + + + + + + protected + DateTimeImmutable + $timestamp + + + +

                The timestamp when the exception occurred (stored in UTC).

                +
                + + + +
                @@ -280,7 +472,7 @@

                @@ -288,7 +480,7 @@

                public - __construct(string $message[, int $code = 0 ][, Exception|null $previous = null ][, mixed $response = null ]) : mixed + __construct(string $message[, int $code = 0 ][, Throwable|null $previous = null ][, ResponseInterface|null $response = null ][, string|null $requestUrl = null ]) : mixed
                @@ -297,8 +489,8 @@

                Parameters
                - $message - : string + $message + : string

                The exception message.

                @@ -306,29 +498,38 @@
                Parameters
                - $code - : int - = 0
                + $code + : int + = 0

                The exception code.

                - $previous - : Exception|null - = null
                + $previous + : Throwable|null + = null

                The previous exception used for exception chaining.

                - $response - : mixed - = null
                + $response + : ResponseInterface|null + = null +
                +

                The HTTP response associated with this exception.

                +
                + +
                +
                + $requestUrl + : string|null + = null
                -

                The API response associated with this exception.

                +

                The URL that was requested when the error occurred.

                @@ -336,9 +537,140 @@
                Parameters
                + + + + +
                +

                + __toString() + + +

                + + +

                Get string representation of the exception.

                + + + public + __toString() : string + +
                +
                + +

                Includes the standard exception information plus request context +(timestamp, request ID, and URL) when available.

                +
                + + + + + + +
                +
                Return values
                + string +
                + +
                +
                +

                + getRequestId() + + +

                + + +

                Get the Cloudflare request ID for support tickets.

                + + + public + getRequestId() : string|null + +
                +
                + +

                This ID can be provided to Market Data support to help identify +the specific request that failed.

                +
                + + + + + + +
                +
                Return values
                + string|null + — +

                The request ID, or null if not available.

                +
                + +
                + +
                +
                +

                + getRequestUrl() + + +

                + + +

                Get the URL that was requested when the error occurred.

                + + + public + getRequestUrl() : string|null + +
                +
                + + + + +
                +
                Return values
                + string|null + — +

                The request URL, or null if not available.

                +
                + +
                +
                Parameters >

                getResponse() - + + +

                + + +

                Get the HTTP response associated with this exception.

                + + + public + getResponse() : ResponseInterface|null + +
                +
                + + + + + + + +
                +
                Return values
                + ResponseInterface|null + — +

                The HTTP response.

                +
                + +
                + +
                +
                +

                + getSupportContext() +

                -

                Get the API response associated with this exception.

                +

                Get all support ticket context as an associative array.

                public - getResponse() : mixed + getSupportContext() : array<string|int, mixed>
                +

                Get support context as an associative array.

                +
                + + + +
                +
                Return values
                + array<string|int, mixed> +
                +
                +
                +

                + getSupportInfo() + + +

                + + +

                Get a pre-formatted string with all information needed for a support ticket.

                + + + public + getSupportInfo() : string + +
                +
                + +

                Get pre-formatted support ticket information.

                +
                + + + + + +
                +
                Return values
                + string +
                + +
                +
                +

                + getTimestamp() + + +

                + + +

                Get the timestamp when the exception occurred.

                + + + public + getTimestamp() : DateTimeImmutable +
                +
                + +

                The timestamp is stored in UTC. Convert to your preferred timezone as needed:

                +
                $localTime = $e->getTimestamp()->setTimezone(new \DateTimeZone('America/Los_Angeles'));
                +
                +
                + + + + + + +
                +
                Return values
                + DateTimeImmutable + — +

                The timestamp when the exception was created (UTC).

                +
                + +
                + +
                +
                +

                + extractRequestId() + + +

                + + +

                Extract the request ID (cf-ray header) from the response.

                + + + protected + extractRequestId(ResponseInterface|null $response) : string|null + +
                +
                + + +
                Parameters
                +
                +
                + $response + : ResponseInterface|null +
                +
                +

                The HTTP response.

                +
                + +
                +
                + + + + +
                Return values
                - mixed + string|null — -

                The API response.

                +

                The request ID, or null if not available.

                @@ -421,6 +937,8 @@
                Return values
                if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } @@ -496,7 +1014,10 @@
                Return values
              • Properties
              • @@ -504,7 +1025,14 @@
                Return values
              • diff --git a/docs/classes/MarketDataApp-Exceptions-BadStatusCodeError.html b/docs/classes/MarketDataApp-Exceptions-BadStatusCodeError.html new file mode 100644 index 00000000..4ad7485f --- /dev/null +++ b/docs/classes/MarketDataApp-Exceptions-BadStatusCodeError.html @@ -0,0 +1,1066 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                +

                + MarketData SDK +

                + + + + + +
                + +
                +
                + + + + +
                +
                + + +
                +

                + BadStatusCodeError + + + extends MarketDataException + + +
                + in package + +
                + + +

                + +
                + + +
                + + + +

                BadStatusCodeError class

                + + +

                This exception is raised for permanent HTTP errors (4xx) +that should not trigger retry logic.

                +
                + + + + + +

                + Table of Contents + + +

                + + + + + + + + + +

                + Properties + + +

                +
                +
                + $requestId + +  : string|null +
                + +
                + $requestUrl + +  : string|null +
                + +
                + $response + +  : ResponseInterface|null +
                + +
                + $timestamp + +  : DateTimeImmutable +
                + +
                + +

                + Methods + + +

                +
                +
                + __construct() + +  : mixed +
                +
                BadStatusCodeError constructor.
                + +
                + __toString() + +  : string +
                +
                Get string representation of the exception.
                + +
                + getRequestId() + +  : string|null +
                +
                Get the Cloudflare request ID for support tickets.
                + +
                + getRequestUrl() + +  : string|null +
                +
                Get the URL that was requested when the error occurred.
                + +
                + getResponse() + +  : ResponseInterface|null +
                +
                Get the HTTP response associated with this exception.
                + +
                + getSupportContext() + +  : array<string|int, mixed> +
                +
                Get all support ticket context as an associative array.
                + +
                + getSupportInfo() + +  : string +
                +
                Get a pre-formatted string with all information needed for a support ticket.
                + +
                + getTimestamp() + +  : DateTimeImmutable +
                +
                Get the timestamp when the exception occurred.
                + +
                + extractRequestId() + +  : string|null +
                +
                Extract the request ID (cf-ray header) from the response.
                + +
                + + + + + + +
                +

                + Properties + + +

                +
                +

                + $requestId + + + + +

                + + + + + + protected + string|null + $requestId + + + +

                The Cloudflare request ID (cf-ray header) for support tickets.

                +
                + + + + + + +
                +
                +

                + $requestUrl + + + + +

                + + + + + + protected + string|null + $requestUrl + + + +

                The URL that was requested when the error occurred.

                +
                + + + + + + +
                +
                +

                + $response + + + + +

                + + + + + + protected + ResponseInterface|null + $response + + + +

                The HTTP response associated with this exception.

                +
                + + + + + + +
                +
                +

                + $timestamp + + + + +

                + + + + + + protected + DateTimeImmutable + $timestamp + + + +

                The timestamp when the exception occurred (stored in UTC).

                +
                + + + + + + +
                +
                + +
                +

                + Methods + + +

                +
                +

                + __construct() + + +

                + + +

                BadStatusCodeError constructor.

                + + + public + __construct([string $message = "" ][, int $code = 0 ][, Throwable|null $previous = null ][, ResponseInterface|null $response = null ][, string|null $requestUrl = null ]) : mixed + +
                +
                + + +
                Parameters
                +
                +
                + $message + : string + = ""
                +
                +

                The exception message.

                +
                + +
                +
                + $code + : int + = 0
                +
                +

                The exception code.

                +
                + +
                +
                + $previous + : Throwable|null + = null
                +
                +

                The previous exception used for exception chaining.

                +
                + +
                +
                + $response + : ResponseInterface|null + = null
                +
                +

                The HTTP response associated with this exception.

                +
                + +
                +
                + $requestUrl + : string|null + = null
                +
                +

                The URL that was requested when the error occurred.

                +
                + +
                +
                + + + + + + +
                +
                +

                + __toString() + + +

                + + +

                Get string representation of the exception.

                + + + public + __toString() : string + +
                +
                + +

                Includes the standard exception information plus request context +(timestamp, request ID, and URL) when available.

                +
                + + + + + + +
                +
                Return values
                + string +
                + +
                +
                +

                + getRequestId() + + +

                + + +

                Get the Cloudflare request ID for support tickets.

                + + + public + getRequestId() : string|null + +
                +
                + +

                This ID can be provided to Market Data support to help identify +the specific request that failed.

                +
                + + + + + + +
                +
                Return values
                + string|null + — +

                The request ID, or null if not available.

                +
                + +
                + +
                +
                +

                + getRequestUrl() + + +

                + + +

                Get the URL that was requested when the error occurred.

                + + + public + getRequestUrl() : string|null + +
                +
                + + + + + + + +
                +
                Return values
                + string|null + — +

                The request URL, or null if not available.

                +
                + +
                + +
                +
                +

                + getResponse() + + +

                + + +

                Get the HTTP response associated with this exception.

                + + + public + getResponse() : ResponseInterface|null + +
                +
                + + + + + + + +
                +
                Return values
                + ResponseInterface|null + — +

                The HTTP response.

                +
                + +
                + +
                +
                +

                + getSupportContext() + + +

                + + +

                Get all support ticket context as an associative array.

                + + + public + getSupportContext() : array<string|int, mixed> + +
                +
                + +

                Get support context as an associative array.

                +
                + + + + + + +
                +
                Return values
                + array<string|int, mixed> +
                + +
                +
                +

                + getSupportInfo() + + +

                + + +

                Get a pre-formatted string with all information needed for a support ticket.

                + + + public + getSupportInfo() : string + +
                +
                + +

                Get pre-formatted support ticket information.

                +
                + + + + + + +
                +
                Return values
                + string +
                + +
                +
                +

                + getTimestamp() + + +

                + + +

                Get the timestamp when the exception occurred.

                + + + public + getTimestamp() : DateTimeImmutable + +
                +
                + +

                The timestamp is stored in UTC. Convert to your preferred timezone as needed:

                +
                $localTime = $e->getTimestamp()->setTimezone(new \DateTimeZone('America/Los_Angeles'));
                +
                +
                + + + + + + +
                +
                Return values
                + DateTimeImmutable + — +

                The timestamp when the exception was created (UTC).

                +
                + +
                + +
                +
                +

                + extractRequestId() + + +

                + + +

                Extract the request ID (cf-ray header) from the response.

                + + + protected + extractRequestId(ResponseInterface|null $response) : string|null + +
                +
                + + +
                Parameters
                +
                +
                + $response + : ResponseInterface|null +
                +
                +

                The HTTP response.

                +
                + +
                +
                + + + + + +
                +
                Return values
                + string|null + — +

                The request ID, or null if not available.

                +
                + +
                + +
                +
                + +
                +
                +
                +
                +
                
                +        
                + +
                +
                + + + +
                +
                +
                + +
                + On this page + + +
                + +
                +
                +
                +
                +
                +

                Search results

                + +
                +
                +
                  +
                  +
                  +
                  +
                  + + +
                  + + + + + + + + diff --git a/docs/classes/MarketDataApp-Exceptions-MarketDataException.html b/docs/classes/MarketDataApp-Exceptions-MarketDataException.html new file mode 100644 index 00000000..23dc3873 --- /dev/null +++ b/docs/classes/MarketDataApp-Exceptions-MarketDataException.html @@ -0,0 +1,1083 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                  +

                  + MarketData SDK +

                  + + + + + +
                  + +
                  +
                  + + + + +
                  +
                  + + +
                  +

                  + MarketDataException + + + extends Exception + + +
                  + in package + +
                  + + +

                  + +
                  + + +
                  + + + +

                  Base exception class for all Market Data SDK exceptions.

                  + + +

                  This class provides common functionality for storing and retrieving +request context including the request ID (cf-ray header), request URL, +timestamp, and HTTP response. All SDK exception classes extend from this base.

                  +
                  + + + + + +

                  + Table of Contents + + +

                  + + + + + + + + + +

                  + Properties + + +

                  +
                  +
                  + $requestId + +  : string|null +
                  + +
                  + $requestUrl + +  : string|null +
                  + +
                  + $response + +  : ResponseInterface|null +
                  + +
                  + $timestamp + +  : DateTimeImmutable +
                  + +
                  + +

                  + Methods + + +

                  +
                  +
                  + __construct() + +  : mixed +
                  +
                  MarketDataException constructor.
                  + +
                  + __toString() + +  : string +
                  +
                  Get string representation of the exception.
                  + +
                  + getRequestId() + +  : string|null +
                  +
                  Get the Cloudflare request ID for support tickets.
                  + +
                  + getRequestUrl() + +  : string|null +
                  +
                  Get the URL that was requested when the error occurred.
                  + +
                  + getResponse() + +  : ResponseInterface|null +
                  +
                  Get the HTTP response associated with this exception.
                  + +
                  + getSupportContext() + +  : array{timestamp: string, request_id: string|null, url: string|null, http_code: int, message: string, exception_type: string} +
                  +
                  Get all support ticket context as an associative array.
                  + +
                  + getSupportInfo() + +  : string +
                  +
                  Get a pre-formatted string with all information needed for a support ticket.
                  + +
                  + getTimestamp() + +  : DateTimeImmutable +
                  +
                  Get the timestamp when the exception occurred.
                  + +
                  + extractRequestId() + +  : string|null +
                  +
                  Extract the request ID (cf-ray header) from the response.
                  + +
                  + + + + + + +
                  +

                  + Properties + + +

                  +
                  +

                  + $requestId + + + + +

                  + + + + + + protected + string|null + $requestId + + + +

                  The Cloudflare request ID (cf-ray header) for support tickets.

                  +
                  + + + + + + +
                  +
                  +

                  + $requestUrl + + + + +

                  + + + + + + protected + string|null + $requestUrl + + + +

                  The URL that was requested when the error occurred.

                  +
                  + + + + + + +
                  +
                  +

                  + $response + + + + +

                  + + + + + + protected + ResponseInterface|null + $response + + + +

                  The HTTP response associated with this exception.

                  +
                  + + + + + + +
                  +
                  +

                  + $timestamp + + + + +

                  + + + + + + protected + DateTimeImmutable + $timestamp + + + +

                  The timestamp when the exception occurred (stored in UTC).

                  +
                  + + + + + + +
                  +
                  + +
                  +

                  + Methods + + +

                  +
                  +

                  + __construct() + + +

                  + + +

                  MarketDataException constructor.

                  + + + public + __construct([string $message = "" ][, int $code = 0 ][, Throwable|null $previous = null ][, ResponseInterface|null $response = null ][, string|null $requestUrl = null ]) : mixed + +
                  +
                  + + +
                  Parameters
                  +
                  +
                  + $message + : string + = ""
                  +
                  +

                  The exception message.

                  +
                  + +
                  +
                  + $code + : int + = 0
                  +
                  +

                  The exception code.

                  +
                  + +
                  +
                  + $previous + : Throwable|null + = null
                  +
                  +

                  The previous exception used for exception chaining.

                  +
                  + +
                  +
                  + $response + : ResponseInterface|null + = null
                  +
                  +

                  The HTTP response associated with this exception.

                  +
                  + +
                  +
                  + $requestUrl + : string|null + = null
                  +
                  +

                  The URL that was requested when the error occurred.

                  +
                  + +
                  +
                  + + + + + + +
                  +
                  +

                  + __toString() + + +

                  + + +

                  Get string representation of the exception.

                  + + + public + __toString() : string + +
                  +
                  + +

                  Includes the standard exception information plus request context +(timestamp, request ID, and URL) when available.

                  +
                  + + + + + + +
                  +
                  Return values
                  + string +
                  + +
                  +
                  +

                  + getRequestId() + + +

                  + + +

                  Get the Cloudflare request ID for support tickets.

                  + + + public + getRequestId() : string|null + +
                  +
                  + +

                  This ID can be provided to Market Data support to help identify +the specific request that failed.

                  +
                  + + + + + + +
                  +
                  Return values
                  + string|null + — +

                  The request ID, or null if not available.

                  +
                  + +
                  + +
                  +
                  +

                  + getRequestUrl() + + +

                  + + +

                  Get the URL that was requested when the error occurred.

                  + + + public + getRequestUrl() : string|null + +
                  +
                  + + + + + + + +
                  +
                  Return values
                  + string|null + — +

                  The request URL, or null if not available.

                  +
                  + +
                  + +
                  +
                  +

                  + getResponse() + + +

                  + + +

                  Get the HTTP response associated with this exception.

                  + + + public + getResponse() : ResponseInterface|null + +
                  +
                  + + + + + + + +
                  +
                  Return values
                  + ResponseInterface|null + — +

                  The HTTP response.

                  +
                  + +
                  + +
                  +
                  +

                  + getSupportContext() + + +

                  + + +

                  Get all support ticket context as an associative array.

                  + + + public + getSupportContext() : array{timestamp: string, request_id: string|null, url: string|null, http_code: int, message: string, exception_type: string} + +
                  +
                  + +

                  This is useful for structured logging (JSON, log aggregation systems) +or when you need to process the error details programmatically.

                  +

                  Example:

                  +
                  catch (MarketDataException $e) {
                  +    $logger->error('API Error', $e->getSupportContext());
                  +}
                  +
                  +
                  + + + + + + +
                  +
                  Return values
                  + array{timestamp: string, request_id: string|null, url: string|null, http_code: int, message: string, exception_type: string} +
                  + +
                  +
                  +

                  + getSupportInfo() + + +

                  + + +

                  Get a pre-formatted string with all information needed for a support ticket.

                  + + + public + getSupportInfo() : string + +
                  +
                  + +

                  Copy and paste this output directly into your support request at +support@marketdata.app or in the customer dashboard.

                  +

                  Example:

                  +
                  catch (MarketDataException $e) {
                  +    echo $e->getSupportInfo();
                  +}
                  +
                  +
                  + + + + + + +
                  +
                  Return values
                  + string + — +

                  Formatted support ticket information.

                  +
                  + +
                  + +
                  +
                  +

                  + getTimestamp() + + +

                  + + +

                  Get the timestamp when the exception occurred.

                  + + + public + getTimestamp() : DateTimeImmutable + +
                  +
                  + +

                  The timestamp is stored in UTC. Convert to your preferred timezone as needed:

                  +
                  $localTime = $e->getTimestamp()->setTimezone(new \DateTimeZone('America/Los_Angeles'));
                  +
                  +
                  + + + + + + +
                  +
                  Return values
                  + DateTimeImmutable + — +

                  The timestamp when the exception was created (UTC).

                  +
                  + +
                  + +
                  +
                  +

                  + extractRequestId() + + +

                  + + +

                  Extract the request ID (cf-ray header) from the response.

                  + + + protected + extractRequestId(ResponseInterface|null $response) : string|null + +
                  +
                  + + +
                  Parameters
                  +
                  +
                  + $response + : ResponseInterface|null +
                  +
                  +

                  The HTTP response.

                  +
                  + +
                  +
                  + + + + + +
                  +
                  Return values
                  + string|null + — +

                  The request ID, or null if not available.

                  +
                  + +
                  + +
                  +
                  + +
                  +
                  +
                  +
                  +
                  
                  +        
                  + +
                  +
                  + + + +
                  +
                  +
                  + +
                  + On this page + + +
                  + +
                  +
                  +
                  +
                  +
                  +

                  Search results

                  + +
                  +
                  +
                    +
                    +
                    +
                    +
                    + + +
                    + + + + + + + + diff --git a/docs/classes/MarketDataApp-Exceptions-RequestError.html b/docs/classes/MarketDataApp-Exceptions-RequestError.html new file mode 100644 index 00000000..a1dabc34 --- /dev/null +++ b/docs/classes/MarketDataApp-Exceptions-RequestError.html @@ -0,0 +1,1066 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                    +

                    + MarketData SDK +

                    + + + + + +
                    + +
                    +
                    + + + + +
                    +
                    + + +
                    +

                    + RequestError + + + extends MarketDataException + + +
                    + in package + +
                    + + +

                    + +
                    + + +
                    + + + +

                    RequestError class

                    + + +

                    This exception is raised for transient HTTP errors (5xx, timeout, etc.) +that should trigger retry logic.

                    +
                    + + + + + +

                    + Table of Contents + + +

                    + + + + + + + + + +

                    + Properties + + +

                    +
                    +
                    + $requestId + +  : string|null +
                    + +
                    + $requestUrl + +  : string|null +
                    + +
                    + $response + +  : ResponseInterface|null +
                    + +
                    + $timestamp + +  : DateTimeImmutable +
                    + +
                    + +

                    + Methods + + +

                    +
                    +
                    + __construct() + +  : mixed +
                    +
                    RequestError constructor.
                    + +
                    + __toString() + +  : string +
                    +
                    Get string representation of the exception.
                    + +
                    + getRequestId() + +  : string|null +
                    +
                    Get the Cloudflare request ID for support tickets.
                    + +
                    + getRequestUrl() + +  : string|null +
                    +
                    Get the URL that was requested when the error occurred.
                    + +
                    + getResponse() + +  : ResponseInterface|null +
                    +
                    Get the HTTP response associated with this exception.
                    + +
                    + getSupportContext() + +  : array<string|int, mixed> +
                    +
                    Get all support ticket context as an associative array.
                    + +
                    + getSupportInfo() + +  : string +
                    +
                    Get a pre-formatted string with all information needed for a support ticket.
                    + +
                    + getTimestamp() + +  : DateTimeImmutable +
                    +
                    Get the timestamp when the exception occurred.
                    + +
                    + extractRequestId() + +  : string|null +
                    +
                    Extract the request ID (cf-ray header) from the response.
                    + +
                    + + + + + + +
                    +

                    + Properties + + +

                    +
                    +

                    + $requestId + + + + +

                    + + + + + + protected + string|null + $requestId + + + +

                    The Cloudflare request ID (cf-ray header) for support tickets.

                    +
                    + + + + + + +
                    +
                    +

                    + $requestUrl + + + + +

                    + + + + + + protected + string|null + $requestUrl + + + +

                    The URL that was requested when the error occurred.

                    +
                    + + + + + + +
                    +
                    +

                    + $response + + + + +

                    + + + + + + protected + ResponseInterface|null + $response + + + +

                    The HTTP response associated with this exception.

                    +
                    + + + + + + +
                    +
                    +

                    + $timestamp + + + + +

                    + + + + + + protected + DateTimeImmutable + $timestamp + + + +

                    The timestamp when the exception occurred (stored in UTC).

                    +
                    + + + + + + +
                    +
                    + +
                    +

                    + Methods + + +

                    +
                    +

                    + __construct() + + +

                    + + +

                    RequestError constructor.

                    + + + public + __construct([string $message = "" ][, int $code = 0 ][, Throwable|null $previous = null ][, ResponseInterface|null $response = null ][, string|null $requestUrl = null ]) : mixed + +
                    +
                    + + +
                    Parameters
                    +
                    +
                    + $message + : string + = ""
                    +
                    +

                    The exception message.

                    +
                    + +
                    +
                    + $code + : int + = 0
                    +
                    +

                    The exception code.

                    +
                    + +
                    +
                    + $previous + : Throwable|null + = null
                    +
                    +

                    The previous exception used for exception chaining.

                    +
                    + +
                    +
                    + $response + : ResponseInterface|null + = null
                    +
                    +

                    The HTTP response associated with this exception.

                    +
                    + +
                    +
                    + $requestUrl + : string|null + = null
                    +
                    +

                    The URL that was requested when the error occurred.

                    +
                    + +
                    +
                    + + + + + + +
                    +
                    +

                    + __toString() + + +

                    + + +

                    Get string representation of the exception.

                    + + + public + __toString() : string + +
                    +
                    + +

                    Includes the standard exception information plus request context +(timestamp, request ID, and URL) when available.

                    +
                    + + + + + + +
                    +
                    Return values
                    + string +
                    + +
                    +
                    +

                    + getRequestId() + + +

                    + + +

                    Get the Cloudflare request ID for support tickets.

                    + + + public + getRequestId() : string|null + +
                    +
                    + +

                    This ID can be provided to Market Data support to help identify +the specific request that failed.

                    +
                    + + + + + + +
                    +
                    Return values
                    + string|null + — +

                    The request ID, or null if not available.

                    +
                    + +
                    + +
                    +
                    +

                    + getRequestUrl() + + +

                    + + +

                    Get the URL that was requested when the error occurred.

                    + + + public + getRequestUrl() : string|null + +
                    +
                    + + + + + + + +
                    +
                    Return values
                    + string|null + — +

                    The request URL, or null if not available.

                    +
                    + +
                    + +
                    +
                    +

                    + getResponse() + + +

                    + + +

                    Get the HTTP response associated with this exception.

                    + + + public + getResponse() : ResponseInterface|null + +
                    +
                    + + + + + + + +
                    +
                    Return values
                    + ResponseInterface|null + — +

                    The HTTP response.

                    +
                    + +
                    + +
                    +
                    +

                    + getSupportContext() + + +

                    + + +

                    Get all support ticket context as an associative array.

                    + + + public + getSupportContext() : array<string|int, mixed> + +
                    +
                    + +

                    Get support context as an associative array.

                    +
                    + + + + + + +
                    +
                    Return values
                    + array<string|int, mixed> +
                    + +
                    +
                    +

                    + getSupportInfo() + + +

                    + + +

                    Get a pre-formatted string with all information needed for a support ticket.

                    + + + public + getSupportInfo() : string + +
                    +
                    + +

                    Get pre-formatted support ticket information.

                    +
                    + + + + + + +
                    +
                    Return values
                    + string +
                    + +
                    +
                    +

                    + getTimestamp() + + +

                    + + +

                    Get the timestamp when the exception occurred.

                    + + + public + getTimestamp() : DateTimeImmutable + +
                    +
                    + +

                    The timestamp is stored in UTC. Convert to your preferred timezone as needed:

                    +
                    $localTime = $e->getTimestamp()->setTimezone(new \DateTimeZone('America/Los_Angeles'));
                    +
                    +
                    + + + + + + +
                    +
                    Return values
                    + DateTimeImmutable + — +

                    The timestamp when the exception was created (UTC).

                    +
                    + +
                    + +
                    +
                    +

                    + extractRequestId() + + +

                    + + +

                    Extract the request ID (cf-ray header) from the response.

                    + + + protected + extractRequestId(ResponseInterface|null $response) : string|null + +
                    +
                    + + +
                    Parameters
                    +
                    +
                    + $response + : ResponseInterface|null +
                    +
                    +

                    The HTTP response.

                    +
                    + +
                    +
                    + + + + + +
                    +
                    Return values
                    + string|null + — +

                    The request ID, or null if not available.

                    +
                    + +
                    + +
                    +
                    + +
                    +
                    +
                    +
                    +
                    
                    +        
                    + +
                    +
                    + + + +
                    +
                    +
                    + +
                    + On this page + + +
                    + +
                    +
                    +
                    +
                    +
                    +

                    Search results

                    + +
                    +
                    +
                      +
                      +
                      +
                      +
                      + + +
                      + + + + + + + + diff --git a/docs/classes/MarketDataApp-Exceptions-UnauthorizedException.html b/docs/classes/MarketDataApp-Exceptions-UnauthorizedException.html new file mode 100644 index 00000000..2e055047 --- /dev/null +++ b/docs/classes/MarketDataApp-Exceptions-UnauthorizedException.html @@ -0,0 +1,1066 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                      +

                      + MarketData SDK +

                      + + + + + +
                      + +
                      +
                      + + + + +
                      +
                      + + +
                      +

                      + UnauthorizedException + + + extends BadStatusCodeError + + +
                      + in package + +
                      + + +

                      + +
                      + + +
                      + + + +

                      UnauthorizedException class

                      + + +

                      This exception is raised for 401 UNAUTHORIZED HTTP errors. +This error means: The token supplied with the request is missing, invalid, or cannot be used.

                      +
                      + + + + + +

                      + Table of Contents + + +

                      + + + + + + + + + +

                      + Properties + + +

                      +
                      +
                      + $requestId + +  : string|null +
                      + +
                      + $requestUrl + +  : string|null +
                      + +
                      + $response + +  : ResponseInterface|null +
                      + +
                      + $timestamp + +  : DateTimeImmutable +
                      + +
                      + +

                      + Methods + + +

                      +
                      +
                      + __construct() + +  : mixed +
                      +
                      UnauthorizedException constructor.
                      + +
                      + __toString() + +  : string +
                      +
                      Get string representation of the exception.
                      + +
                      + getRequestId() + +  : string|null +
                      +
                      Get the Cloudflare request ID for support tickets.
                      + +
                      + getRequestUrl() + +  : string|null +
                      +
                      Get the URL that was requested when the error occurred.
                      + +
                      + getResponse() + +  : ResponseInterface|null +
                      +
                      Get the HTTP response associated with this exception.
                      + +
                      + getSupportContext() + +  : array<string|int, mixed> +
                      +
                      Get all support ticket context as an associative array.
                      + +
                      + getSupportInfo() + +  : string +
                      +
                      Get a pre-formatted string with all information needed for a support ticket.
                      + +
                      + getTimestamp() + +  : DateTimeImmutable +
                      +
                      Get the timestamp when the exception occurred.
                      + +
                      + extractRequestId() + +  : string|null +
                      +
                      Extract the request ID (cf-ray header) from the response.
                      + +
                      + + + + + + +
                      +

                      + Properties + + +

                      +
                      +

                      + $requestId + + + + +

                      + + + + + + protected + string|null + $requestId + + + +

                      The Cloudflare request ID (cf-ray header) for support tickets.

                      +
                      + + + + + + +
                      +
                      +

                      + $requestUrl + + + + +

                      + + + + + + protected + string|null + $requestUrl + + + +

                      The URL that was requested when the error occurred.

                      +
                      + + + + + + +
                      +
                      +

                      + $response + + + + +

                      + + + + + + protected + ResponseInterface|null + $response + + + +

                      The HTTP response associated with this exception.

                      +
                      + + + + + + +
                      +
                      +

                      + $timestamp + + + + +

                      + + + + + + protected + DateTimeImmutable + $timestamp + + + +

                      The timestamp when the exception occurred (stored in UTC).

                      +
                      + + + + + + +
                      +
                      + +
                      +

                      + Methods + + +

                      +
                      +

                      + __construct() + + +

                      + + +

                      UnauthorizedException constructor.

                      + + + public + __construct([string $message = "" ][, int $code = 401 ][, Throwable|null $previous = null ][, ResponseInterface|null $response = null ][, string|null $requestUrl = null ]) : mixed + +
                      +
                      + + +
                      Parameters
                      +
                      +
                      + $message + : string + = ""
                      +
                      +

                      The exception message.

                      +
                      + +
                      +
                      + $code + : int + = 401
                      +
                      +

                      The exception code (should be 401).

                      +
                      + +
                      +
                      + $previous + : Throwable|null + = null
                      +
                      +

                      The previous exception used for exception chaining.

                      +
                      + +
                      +
                      + $response + : ResponseInterface|null + = null
                      +
                      +

                      The HTTP response associated with this exception.

                      +
                      + +
                      +
                      + $requestUrl + : string|null + = null
                      +
                      +

                      The URL that was requested when the error occurred.

                      +
                      + +
                      +
                      + + + + + + +
                      +
                      +

                      + __toString() + + +

                      + + +

                      Get string representation of the exception.

                      + + + public + __toString() : string + +
                      +
                      + +

                      Includes the standard exception information plus request context +(timestamp, request ID, and URL) when available.

                      +
                      + + + + + + +
                      +
                      Return values
                      + string +
                      + +
                      +
                      +

                      + getRequestId() + + +

                      + + +

                      Get the Cloudflare request ID for support tickets.

                      + + + public + getRequestId() : string|null + +
                      +
                      + +

                      This ID can be provided to Market Data support to help identify +the specific request that failed.

                      +
                      + + + + + + +
                      +
                      Return values
                      + string|null + — +

                      The request ID, or null if not available.

                      +
                      + +
                      + +
                      +
                      +

                      + getRequestUrl() + + +

                      + + +

                      Get the URL that was requested when the error occurred.

                      + + + public + getRequestUrl() : string|null + +
                      +
                      + + + + + + + +
                      +
                      Return values
                      + string|null + — +

                      The request URL, or null if not available.

                      +
                      + +
                      + +
                      +
                      +

                      + getResponse() + + +

                      + + +

                      Get the HTTP response associated with this exception.

                      + + + public + getResponse() : ResponseInterface|null + +
                      +
                      + + + + + + + +
                      +
                      Return values
                      + ResponseInterface|null + — +

                      The HTTP response.

                      +
                      + +
                      + +
                      +
                      +

                      + getSupportContext() + + +

                      + + +

                      Get all support ticket context as an associative array.

                      + + + public + getSupportContext() : array<string|int, mixed> + +
                      +
                      + +

                      Get support context as an associative array.

                      +
                      + + + + + + +
                      +
                      Return values
                      + array<string|int, mixed> +
                      + +
                      +
                      +

                      + getSupportInfo() + + +

                      + + +

                      Get a pre-formatted string with all information needed for a support ticket.

                      + + + public + getSupportInfo() : string + +
                      +
                      + +

                      Get pre-formatted support ticket information.

                      +
                      + + + + + + +
                      +
                      Return values
                      + string +
                      + +
                      +
                      +

                      + getTimestamp() + + +

                      + + +

                      Get the timestamp when the exception occurred.

                      + + + public + getTimestamp() : DateTimeImmutable + +
                      +
                      + +

                      The timestamp is stored in UTC. Convert to your preferred timezone as needed:

                      +
                      $localTime = $e->getTimestamp()->setTimezone(new \DateTimeZone('America/Los_Angeles'));
                      +
                      +
                      + + + + + + +
                      +
                      Return values
                      + DateTimeImmutable + — +

                      The timestamp when the exception was created (UTC).

                      +
                      + +
                      + +
                      +
                      +

                      + extractRequestId() + + +

                      + + +

                      Extract the request ID (cf-ray header) from the response.

                      + + + protected + extractRequestId(ResponseInterface|null $response) : string|null + +
                      +
                      + + +
                      Parameters
                      +
                      +
                      + $response + : ResponseInterface|null +
                      +
                      +

                      The HTTP response.

                      +
                      + +
                      +
                      + + + + + +
                      +
                      Return values
                      + string|null + — +

                      The request ID, or null if not available.

                      +
                      + +
                      + +
                      +
                      + +
                      +
                      +
                      +
                      +
                      
                      +        
                      + +
                      +
                      + + + +
                      +
                      +
                      + +
                      + On this page + + +
                      + +
                      +
                      +
                      +
                      +
                      +

                      Search results

                      + +
                      +
                      +
                        +
                        +
                        +
                        +
                        + + +
                        + + + + + + + + diff --git a/docs/classes/MarketDataApp-Logging-DefaultLogger.html b/docs/classes/MarketDataApp-Logging-DefaultLogger.html new file mode 100644 index 00000000..4a83c0df --- /dev/null +++ b/docs/classes/MarketDataApp-Logging-DefaultLogger.html @@ -0,0 +1,777 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                        +

                        + MarketData SDK +

                        + + + + + +
                        + +
                        +
                        + + + + +
                        +
                        + + +
                        +

                        + DefaultLogger + + + extends AbstractLogger + + +
                        + in package + +
                        + + +

                        + +
                        + + +
                        + + + +

                        Default PSR-3 compliant logger for MarketDataApp SDK.

                        + + +

                        Writes log messages to STDERR with format: [timestamp] marketdata.LEVEL: message +Supports level filtering - only logs at or above the configured minimum level.

                        +
                        + + + + + +

                        + Table of Contents + + +

                        + + + + + + + +

                        + Constants + + +

                        +
                        +
                        + LOGGER_NAME + +  = 'marketdata' +
                        +
                        Logger name used in output format.
                        + +
                        + + +

                        + Properties + + +

                        +
                        +
                        + $levels + +  : array<string, int> +
                        + +
                        + $minLevel + +  : string +
                        + +
                        + $output + +  : resource|null +
                        + +
                        + +

                        + Methods + + +

                        +
                        +
                        + __construct() + +  : mixed +
                        +
                        Create a new DefaultLogger instance.
                        + +
                        + log() + +  : void +
                        +
                        Log a message at the specified level.
                        + +
                        + interpolate() + +  : string +
                        +
                        Interpolate context values into message placeholders.
                        + +
                        + + + + +
                        +

                        + Constants + + +

                        +
                        +

                        + LOGGER_NAME + + +

                        + + + +

                        Logger name used in output format.

                        + + + + private + mixed + LOGGER_NAME + = 'marketdata' + + + + + + + + +
                        +
                        + + +
                        +

                        + Properties + + +

                        +
                        +

                        + $levels + + + + +

                        + + + + + + private + array<string, int> + $levels + = [\Psr\Log\LogLevel::DEBUG => 0, \Psr\Log\LogLevel::INFO => 1, \Psr\Log\LogLevel::NOTICE => 2, \Psr\Log\LogLevel::WARNING => 3, \Psr\Log\LogLevel::ERROR => 4, \Psr\Log\LogLevel::CRITICAL => 5, \Psr\Log\LogLevel::ALERT => 6, \Psr\Log\LogLevel::EMERGENCY => 7] + + +

                        Log level priority mapping (lower = less severe).

                        +
                        + + + + + + +
                        +
                        +

                        + $minLevel + + + + +

                        + + + + + + private + string + $minLevel + + + +

                        The minimum log level to output.

                        +
                        + + + + + + +
                        +
                        +

                        + $output + + + + +

                        + + + + + + private + resource|null + $output + + + +

                        Output stream (defaults to STDERR).

                        +
                        + + + + + + +
                        +
                        + +
                        +

                        + Methods + + +

                        +
                        +

                        + __construct() + + +

                        + + +

                        Create a new DefaultLogger instance.

                        + + + public + __construct([string $minLevel = LogLevel::INFO ][, resource|null $output = null ]) : mixed + +
                        +
                        + + +
                        Parameters
                        +
                        +
                        + $minLevel + : string + = LogLevel::INFO
                        +
                        +

                        The minimum log level to output (default: INFO).

                        +
                        + +
                        +
                        + $output + : resource|null + = null
                        +
                        +

                        Output stream (default: STDERR). Pass a stream for testing.

                        +
                        + +
                        +
                        + + + + + + +
                        +
                        +

                        + log() + + +

                        + + +

                        Log a message at the specified level.

                        + + + public + log(mixed $level, string|Stringable $message[, array<string|int, mixed> $context = [] ]) : void + +
                        +
                        + + +
                        Parameters
                        +
                        +
                        + $level + : mixed +
                        +
                        +

                        The log level.

                        +
                        + +
                        +
                        + $message + : string|Stringable +
                        +
                        +

                        The log message.

                        +
                        + +
                        +
                        + $context + : array<string|int, mixed> + = []
                        +
                        +

                        Context data for interpolation.

                        +
                        + +
                        +
                        + + + + + + +
                        +
                        +

                        + interpolate() + + +

                        + + +

                        Interpolate context values into message placeholders.

                        + + + private + interpolate(string $message, array<string|int, mixed> $context) : string + +
                        +
                        + +

                        Replaces {key} placeholders with corresponding values from context array.

                        +
                        + +
                        Parameters
                        +
                        +
                        + $message + : string +
                        +
                        +

                        The message with placeholders.

                        +
                        + +
                        +
                        + $context + : array<string|int, mixed> +
                        +
                        +

                        The context values.

                        +
                        + +
                        +
                        + + + + + +
                        +
                        Return values
                        + string + — +

                        The interpolated message.

                        +
                        + +
                        + +
                        +
                        + +
                        +
                        +
                        +
                        +
                        
                        +        
                        + +
                        +
                        + + + +
                        +
                        +
                        + +
                        + On this page + + +
                        + +
                        +
                        +
                        +
                        +
                        +

                        Search results

                        + +
                        +
                        +
                          +
                          +
                          +
                          +
                          + + +
                          + + + + + + + + diff --git a/docs/classes/MarketDataApp-Logging-LoggerFactory.html b/docs/classes/MarketDataApp-Logging-LoggerFactory.html new file mode 100644 index 00000000..46cf1def --- /dev/null +++ b/docs/classes/MarketDataApp-Logging-LoggerFactory.html @@ -0,0 +1,573 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                          +

                          + MarketData SDK +

                          + + + + + +
                          + +
                          +
                          + + + + +
                          +
                          + + +
                          +

                          + LoggerFactory + + +
                          + in package + +
                          + + +

                          + +
                          + + +
                          + + + +

                          Factory for creating and managing logger instances.

                          + + +

                          Provides singleton access to the configured logger, supporting:

                          +
                            +
                          • Environment variable configuration via MARKETDATA_LOGGING_LEVEL
                          • +
                          • Custom logger injection for framework integration
                          • +
                          • NullLogger for disabled logging (NONE/OFF levels)
                          • +
                          +
                          + + + + + +

                          + Table of Contents + + +

                          + + + + + + + + + +

                          + Properties + + +

                          +
                          +
                          + $instance + +  : LoggerInterface|null +
                          + +
                          + +

                          + Methods + + +

                          +
                          +
                          + getLogger() + +  : LoggerInterface +
                          +
                          Get the configured logger instance.
                          + +
                          + resetLogger() + +  : void +
                          +
                          Reset the logger singleton.
                          + +
                          + setLogger() + +  : void +
                          +
                          Set a custom logger instance.
                          + +
                          + + + + + + +
                          +

                          + Properties + + +

                          +
                          +

                          + $instance + + + + +

                          + + + + + + private + static LoggerInterface|null + $instance + = null + + +

                          Singleton logger instance.

                          +
                          + + + + + + +
                          +
                          + +
                          +

                          + Methods + + +

                          +
                          +

                          + getLogger() + + +

                          + + +

                          Get the configured logger instance.

                          + + + public + static getLogger() : LoggerInterface + +
                          +
                          + +

                          Creates a new logger on first call based on MARKETDATA_LOGGING_LEVEL. +Subsequent calls return the same instance.

                          +
                          + + + + + + +
                          +
                          Return values
                          + LoggerInterface + — +

                          The configured logger.

                          +
                          + +
                          + +
                          +
                          +

                          + resetLogger() + + +

                          + + +

                          Reset the logger singleton.

                          + + + public + static resetLogger() : void + +
                          +
                          + +

                          Clears the cached logger instance, causing the next getLogger() +call to create a new logger. Useful for testing.

                          +
                          + + + + + + + +
                          +
                          +

                          + setLogger() + + +

                          + + +

                          Set a custom logger instance.

                          + + + public + static setLogger(LoggerInterface $logger) : void + +
                          +
                          + +

                          Use this to inject a custom PSR-3 logger (Monolog, Laravel, etc.).

                          +
                          + +
                          Parameters
                          +
                          +
                          + $logger + : LoggerInterface +
                          +
                          +

                          The custom logger to use.

                          +
                          + +
                          +
                          + + + + + + +
                          +
                          + +
                          +
                          +
                          +
                          +
                          
                          +        
                          + +
                          +
                          + + + +
                          +
                          +
                          + +
                          + On this page + + +
                          + +
                          +
                          +
                          +
                          +
                          +

                          Search results

                          + +
                          +
                          +
                            +
                            +
                            +
                            +
                            + + +
                            + + + + + + + + diff --git a/docs/classes/MarketDataApp-Logging-LoggingUtilities.html b/docs/classes/MarketDataApp-Logging-LoggingUtilities.html new file mode 100644 index 00000000..56a07b34 --- /dev/null +++ b/docs/classes/MarketDataApp-Logging-LoggingUtilities.html @@ -0,0 +1,420 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                            +

                            + MarketData SDK +

                            + + + + + +
                            + +
                            +
                            + + + + +
                            +
                            + + +
                            +

                            + LoggingUtilities + + +
                            + in package + +
                            + + +

                            + +
                            + + +
                            + + + +

                            Utility functions for logging.

                            + + + + + + + +

                            + Table of Contents + + +

                            + + + + + + + + + + +

                            + Methods + + +

                            +
                            +
                            + formatDuration() + +  : string +
                            +
                            Format duration in milliseconds to human-readable string.
                            + +
                            + + + + + + + +
                            +

                            + Methods + + +

                            +
                            +

                            + formatDuration() + + +

                            + + +

                            Format duration in milliseconds to human-readable string.

                            + + + public + static formatDuration(float $durationMs) : string + +
                            +
                            + +

                            Returns exactly 5 characters for consistent log alignment:

                            +
                              +
                            • < 1000ms: " 45ms", "999ms" (space-padded)
                            • +
                            • 1-9.99s: "1.23s", "9.87s"
                            • +
                            • 10-99.9s: "12.3s", "99.9s"
                            • +
                            • 100-999s: " 100s", " 999s" (space-padded)
                            • +
                            • 1000-9999s: "1000s", "9999s"
                            • +
                            • +
                              +

                              =10000s: "9999s" (clamped at ~2.7 hours)

                              +
                              +
                            • +
                            +
                            + +
                            Parameters
                            +
                            +
                            + $durationMs + : float +
                            +
                            +

                            Duration in milliseconds.

                            +
                            + +
                            +
                            + + + + + +
                            +
                            Return values
                            + string + — +

                            Formatted duration string (exactly 5 characters).

                            +
                            + +
                            + +
                            +
                            + +
                            +
                            +
                            +
                            +
                            
                            +        
                            + +
                            +
                            + + + +
                            +
                            +
                            + +
                            + On this page + + +
                            + +
                            +
                            +
                            +
                            +
                            +

                            Search results

                            + +
                            +
                            +
                              +
                              +
                              +
                              +
                              + + +
                              + + + + + + + + diff --git a/docs/classes/MarketDataApp-RateLimits.html b/docs/classes/MarketDataApp-RateLimits.html new file mode 100644 index 00000000..c1374e8c --- /dev/null +++ b/docs/classes/MarketDataApp-RateLimits.html @@ -0,0 +1,1276 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                              +

                              + MarketData SDK +

                              + + + + + +
                              + +
                              +
                              + + + + +
                              +
                              + + +
                              +

                              + RateLimits + + +
                              + in package + +
                              + + + + uses + FormatsForDisplay +

                              + +
                              + + +
                              + + + +

                              Represents rate limit information from API responses.

                              + + +

                              This value object holds rate limit data extracted from response headers. +It will be reused by both the User response class and future automatic rate limit tracking.

                              +

                              Property names match the API header names (x-api-ratelimit-*):

                              +
                                +
                              • limit: Total credits allowed (from x-api-ratelimit-limit)
                              • +
                              • remaining: Credits remaining (from x-api-ratelimit-remaining)
                              • +
                              • reset: When rate limit resets (from x-api-ratelimit-reset)
                              • +
                              • consumed: Credits consumed in current request (from x-api-ratelimit-consumed)
                              • +
                              +
                              + + + + + +

                              + Table of Contents + + +

                              + + + + + + + + + +

                              + Properties + + +

                              +
                              +
                              + $consumed + +  : int +
                              +
                              Number of credits consumed in the current request.
                              + +
                              + $limit + +  : int +
                              +
                              Total number of credits allowed in the current rate limit window.
                              + +
                              + $remaining + +  : int +
                              +
                              Number of credits remaining in the current rate limit window.
                              + +
                              + $reset + +  : Carbon +
                              +
                              Unix timestamp when the rate limit resets.
                              + +
                              + +

                              + Methods + + +

                              +
                              +
                              + __construct() + +  : mixed +
                              +
                              RateLimits constructor.
                              + +
                              + __toString() + +  : string +
                              +
                              Returns a string representation of the rate limits.
                              + +
                              + formatChange() + +  : string +
                              +
                              Format a change value with sign and currency (e.g., "+$1.25" or "-$0.50").
                              + +
                              + formatCurrency() + +  : string +
                              +
                              Format a float as currency (e.g., "$150.25").
                              + +
                              + formatDate() + +  : string +
                              +
                              Format a Carbon date without time (e.g., "Jan 24, 2026").
                              + +
                              + formatDateTime() + +  : string +
                              +
                              Format a Carbon date with time (e.g., "Jan 24, 2026 3:45 PM").
                              + +
                              + formatGreek() + +  : string +
                              +
                              Format a Greek value (4 decimal places, e.g., "0.4520").
                              + +
                              + formatNumber() + +  : string +
                              +
                              Format a number with commas (e.g., "15,234").
                              + +
                              + formatPercent() + +  : string +
                              +
                              Format a percentage with sign (e.g., "+3.25%" or "-1.50%").
                              + +
                              + formatPercentRaw() + +  : string +
                              +
                              Format a percentage that is already in percent form (e.g., "32.50%").
                              + +
                              + formatVolume() + +  : string +
                              +
                              Format volume with K/M/B suffixes (e.g., "54.9M", "12.3K").
                              + +
                              + + + + + + +
                              +

                              + Properties + + +

                              +
                              +

                              + $consumed + + + + +

                              + + +

                              Number of credits consumed in the current request.

                              + + + + public + int + $consumed + + +

                              Extracted from x-api-ratelimit-consumed header.

                              +

                              According to API documentation: "The quantity of credits that were consumed +in the current request." This is NOT a cumulative count - it's the quantity +consumed for the specific request that returned these headers.

                              +

                              Note: Most requests consume 1 credit, but bulk requests or options requests +may consume multiple credits per request.

                              +
                              + + + + + + + +
                              +
                              +

                              + $limit + + + + +

                              + + +

                              Total number of credits allowed in the current rate limit window.

                              + + + + public + int + $limit + + +

                              Extracted from x-api-ratelimit-limit header.

                              +
                              + + + + + + + +
                              +
                              +

                              + $remaining + + + + +

                              + + +

                              Number of credits remaining in the current rate limit window.

                              + + + + public + int + $remaining + + +

                              Extracted from x-api-ratelimit-remaining header.

                              +
                              + + + + + + + +
                              +
                              +

                              + $reset + + + + +

                              + + +

                              Unix timestamp when the rate limit resets.

                              + + + + public + Carbon + $reset + + +

                              Extracted from x-api-ratelimit-reset header.

                              +
                              + + + + + + + +
                              +
                              + +
                              +

                              + Methods + + +

                              +
                              +

                              + __construct() + + +

                              + + +

                              RateLimits constructor.

                              + + + public + __construct(int $limit, int $remaining, Carbon $reset, int $consumed) : mixed + +
                              +
                              + + +
                              Parameters
                              +
                              +
                              + $limit + : int +
                              +
                              +

                              Total number of credits allowed.

                              +
                              + +
                              +
                              + $remaining + : int +
                              +
                              +

                              Number of credits remaining.

                              +
                              + +
                              +
                              + $reset + : Carbon +
                              +
                              +

                              Timestamp when rate limit resets.

                              +
                              + +
                              +
                              + $consumed + : int +
                              +
                              +

                              Number of credits consumed.

                              +
                              + +
                              +
                              + + + + + + +
                              +
                              +

                              + __toString() + + +

                              + + +

                              Returns a string representation of the rate limits.

                              + + + public + __toString() : string + +
                              +
                              + + + + + + + +
                              +
                              Return values
                              + string + — +

                              Human-readable rate limit information.

                              +
                              + +
                              + +
                              +
                              +

                              + formatChange() + + +

                              + + +

                              Format a change value with sign and currency (e.g., "+$1.25" or "-$0.50").

                              + + + protected + formatChange(float|null $value) : string + +
                              +
                              + + +
                              Parameters
                              +
                              +
                              + $value + : float|null +
                              +
                              +

                              The change value to format.

                              +
                              + +
                              +
                              + + + + + +
                              +
                              Return values
                              + string + — +

                              Formatted change string or "N/A" if null.

                              +
                              + +
                              + +
                              +
                              +

                              + formatCurrency() + + +

                              + + +

                              Format a float as currency (e.g., "$150.25").

                              + + + protected + formatCurrency(float|null $value) : string + +
                              +
                              + + +
                              Parameters
                              +
                              +
                              + $value + : float|null +
                              +
                              +

                              The value to format.

                              +
                              + +
                              +
                              + + + + + +
                              +
                              Return values
                              + string + — +

                              Formatted currency string or "N/A" if null.

                              +
                              + +
                              + +
                              +
                              +

                              + formatDate() + + +

                              + + +

                              Format a Carbon date without time (e.g., "Jan 24, 2026").

                              + + + protected + formatDate(Carbon|null $date) : string + +
                              +
                              + + +
                              Parameters
                              +
                              +
                              + $date + : Carbon|null +
                              +
                              +

                              The date to format.

                              +
                              + +
                              +
                              + + + + + +
                              +
                              Return values
                              + string + — +

                              Formatted date string or "N/A" if null.

                              +
                              + +
                              + +
                              +
                              +

                              + formatDateTime() + + +

                              + + +

                              Format a Carbon date with time (e.g., "Jan 24, 2026 3:45 PM").

                              + + + protected + formatDateTime(Carbon|null $date) : string + +
                              +
                              + + +
                              Parameters
                              +
                              +
                              + $date + : Carbon|null +
                              +
                              +

                              The date to format.

                              +
                              + +
                              +
                              + + + + + +
                              +
                              Return values
                              + string + — +

                              Formatted date string or "N/A" if null.

                              +
                              + +
                              + +
                              +
                              +

                              + formatGreek() + + +

                              + + +

                              Format a Greek value (4 decimal places, e.g., "0.4520").

                              + + + protected + formatGreek(float|null $value) : string + +
                              +
                              + + +
                              Parameters
                              +
                              +
                              + $value + : float|null +
                              +
                              +

                              The Greek value to format.

                              +
                              + +
                              +
                              + + + + + +
                              +
                              Return values
                              + string + — +

                              Formatted Greek string or "N/A" if null.

                              +
                              + +
                              + +
                              +
                              +

                              + formatNumber() + + +

                              + + +

                              Format a number with commas (e.g., "15,234").

                              + + + protected + formatNumber(int|null $value) : string + +
                              +
                              + + +
                              Parameters
                              +
                              +
                              + $value + : int|null +
                              +
                              +

                              The number to format.

                              +
                              + +
                              +
                              + + + + + +
                              +
                              Return values
                              + string + — +

                              Formatted number string or "N/A" if null.

                              +
                              + +
                              + +
                              +
                              +

                              + formatPercent() + + +

                              + + +

                              Format a percentage with sign (e.g., "+3.25%" or "-1.50%").

                              + + + protected + formatPercent(float|null $value) : string + +
                              +
                              + +

                              Assumes input is a decimal (0.30 = 30%).

                              +
                              + +
                              Parameters
                              +
                              +
                              + $value + : float|null +
                              +
                              +

                              The decimal value to format as percentage.

                              +
                              + +
                              +
                              + + + + + +
                              +
                              Return values
                              + string + — +

                              Formatted percentage string or "N/A" if null.

                              +
                              + +
                              + +
                              +
                              +

                              + formatPercentRaw() + + +

                              + + +

                              Format a percentage that is already in percent form (e.g., "32.50%").

                              + + + protected + formatPercentRaw(float|null $value) : string + +
                              +
                              + +

                              Use this for values like implied volatility that are already percentages.

                              +
                              + +
                              Parameters
                              +
                              +
                              + $value + : float|null +
                              +
                              +

                              The percentage value to format.

                              +
                              + +
                              +
                              + + + + + +
                              +
                              Return values
                              + string + — +

                              Formatted percentage string or "N/A" if null.

                              +
                              + +
                              + +
                              +
                              +

                              + formatVolume() + + +

                              + + +

                              Format volume with K/M/B suffixes (e.g., "54.9M", "12.3K").

                              + + + protected + formatVolume(int|null $value) : string + +
                              +
                              + + +
                              Parameters
                              +
                              +
                              + $value + : int|null +
                              +
                              +

                              The volume to format.

                              +
                              + +
                              +
                              + + + + + +
                              +
                              Return values
                              + string + — +

                              Formatted volume string or "N/A" if null.

                              +
                              + +
                              + +
                              +
                              + +
                              +
                              +
                              +
                              +
                              
                              +        
                              + +
                              +
                              + + + +
                              +
                              +
                              + +
                              + On this page + + +
                              + +
                              +
                              +
                              +
                              +
                              +

                              Search results

                              + +
                              +
                              +
                                +
                                +
                                +
                                +
                                + + +
                                + + + + + + + + diff --git a/docs/classes/MarketDataApp-Retry-RetryConfig.html b/docs/classes/MarketDataApp-Retry-RetryConfig.html new file mode 100644 index 00000000..2efb987c --- /dev/null +++ b/docs/classes/MarketDataApp-Retry-RetryConfig.html @@ -0,0 +1,582 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                                +

                                + MarketData SDK +

                                + + + + + +
                                + +
                                +
                                + + + + +
                                +
                                + + +
                                +

                                + RetryConfig + + +
                                + in package + +
                                + + +

                                + +
                                + + +
                                + + + +

                                Retry configuration constants matching the Python SDK.

                                + + + + + + + +

                                + Table of Contents + + +

                                + + + + + + + +

                                + Constants + + +

                                +
                                +
                                + MAX_RETRY_ATTEMPTS + +  = 3 +
                                +
                                Maximum number of retry attempts.
                                + +
                                + MAX_RETRY_BACKOFF + +  = 5.0 +
                                +
                                Maximum backoff time in seconds.
                                + +
                                + MIN_RETRY_BACKOFF + +  = 0.5 +
                                +
                                Minimum backoff time in seconds.
                                + +
                                + RETRY_BACKOFF + +  = 0.5 +
                                +
                                Exponential backoff multiplier.
                                + +
                                + + + +

                                + Methods + + +

                                +
                                +
                                + isRetryableStatusCode() + +  : bool +
                                +
                                Check if a status code is retryable (status code > 500).
                                + +
                                + + + + +
                                +

                                + Constants + + +

                                +
                                +

                                + MAX_RETRY_ATTEMPTS + + +

                                + + + +

                                Maximum number of retry attempts.

                                + + + + public + mixed + MAX_RETRY_ATTEMPTS + = 3 + + + + + + + + +
                                +
                                +

                                + MAX_RETRY_BACKOFF + + +

                                + + + +

                                Maximum backoff time in seconds.

                                + + + + public + mixed + MAX_RETRY_BACKOFF + = 5.0 + + + + + + + + +
                                +
                                +

                                + MIN_RETRY_BACKOFF + + +

                                + + + +

                                Minimum backoff time in seconds.

                                + + + + public + mixed + MIN_RETRY_BACKOFF + = 0.5 + + + + + + + + +
                                +
                                +

                                + RETRY_BACKOFF + + +

                                + + + +

                                Exponential backoff multiplier.

                                + + + + public + mixed + RETRY_BACKOFF + = 0.5 + + + + + + + + +
                                +
                                + + + +
                                +

                                + Methods + + +

                                +
                                +

                                + isRetryableStatusCode() + + +

                                + + +

                                Check if a status code is retryable (status code > 500).

                                + + + public + static isRetryableStatusCode(int $statusCode) : bool + +
                                +
                                + + +
                                Parameters
                                +
                                +
                                + $statusCode + : int +
                                +
                                +

                                The HTTP status code.

                                +
                                + +
                                +
                                + + + + + +
                                +
                                Return values
                                + bool + — +

                                True if the status code is retryable.

                                +
                                + +
                                + +
                                +
                                + +
                                +
                                +
                                +
                                +
                                
                                +        
                                + +
                                +
                                + + + +
                                +
                                +
                                + +
                                + On this page + + +
                                + +
                                +
                                +
                                +
                                +
                                +

                                Search results

                                + +
                                +
                                +
                                  +
                                  +
                                  +
                                  +
                                  + + +
                                  + + + + + + + + diff --git a/docs/classes/MarketDataApp-Settings.html b/docs/classes/MarketDataApp-Settings.html new file mode 100644 index 00000000..66da1ea9 --- /dev/null +++ b/docs/classes/MarketDataApp-Settings.html @@ -0,0 +1,1246 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                                  +

                                  + MarketData SDK +

                                  + + + + + +
                                  + +
                                  +
                                  + + + + +
                                  +
                                  + + +
                                  +

                                  + Settings + + +
                                  + in package + +
                                  + + +

                                  + +
                                  + + +
                                  + + + +

                                  Settings class for MarketDataApp SDK.

                                  + + +

                                  Handles configuration loading from environment variables and .env files. +Provides automatic token resolution with proper precedence order.

                                  +
                                  + + + + + +

                                  + Table of Contents + + +

                                  + + + + + + + +

                                  + Constants + + +

                                  +
                                  +
                                  + API_STATUS_CACHE_VALIDITY + +  = 300 +
                                  +
                                  Cache validity period for API status.
                                  + +
                                  + MAX_CONCURRENT_REQUESTS + +  = 50 +
                                  +
                                  Maximum number of concurrent requests allowed for the entire API.
                                  + +
                                  + REFRESH_API_STATUS_INTERVAL + +  = 270 +
                                  +
                                  Refresh interval for API status cache.
                                  + +
                                  + + +

                                  + Properties + + +

                                  +
                                  +
                                  + $dotenvLoaded + +  : bool +
                                  + +
                                  + +

                                  + Methods + + +

                                  +
                                  +
                                  + getDefaultParameters() + +  : Parameters +
                                  +
                                  Get default universal parameters from environment variables and .env file.
                                  + +
                                  + getLogLevel() + +  : string +
                                  +
                                  Get the logging level from environment variable MARKETDATA_LOGGING_LEVEL.
                                  + +
                                  + getToken() + +  : string +
                                  +
                                  Get the API token with automatic resolution from multiple sources.
                                  + +
                                  + getDotenvToken() + +  : string|null +
                                  +
                                  Get token from .env file.
                                  + +
                                  + getEnvBool() + +  : bool|null +
                                  +
                                  Get boolean value from environment variable.
                                  + +
                                  + getEnvColumns() + +  : array<string|int, mixed>|null +
                                  +
                                  Get columns array from environment variable MARKETDATA_COLUMNS.
                                  + +
                                  + getEnvDateFormat() + +  : DateFormat|null +
                                  +
                                  Get date format from environment variable MARKETDATA_DATE_FORMAT.
                                  + +
                                  + getEnvFormat() + +  : Format +
                                  +
                                  Get format from environment variable MARKETDATA_OUTPUT_FORMAT.
                                  + +
                                  + getEnvMode() + +  : Mode|null +
                                  +
                                  Get mode from environment variable MARKETDATA_MODE.
                                  + +
                                  + getEnvToken() + +  : string|null +
                                  +
                                  Get token from environment variables.
                                  + +
                                  + getEnvValue() + +  : string|null +
                                  +
                                  Get environment variable value from multiple sources.
                                  + +
                                  + loadDotenv() + +  : void +
                                  +
                                  Load .env file if it exists.
                                  + +
                                  + + + + +
                                  +

                                  + Constants + + +

                                  +
                                  +

                                  + API_STATUS_CACHE_VALIDITY + + +

                                  + + + +

                                  Cache validity period for API status.

                                  + + + + public + int + API_STATUS_CACHE_VALIDITY + = 300 + + + +

                                  Cache is considered valid for this duration (5 minutes). +After this time, cache is stale and blocking refresh is required.

                                  +
                                  + +

                                  Cache validity in seconds.

                                  +
                                  + + + + +
                                  +
                                  +

                                  + MAX_CONCURRENT_REQUESTS + + +

                                  + + + +

                                  Maximum number of concurrent requests allowed for the entire API.

                                  + + + + public + int + MAX_CONCURRENT_REQUESTS + = 50 + + + +

                                  This is a hard limit enforced across all parallel request operations, +not just specific endpoints. The SDK uses Guzzle's EachPromise to maintain +a sliding window of this many concurrent requests - as soon as one completes, +the next one starts, maintaining optimal throughput.

                                  +

                                  This limit applies to:

                                  +
                                    +
                                  • Direct calls to execute_in_parallel()
                                  • +
                                  • Automatic date range splitting for intraday candles
                                  • +
                                  • Bulk quote requests via stocks->quotes()
                                  • +
                                  • Any other parallel request operations
                                  • +
                                  +
                                  + +

                                  Maximum concurrent requests.

                                  +
                                  + + + + +
                                  +
                                  +

                                  + REFRESH_API_STATUS_INTERVAL + + +

                                  + + + +

                                  Refresh interval for API status cache.

                                  + + + + public + int + REFRESH_API_STATUS_INTERVAL + = 270 + + + +

                                  Cache should be refreshed when this interval has elapsed (4 minutes 30 seconds). +This is the window before cache expiration where we trigger async refresh.

                                  +
                                  + +

                                  Refresh interval in seconds.

                                  +
                                  + + + + +
                                  +
                                  + + +
                                  +

                                  + Properties + + +

                                  +
                                  +

                                  + $dotenvLoaded + + + + +

                                  + + + + + + private + static bool + $dotenvLoaded + = false + + +

                                  Flag to track if .env file has been loaded

                                  +
                                  + + + + + + +
                                  +
                                  + +
                                  +

                                  + Methods + + +

                                  +
                                  +

                                  + getDefaultParameters() + + +

                                  + + +

                                  Get default universal parameters from environment variables and .env file.

                                  + + + public + static getDefaultParameters() : Parameters + +
                                  +
                                  + +

                                  Reads universal parameters from environment variables with the following precedence:

                                  +
                                    +
                                  1. Environment variables (getenv, $_ENV, $_SERVER)
                                  2. +
                                  3. .env file (loaded via Dotenv)
                                  4. +
                                  5. Default values (null or Format::JSON for format)
                                  6. +
                                  +
                                  + + + + + + +
                                  +
                                  Return values
                                  + Parameters + — +

                                  Parameters instance with values from environment, or defaults if not set.

                                  +
                                  + +
                                  + +
                                  +
                                  +

                                  + getLogLevel() + + +

                                  + + +

                                  Get the logging level from environment variable MARKETDATA_LOGGING_LEVEL.

                                  + + + public + static getLogLevel() : string + +
                                  +
                                  + + + + + + + +
                                  +
                                  Return values
                                  + string + — +

                                  Log level (DEBUG, INFO, NOTICE, WARNING, ERROR, CRITICAL, ALERT, EMERGENCY, or NONE). +Defaults to INFO if not set.

                                  +
                                  + +
                                  + +
                                  +
                                  +

                                  + getToken() + + +

                                  + + +

                                  Get the API token with automatic resolution from multiple sources.

                                  + + + public + static getToken([string|null $explicitToken = null ]) : string + +
                                  +
                                  + +

                                  Token resolution order (highest to lowest priority):

                                  +
                                    +
                                  1. Explicit token (passed as parameter)
                                  2. +
                                  3. Environment variable (MARKETDATA_TOKEN)
                                  4. +
                                  5. .env file (MARKETDATA_TOKEN)
                                  6. +
                                  7. Empty string (fallback for free symbols)
                                  8. +
                                  +
                                  + +
                                  Parameters
                                  +
                                  +
                                  + $explicitToken + : string|null + = null
                                  +
                                  +

                                  The token explicitly passed to the constructor, if any.

                                  +
                                  + +
                                  +
                                  + + + + + +
                                  +
                                  Return values
                                  + string + — +

                                  The resolved token.

                                  +
                                  + +
                                  + +
                                  +
                                  +

                                  + getDotenvToken() + + +

                                  + + +

                                  Get token from .env file.

                                  + + + private + static getDotenvToken() : string|null + +
                                  +
                                  + +

                                  Searches for .env file starting from current working directory, +then searches up the directory tree (max 5 levels).

                                  +
                                  + + + + + + +
                                  +
                                  Return values
                                  + string|null + — +

                                  The token from .env file, or null if not found.

                                  +
                                  + +
                                  + +
                                  +
                                  +

                                  + getEnvBool() + + +

                                  + + +

                                  Get boolean value from environment variable.

                                  + + + private + static getEnvBool(string $varName) : bool|null + +
                                  +
                                  + +

                                  Accepts: "true", "false", "1", "0" (case-insensitive)

                                  +
                                  + +
                                  Parameters
                                  +
                                  +
                                  + $varName + : string +
                                  +
                                  +

                                  Environment variable name.

                                  +
                                  + +
                                  +
                                  + + + + + +
                                  +
                                  Return values
                                  + bool|null + — +

                                  Boolean value, or null if not set or invalid.

                                  +
                                  + +
                                  + +
                                  +
                                  +

                                  + getEnvColumns() + + +

                                  + + +

                                  Get columns array from environment variable MARKETDATA_COLUMNS.

                                  + + + private + static getEnvColumns() : array<string|int, mixed>|null + +
                                  +
                                  + +

                                  Expects comma-separated string, e.g., "symbol,ask,bid"

                                  +
                                  + + + + + + +
                                  +
                                  Return values
                                  + array<string|int, mixed>|null + — +

                                  Array of column names, or null if not set or empty.

                                  +
                                  + +
                                  + +
                                  +
                                  +

                                  + getEnvDateFormat() + + +

                                  + + +

                                  Get date format from environment variable MARKETDATA_DATE_FORMAT.

                                  + + + private + static getEnvDateFormat() : DateFormat|null + +
                                  +
                                  + + + + + + + +
                                  +
                                  Return values
                                  + DateFormat|null + — +

                                  DateFormat enum value, or null if not set or invalid.

                                  +
                                  + +
                                  + +
                                  +
                                  +

                                  + getEnvFormat() + + +

                                  + + +

                                  Get format from environment variable MARKETDATA_OUTPUT_FORMAT.

                                  + + + private + static getEnvFormat() : Format + +
                                  +
                                  + + + + + + + +
                                  +
                                  Return values
                                  + Format + — +

                                  Format enum value, or Format::JSON if not set or invalid.

                                  +
                                  + +
                                  + +
                                  +
                                  +

                                  + getEnvMode() + + +

                                  + + +

                                  Get mode from environment variable MARKETDATA_MODE.

                                  + + + private + static getEnvMode() : Mode|null + +
                                  +
                                  + + + + + + + +
                                  +
                                  Return values
                                  + Mode|null + — +

                                  Mode enum value, or null if not set or invalid.

                                  +
                                  + +
                                  + +
                                  +
                                  +

                                  + getEnvToken() + + +

                                  + + +

                                  Get token from environment variables.

                                  + + + private + static getEnvToken() : string|null + +
                                  +
                                  + + + + + + + +
                                  +
                                  Return values
                                  + string|null + — +

                                  The token from environment, or null if not found.

                                  +
                                  + +
                                  + +
                                  +
                                  +

                                  + getEnvValue() + + +

                                  + + +

                                  Get environment variable value from multiple sources.

                                  + + + private + static getEnvValue(string $varName) : string|null + +
                                  +
                                  + +

                                  Checks in order:

                                  +
                                    +
                                  1. getenv()
                                  2. +
                                  3. $_ENV
                                  4. +
                                  5. $_SERVER
                                  6. +
                                  7. .env file (via Dotenv, which populates $_ENV/$_SERVER)
                                  8. +
                                  +
                                  + +
                                  Parameters
                                  +
                                  +
                                  + $varName + : string +
                                  +
                                  +

                                  Environment variable name.

                                  +
                                  + +
                                  +
                                  + + + + + +
                                  +
                                  Return values
                                  + string|null + — +

                                  Environment variable value, or null if not found.

                                  +
                                  + +
                                  + +
                                  +
                                  +

                                  + loadDotenv() + + +

                                  + + +

                                  Load .env file if it exists.

                                  + + + private + static loadDotenv() : void + +
                                  +
                                  + +

                                  Searches for .env file starting from current working directory, +then searches up the directory tree (max 5 levels).

                                  +
                                  + + + + + + + +
                                  +
                                  + +
                                  +
                                  +
                                  +
                                  +
                                  
                                  +        
                                  + +
                                  +
                                  + + + +
                                  +
                                  +
                                  + +
                                  + On this page + + +
                                  + +
                                  +
                                  +
                                  +
                                  +
                                  +

                                  Search results

                                  + +
                                  +
                                  +
                                    +
                                    +
                                    +
                                    +
                                    + + +
                                    + + + + + + + + diff --git a/docs/classes/MarketDataApp-Traits-FormatsForDisplay.html b/docs/classes/MarketDataApp-Traits-FormatsForDisplay.html new file mode 100644 index 00000000..d16c13d4 --- /dev/null +++ b/docs/classes/MarketDataApp-Traits-FormatsForDisplay.html @@ -0,0 +1,901 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                                    +

                                    + MarketData SDK +

                                    + + + + + +
                                    + +
                                    +
                                    + + + + +
                                    +
                                    + + +
                                    +

                                    + FormatsForDisplay +

                                    + + + +

                                    Trait for formatting values in __toString() methods.

                                    + + +

                                    Provides consistent formatting for currency, percentages, volumes, +dates, and other common display values across all SDK response objects.

                                    +
                                    + + + + + +

                                    + Table of Contents + + +

                                    + + + + + + + + + + +

                                    + Methods + + +

                                    +
                                    +
                                    + formatChange() + +  : string +
                                    +
                                    Format a change value with sign and currency (e.g., "+$1.25" or "-$0.50").
                                    + +
                                    + formatCurrency() + +  : string +
                                    +
                                    Format a float as currency (e.g., "$150.25").
                                    + +
                                    + formatDate() + +  : string +
                                    +
                                    Format a Carbon date without time (e.g., "Jan 24, 2026").
                                    + +
                                    + formatDateTime() + +  : string +
                                    +
                                    Format a Carbon date with time (e.g., "Jan 24, 2026 3:45 PM").
                                    + +
                                    + formatGreek() + +  : string +
                                    +
                                    Format a Greek value (4 decimal places, e.g., "0.4520").
                                    + +
                                    + formatNumber() + +  : string +
                                    +
                                    Format a number with commas (e.g., "15,234").
                                    + +
                                    + formatPercent() + +  : string +
                                    +
                                    Format a percentage with sign (e.g., "+3.25%" or "-1.50%").
                                    + +
                                    + formatPercentRaw() + +  : string +
                                    +
                                    Format a percentage that is already in percent form (e.g., "32.50%").
                                    + +
                                    + formatVolume() + +  : string +
                                    +
                                    Format volume with K/M/B suffixes (e.g., "54.9M", "12.3K").
                                    + +
                                    + + + + + + + + +
                                    +

                                    + Methods + + +

                                    +
                                    +

                                    + formatChange() + + +

                                    + + +

                                    Format a change value with sign and currency (e.g., "+$1.25" or "-$0.50").

                                    + + + protected + formatChange(float|null $value) : string + +
                                    +
                                    + + +
                                    Parameters
                                    +
                                    +
                                    + $value + : float|null +
                                    +
                                    +

                                    The change value to format.

                                    +
                                    + +
                                    +
                                    + + + + + +
                                    +
                                    Return values
                                    + string + — +

                                    Formatted change string or "N/A" if null.

                                    +
                                    + +
                                    + +
                                    +
                                    +

                                    + formatCurrency() + + +

                                    + + +

                                    Format a float as currency (e.g., "$150.25").

                                    + + + protected + formatCurrency(float|null $value) : string + +
                                    +
                                    + + +
                                    Parameters
                                    +
                                    +
                                    + $value + : float|null +
                                    +
                                    +

                                    The value to format.

                                    +
                                    + +
                                    +
                                    + + + + + +
                                    +
                                    Return values
                                    + string + — +

                                    Formatted currency string or "N/A" if null.

                                    +
                                    + +
                                    + +
                                    +
                                    +

                                    + formatDate() + + +

                                    + + +

                                    Format a Carbon date without time (e.g., "Jan 24, 2026").

                                    + + + protected + formatDate(Carbon|null $date) : string + +
                                    +
                                    + + +
                                    Parameters
                                    +
                                    +
                                    + $date + : Carbon|null +
                                    +
                                    +

                                    The date to format.

                                    +
                                    + +
                                    +
                                    + + + + + +
                                    +
                                    Return values
                                    + string + — +

                                    Formatted date string or "N/A" if null.

                                    +
                                    + +
                                    + +
                                    +
                                    +

                                    + formatDateTime() + + +

                                    + + +

                                    Format a Carbon date with time (e.g., "Jan 24, 2026 3:45 PM").

                                    + + + protected + formatDateTime(Carbon|null $date) : string + +
                                    +
                                    + + +
                                    Parameters
                                    +
                                    +
                                    + $date + : Carbon|null +
                                    +
                                    +

                                    The date to format.

                                    +
                                    + +
                                    +
                                    + + + + + +
                                    +
                                    Return values
                                    + string + — +

                                    Formatted date string or "N/A" if null.

                                    +
                                    + +
                                    + +
                                    +
                                    +

                                    + formatGreek() + + +

                                    + + +

                                    Format a Greek value (4 decimal places, e.g., "0.4520").

                                    + + + protected + formatGreek(float|null $value) : string + +
                                    +
                                    + + +
                                    Parameters
                                    +
                                    +
                                    + $value + : float|null +
                                    +
                                    +

                                    The Greek value to format.

                                    +
                                    + +
                                    +
                                    + + + + + +
                                    +
                                    Return values
                                    + string + — +

                                    Formatted Greek string or "N/A" if null.

                                    +
                                    + +
                                    + +
                                    +
                                    +

                                    + formatNumber() + + +

                                    + + +

                                    Format a number with commas (e.g., "15,234").

                                    + + + protected + formatNumber(int|null $value) : string + +
                                    +
                                    + + +
                                    Parameters
                                    +
                                    +
                                    + $value + : int|null +
                                    +
                                    +

                                    The number to format.

                                    +
                                    + +
                                    +
                                    + + + + + +
                                    +
                                    Return values
                                    + string + — +

                                    Formatted number string or "N/A" if null.

                                    +
                                    + +
                                    + +
                                    +
                                    +

                                    + formatPercent() + + +

                                    + + +

                                    Format a percentage with sign (e.g., "+3.25%" or "-1.50%").

                                    + + + protected + formatPercent(float|null $value) : string + +
                                    +
                                    + +

                                    Assumes input is a decimal (0.30 = 30%).

                                    +
                                    + +
                                    Parameters
                                    +
                                    +
                                    + $value + : float|null +
                                    +
                                    +

                                    The decimal value to format as percentage.

                                    +
                                    + +
                                    +
                                    + + + + + +
                                    +
                                    Return values
                                    + string + — +

                                    Formatted percentage string or "N/A" if null.

                                    +
                                    + +
                                    + +
                                    +
                                    +

                                    + formatPercentRaw() + + +

                                    + + +

                                    Format a percentage that is already in percent form (e.g., "32.50%").

                                    + + + protected + formatPercentRaw(float|null $value) : string + +
                                    +
                                    + +

                                    Use this for values like implied volatility that are already percentages.

                                    +
                                    + +
                                    Parameters
                                    +
                                    +
                                    + $value + : float|null +
                                    +
                                    +

                                    The percentage value to format.

                                    +
                                    + +
                                    +
                                    + + + + + +
                                    +
                                    Return values
                                    + string + — +

                                    Formatted percentage string or "N/A" if null.

                                    +
                                    + +
                                    + +
                                    +
                                    +

                                    + formatVolume() + + +

                                    + + +

                                    Format volume with K/M/B suffixes (e.g., "54.9M", "12.3K").

                                    + + + protected + formatVolume(int|null $value) : string + +
                                    +
                                    + + +
                                    Parameters
                                    +
                                    +
                                    + $value + : int|null +
                                    +
                                    +

                                    The volume to format.

                                    +
                                    + +
                                    +
                                    + + + + + +
                                    +
                                    Return values
                                    + string + — +

                                    Formatted volume string or "N/A" if null.

                                    +
                                    + +
                                    + +
                                    +
                                    + +
                                    +
                                    +
                                    +
                                    +
                                    
                                    +        
                                    + +
                                    +
                                    + + + +
                                    +
                                    +
                                    + +
                                    + On this page + + +
                                    + +
                                    +
                                    +
                                    +
                                    +
                                    +

                                    Search results

                                    + +
                                    +
                                    +
                                      +
                                      +
                                      +
                                      +
                                      + + +
                                      + + + + + + + + diff --git a/docs/classes/MarketDataApp-Traits-UniversalParameters.html b/docs/classes/MarketDataApp-Traits-UniversalParameters.html index eb453a02..17d37003 100644 --- a/docs/classes/MarketDataApp-Traits-UniversalParameters.html +++ b/docs/classes/MarketDataApp-Traits-UniversalParameters.html @@ -80,6 +80,14 @@

                                    • Exceptions +
                                    • +
                                    • + Logging + +
                                    • +
                                    • + Retry +
                                    • Traits @@ -124,7 +132,7 @@

                                      @@ -137,10 +145,8 @@

                                      - - - - + +

                                      Table of Contents @@ -176,6 +182,13 @@

                                      Execute multiple API requests in parallel with universal parameters.
                                      +
                                      + mergeParameters() + +  : Parameters +
                                      +
                                      Merge method-level parameters with client default parameters.
                                      +

                                    • @@ -205,7 +218,7 @@

                                      @@ -213,7 +226,7 @@

                                      protected - execute(string $method, array<string|int, mixed> $arguments, Parameters|null $parameters) : object + execute(string $method, array<string|int, mixed> $arguments, Parameters|null $parameters) : object
                                      @@ -222,8 +235,8 @@

                                      Parameters
                                      - $method - : string + $method + : string

                                      The API method to call.

                                      @@ -231,8 +244,8 @@
                                      Parameters
                                      - $arguments - : array<string|int, mixed> + $arguments + : array<string|int, mixed>

                                      The arguments for the API call.

                                      @@ -240,8 +253,8 @@
                                      Parameters
                                      - $parameters - : Parameters|null + $parameters + : Parameters|null

                                      Optional Parameters object for additional settings.

                                      @@ -252,8 +265,8 @@
                                      Parameters
                                      + -
                                      Return values
                                      object @@ -278,7 +291,7 @@

                                      @@ -286,7 +299,7 @@

                                      protected - execute_in_parallel(array<string|int, mixed> $calls[, Parameters|null $parameters = null ]) : array<string|int, mixed> + execute_in_parallel(array<string|int, mixed> $calls[, Parameters|null $parameters = null ][, array<string|int, mixed>|null &$failedRequests = null ]) : array<string|int, mixed>
                                      @@ -295,8 +308,8 @@

                                      Parameters
                                      - $calls - : array<string|int, mixed> + $calls + : array<string|int, mixed>

                                      An array of method calls, each containing the method name and arguments.

                                      @@ -304,13 +317,23 @@
                                      Parameters
                                      - $parameters - : Parameters|null - = null
                                      + $parameters + : Parameters|null + = null

                                      Optional Parameters object for additional settings.

                                      +
                                      +
                                      + $failedRequests + : array<string|int, mixed>|null + = null
                                      +
                                      +

                                      Optional by-reference array to collect failed requests instead of throwing. +When provided, exceptions are stored here keyed by their call index.

                                      +
                                      +
                                      @@ -327,17 +350,81 @@
                                      Throwable - +

                                      When $failedRequests is not provided and any request fails.

                                      +
                                      +
                                      + -
                                      Return values
                                      array<string|int, mixed> — -

                                      An array of API responses.

                                      +

                                      An array of API responses. When $failedRequests is provided, results are keyed by original call index.

                                      +
                                      + +
                                      + + +
                                      +

                                      + mergeParameters() + + +

                                      + + +

                                      Merge method-level parameters with client default parameters.

                                      + + + protected + mergeParameters(Parameters|null $methodParams) : Parameters + +
                                      +
                                      + +

                                      Priority order (highest to lowest):

                                      +
                                        +
                                      1. Method-level parameters (if provided)
                                      2. +
                                      3. Client default parameters ($this->client->default_params)
                                      4. +
                                      5. Default Parameters() values
                                      6. +
                                      +
                                      + +
                                      Parameters
                                      +
                                      +
                                      + $methodParams + : Parameters|null +
                                      +
                                      +

                                      Method-level parameters, or null to use only client defaults.

                                      +
                                      + +
                                      +
                                      + + + + + +
                                      +
                                      Return values
                                      + Parameters + — +

                                      Merged parameters instance.

                                      @@ -381,6 +468,8 @@
                                      Return values
                                      if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } @@ -456,6 +545,7 @@
                                      Return values
                                      diff --git a/docs/classes/MarketDataApp-Traits-ValidatesInputs.html b/docs/classes/MarketDataApp-Traits-ValidatesInputs.html new file mode 100644 index 00000000..abc1ed94 --- /dev/null +++ b/docs/classes/MarketDataApp-Traits-ValidatesInputs.html @@ -0,0 +1,1218 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                                      +

                                      + MarketData SDK +

                                      + + + + + +
                                      + +
                                      +
                                      + + + + +
                                      +
                                      + + +
                                      +

                                      + ValidatesInputs +

                                      + + + +

                                      Trait for input validation methods.

                                      + + +

                                      Provides reusable validation methods following the Python SDK's approach:

                                      +
                                        +
                                      • Does NOT validate date formats strictly (allows relative dates, option expiration dates, etc.)
                                      • +
                                      • Only validates date ranges when both dates are parseable
                                      • +
                                      • Validates numeric ranges, symbols, resolutions, etc.
                                      • +
                                      +
                                      + + + + + +

                                      + Table of Contents + + +

                                      + + + + + + + + + + +

                                      + Methods + + +

                                      +
                                      +
                                      + canParseAsDate() + +  : bool +
                                      +
                                      Check if a string can be parsed as a date.
                                      + +
                                      + parseDateToTimestamp() + +  : int|null +
                                      +
                                      Parse a date string to unix timestamp.
                                      + +
                                      + validateCountryCode() + +  : void +
                                      +
                                      Validate ISO 3166 two-letter country code.
                                      + +
                                      + validateDateRange() + +  : void +
                                      +
                                      Validate date range logic.
                                      + +
                                      + validateNonEmptyArray() + +  : void +
                                      +
                                      Validate that an array is non-empty.
                                      + +
                                      + validateNonEmptyString() + +  : void +
                                      +
                                      Validate that a string is non-empty.
                                      + +
                                      + validateNumericRange() + +  : void +
                                      +
                                      Validate that min < max when both are provided.
                                      + +
                                      + validatePositiveInteger() + +  : void +
                                      +
                                      Validate that an integer is positive if provided.
                                      + +
                                      + validatePositiveNumber() + +  : void +
                                      +
                                      Validate that a number (int or float) is positive if provided.
                                      + +
                                      + validateResolution() + +  : void +
                                      +
                                      Validate resolution format.
                                      + +
                                      + validateSymbols() + +  : void +
                                      +
                                      Validate symbols array (trim and ensure non-empty).
                                      + +
                                      + + + + + + + + +
                                      +

                                      + Methods + + +

                                      +
                                      +

                                      + canParseAsDate() + + +

                                      + + +

                                      Check if a string can be parsed as a date.

                                      + + + protected + canParseAsDate(string|null $value) : bool + +
                                      +
                                      + +

                                      Similar to Python SDK's check_is_date() function. +Returns true if the value contains "-" or "/" (indicating parseable date format) +or is numeric (unix timestamp or spreadsheet format).

                                      +

                                      This allows relative dates ("today", "yesterday", "-5 days") and option +expiration dates ("December expiration") to pass through without validation.

                                      +
                                      + +
                                      Parameters
                                      +
                                      +
                                      + $value + : string|null +
                                      +
                                      +

                                      The value to check

                                      +
                                      + +
                                      +
                                      + + + + + +
                                      +
                                      Return values
                                      + bool + — +

                                      True if the value can be parsed as a date

                                      +
                                      + +
                                      + +
                                      +
                                      +

                                      + parseDateToTimestamp() + + +

                                      + + +

                                      Parse a date string to unix timestamp.

                                      + + + protected + parseDateToTimestamp(string|null $value) : int|null + +
                                      +
                                      + +

                                      Handles ISO 8601, unix timestamps, spreadsheet dates, and American format.

                                      +
                                      + +
                                      Parameters
                                      +
                                      +
                                      + $value + : string|null +
                                      +
                                      +

                                      The date string to parse

                                      +
                                      + +
                                      +
                                      + + + + + +
                                      +
                                      Return values
                                      + int|null + — +

                                      Unix timestamp or null if cannot be parsed

                                      +
                                      + +
                                      + +
                                      +
                                      +

                                      + validateCountryCode() + + +

                                      + + +

                                      Validate ISO 3166 two-letter country code.

                                      + + + protected + validateCountryCode(string $country) : void + +
                                      +
                                      + + +
                                      Parameters
                                      +
                                      +
                                      + $country + : string +
                                      +
                                      +

                                      The country code to validate

                                      +
                                      + +
                                      +
                                      + + +
                                      + Tags + + +
                                      +
                                      +
                                      + throws +
                                      +
                                      + InvalidArgumentException + +

                                      If country code is invalid

                                      +
                                      + +
                                      +
                                      + + + + +
                                      +
                                      +

                                      + validateDateRange() + + +

                                      + + +

                                      Validate date range logic.

                                      + + + protected + validateDateRange(string|null $from, string|null $to[, int|null $countback = null ][, string $context = '' ]) : void + +
                                      +
                                      + +

                                      Rules:

                                      +
                                        +
                                      • If to is provided, it requires either from OR countback (but not both)
                                      • +
                                      • If both from and to are parseable dates, validates that from < to
                                      • +
                                      • If countback is provided, it must be a positive integer
                                      • +
                                      +

                                      This allows relative dates and option expiration dates to pass through without +strict format validation.

                                      +
                                      + +
                                      Parameters
                                      +
                                      +
                                      + $from + : string|null +
                                      +
                                      +

                                      The start date

                                      +
                                      + +
                                      +
                                      + $to + : string|null +
                                      +
                                      +

                                      The end date

                                      +
                                      + +
                                      +
                                      + $countback + : int|null + = null
                                      +
                                      +

                                      The countback value

                                      +
                                      + +
                                      +
                                      + $context + : string + = ''
                                      +
                                      +

                                      Optional context for error messages

                                      +
                                      + +
                                      +
                                      + + +
                                      + Tags + + +
                                      +
                                      +
                                      + throws +
                                      +
                                      + InvalidArgumentException + +

                                      If validation fails

                                      +
                                      + +
                                      +
                                      + + + + +
                                      +
                                      +

                                      + validateNonEmptyArray() + + +

                                      + + +

                                      Validate that an array is non-empty.

                                      + + + protected + validateNonEmptyArray(array<string|int, mixed> $value, string $fieldName) : void + +
                                      +
                                      + + +
                                      Parameters
                                      +
                                      +
                                      + $value + : array<string|int, mixed> +
                                      +
                                      +

                                      The value to validate

                                      +
                                      + +
                                      +
                                      + $fieldName + : string +
                                      +
                                      +

                                      The field name for error messages

                                      +
                                      + +
                                      +
                                      + + +
                                      + Tags + + +
                                      +
                                      +
                                      + throws +
                                      +
                                      + InvalidArgumentException + +

                                      If array is empty

                                      +
                                      + +
                                      +
                                      + + + + +
                                      +
                                      +

                                      + validateNonEmptyString() + + +

                                      + + +

                                      Validate that a string is non-empty.

                                      + + + protected + validateNonEmptyString(string $value, string $fieldName) : void + +
                                      +
                                      + + +
                                      Parameters
                                      +
                                      +
                                      + $value + : string +
                                      +
                                      +

                                      The value to validate

                                      +
                                      + +
                                      +
                                      + $fieldName + : string +
                                      +
                                      +

                                      The field name for error messages

                                      +
                                      + +
                                      +
                                      + + +
                                      + Tags + + +
                                      +
                                      +
                                      + throws +
                                      +
                                      + InvalidArgumentException + +

                                      If value is empty

                                      +
                                      + +
                                      +
                                      + + + + +
                                      +
                                      +

                                      + validateNumericRange() + + +

                                      + + +

                                      Validate that min < max when both are provided.

                                      + + + protected + validateNumericRange(float|null $min, float|null $max, string $minField, string $maxField) : void + +
                                      +
                                      + + +
                                      Parameters
                                      +
                                      +
                                      + $min + : float|null +
                                      +
                                      +

                                      The minimum value

                                      +
                                      + +
                                      +
                                      + $max + : float|null +
                                      +
                                      +

                                      The maximum value

                                      +
                                      + +
                                      +
                                      + $minField + : string +
                                      +
                                      +

                                      The minimum field name for error messages

                                      +
                                      + +
                                      +
                                      + $maxField + : string +
                                      +
                                      +

                                      The maximum field name for error messages

                                      +
                                      + +
                                      +
                                      + + +
                                      + Tags + + +
                                      +
                                      +
                                      + throws +
                                      +
                                      + InvalidArgumentException + +

                                      If min >= max

                                      +
                                      + +
                                      +
                                      + + + + +
                                      +
                                      +

                                      + validatePositiveInteger() + + +

                                      + + +

                                      Validate that an integer is positive if provided.

                                      + + + protected + validatePositiveInteger(int|null $value, string $fieldName) : void + +
                                      +
                                      + + +
                                      Parameters
                                      +
                                      +
                                      + $value + : int|null +
                                      +
                                      +

                                      The value to validate

                                      +
                                      + +
                                      +
                                      + $fieldName + : string +
                                      +
                                      +

                                      The field name for error messages

                                      +
                                      + +
                                      +
                                      + + +
                                      + Tags + + +
                                      +
                                      +
                                      + throws +
                                      +
                                      + InvalidArgumentException + +

                                      If value is not positive

                                      +
                                      + +
                                      +
                                      + + + + +
                                      +
                                      +

                                      + validatePositiveNumber() + + +

                                      + + +

                                      Validate that a number (int or float) is positive if provided.

                                      + + + protected + validatePositiveNumber(int|float|null $value, string $fieldName) : void + +
                                      +
                                      + + +
                                      Parameters
                                      +
                                      +
                                      + $value + : int|float|null +
                                      +
                                      +

                                      The value to validate

                                      +
                                      + +
                                      +
                                      + $fieldName + : string +
                                      +
                                      +

                                      The field name for error messages

                                      +
                                      + +
                                      +
                                      + + +
                                      + Tags + + +
                                      +
                                      +
                                      + throws +
                                      +
                                      + InvalidArgumentException + +

                                      If value is not positive

                                      +
                                      + +
                                      +
                                      + + + + +
                                      +
                                      +

                                      + validateResolution() + + +

                                      + + +

                                      Validate resolution format.

                                      + + + protected + validateResolution(string $resolution) : void + +
                                      +
                                      + +

                                      Valid resolutions: minutely, hourly, daily, weekly, monthly, yearly, +or numeric with optional suffix (1, 3, 5, 15, 30, 45, H, 1H, 2H, D, 1D, 2D, etc.)

                                      +
                                      + +
                                      Parameters
                                      +
                                      +
                                      + $resolution + : string +
                                      +
                                      +

                                      The resolution to validate

                                      +
                                      + +
                                      +
                                      + + +
                                      + Tags + + +
                                      +
                                      +
                                      + throws +
                                      +
                                      + InvalidArgumentException + +

                                      If resolution is invalid

                                      +
                                      + +
                                      +
                                      + + + + +
                                      +
                                      +

                                      + validateSymbols() + + +

                                      + + +

                                      Validate symbols array (trim and ensure non-empty).

                                      + + + protected + validateSymbols(array<string|int, mixed> $symbols) : void + +
                                      +
                                      + + +
                                      Parameters
                                      +
                                      +
                                      + $symbols + : array<string|int, mixed> +
                                      +
                                      +

                                      The symbols array to validate

                                      +
                                      + +
                                      +
                                      + + +
                                      + Tags + + +
                                      +
                                      +
                                      + throws +
                                      +
                                      + InvalidArgumentException + +

                                      If symbols array is invalid

                                      +
                                      + +
                                      +
                                      + + + + +
                                      +
                                      + +
                                      +
                                      +
                                      +
                                      +
                                      
                                      +        
                                      + +
                                      +
                                      + + + +
                                      +
                                      +
                                      + +
                                      + On this page + + +
                                      + +
                                      +
                                      +
                                      +
                                      +
                                      +

                                      Search results

                                      + +
                                      +
                                      +
                                        +
                                        +
                                        +
                                        +
                                        + + +
                                        + + + + + + + + diff --git a/docs/css/template.css b/docs/css/template.css index 875ebaff..21919c08 100644 --- a/docs/css/template.css +++ b/docs/css/template.css @@ -100,6 +100,7 @@ display: block; font-size: var(--text-sm); border: 1px solid #f0f0f0; + margin-bottom: calc(var(--spacing-sm)); } .phpdocumentor .phpdocumentor-signature.-deprecated .phpdocumentor-signature__name { @@ -273,3 +274,6 @@ .phpdocumentor-tag-link { margin-right: var(--spacing-sm); } +.phpdocumentor-uml-diagram svg { + cursor: zoom-in; +} \ No newline at end of file diff --git a/docs/files/src-client.html b/docs/files/src-client.html index 2d396363..cdd76c8e 100644 --- a/docs/files/src-client.html +++ b/docs/files/src-client.html @@ -80,6 +80,14 @@

                                      • Exceptions +
                                      • +
                                      • + Logging + +
                                      • +
                                      • + Retry +
                                      • Traits @@ -118,14 +126,12 @@

                                        Fil

                                        Client.php

                                        + + + - - - - - - +

                                        Table of Contents @@ -151,7 +157,6 @@

                                        - @@ -191,6 +196,8 @@

                                        if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-clientbase.html b/docs/files/src-clientbase.html index 82d19fd8..241228aa 100644 --- a/docs/files/src-clientbase.html +++ b/docs/files/src-clientbase.html @@ -80,6 +80,14 @@

                                      • Exceptions +
                                      • +
                                      • + Logging + +
                                      • +
                                      • + Retry +
                                      • Traits @@ -118,14 +126,12 @@

                                        Fil

                                        ClientBase.php

                                        + + + - - - - - - +

                                        Table of Contents @@ -151,7 +157,6 @@

                                        - @@ -191,6 +196,8 @@

                                        if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-endpoints-markets.html b/docs/files/src-endpoints-markets.html index 5cf752ed..0be6934b 100644 --- a/docs/files/src-endpoints-markets.html +++ b/docs/files/src-endpoints-markets.html @@ -80,6 +80,14 @@

                                      • Exceptions +
                                      • +
                                      • + Logging + +
                                      • +
                                      • + Retry +
                                      • Traits @@ -118,14 +126,12 @@

                                        Fil

                                        Markets.php

                                        + + + - - - - - - +

                                        Table of Contents @@ -151,7 +157,6 @@

                                        - @@ -191,6 +196,8 @@

                                        if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-endpoints-mutualfunds.html b/docs/files/src-endpoints-mutualfunds.html index 58153651..c08d166b 100644 --- a/docs/files/src-endpoints-mutualfunds.html +++ b/docs/files/src-endpoints-mutualfunds.html @@ -80,6 +80,14 @@

                                      • Exceptions +
                                      • +
                                      • + Logging + +
                                      • +
                                      • + Retry +
                                      • Traits @@ -118,14 +126,12 @@

                                        Fil

                                        MutualFunds.php

                                        + + + - - - - - - +

                                        Table of Contents @@ -151,7 +157,6 @@

                                        - @@ -191,6 +196,8 @@

                                        if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-endpoints-options.html b/docs/files/src-endpoints-options.html index e277e60f..63ec7552 100644 --- a/docs/files/src-endpoints-options.html +++ b/docs/files/src-endpoints-options.html @@ -80,6 +80,14 @@

                                      • Exceptions +
                                      • +
                                      • + Logging + +
                                      • +
                                      • + Retry +
                                      • Traits @@ -118,14 +126,12 @@

                                        Fil

                                        Options.php

                                        + + + - - - - - - +

                                        Table of Contents @@ -151,7 +157,6 @@

                                        - @@ -191,6 +196,8 @@

                                        if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-endpoints-requests-parameters.html b/docs/files/src-endpoints-requests-parameters.html index 385af229..0f8bb9a3 100644 --- a/docs/files/src-endpoints-requests-parameters.html +++ b/docs/files/src-endpoints-requests-parameters.html @@ -80,6 +80,14 @@

                                      • Exceptions +
                                      • +
                                      • + Logging + +
                                      • +
                                      • + Retry +
                                      • Traits @@ -118,14 +126,12 @@

                                        Fil

                                        Parameters.php

                                        + + + - - - - - - +

                                        Table of Contents @@ -141,8 +147,7 @@

                                        -
                                        Parameters
                                        Represents parameters for API requests.
                                        - +
                                        Parameters
                                        Represents universal parameters for API requests.

                                      • @@ -191,6 +196,8 @@

                                        if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-endpoints-responses-markets-status.html b/docs/files/src-endpoints-responses-markets-status.html index c52bb674..b755a16c 100644 --- a/docs/files/src-endpoints-responses-markets-status.html +++ b/docs/files/src-endpoints-responses-markets-status.html @@ -80,6 +80,14 @@

                                      • Exceptions +
                                      • +
                                      • + Logging + +
                                      • +
                                      • + Retry +
                                      • Traits @@ -118,14 +126,12 @@

                                        Fil

                                        Status.php

                                        + + + - - - - - - +

                                        Table of Contents @@ -151,7 +157,6 @@

                                        - @@ -191,6 +196,8 @@

                                        if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-endpoints-responses-markets-statuses.html b/docs/files/src-endpoints-responses-markets-statuses.html index 247895d6..e4cbe123 100644 --- a/docs/files/src-endpoints-responses-markets-statuses.html +++ b/docs/files/src-endpoints-responses-markets-statuses.html @@ -80,6 +80,14 @@

                                      • Exceptions +
                                      • +
                                      • + Logging + +
                                      • +
                                      • + Retry +
                                      • Traits @@ -118,14 +126,12 @@

                                        Fil

                                        Statuses.php

                                        + + + - - - - - - +

                                        Table of Contents @@ -151,7 +157,6 @@

                                        - @@ -191,6 +196,8 @@

                                        if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-endpoints-responses-mutualfunds-candle.html b/docs/files/src-endpoints-responses-mutualfunds-candle.html index d28f8048..b1ed40db 100644 --- a/docs/files/src-endpoints-responses-mutualfunds-candle.html +++ b/docs/files/src-endpoints-responses-mutualfunds-candle.html @@ -80,6 +80,14 @@

                                      • Exceptions +
                                      • +
                                      • + Logging + +
                                      • +
                                      • + Retry +
                                      • Traits @@ -118,14 +126,12 @@

                                        Fil

                                        Candle.php

                                        + + + - - - - - - +

                                        Table of Contents @@ -151,7 +157,6 @@

                                        - @@ -191,6 +196,8 @@

                                        if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-endpoints-responses-mutualfunds-candles.html b/docs/files/src-endpoints-responses-mutualfunds-candles.html index 3e36cd45..f343a4b1 100644 --- a/docs/files/src-endpoints-responses-mutualfunds-candles.html +++ b/docs/files/src-endpoints-responses-mutualfunds-candles.html @@ -80,6 +80,14 @@

                                      • Exceptions +
                                      • +
                                      • + Logging + +
                                      • +
                                      • + Retry +
                                      • Traits @@ -118,14 +126,12 @@

                                        Fil

                                        Candles.php

                                        + + + - - - - - - +

                                        Table of Contents @@ -151,7 +157,6 @@

                                        - @@ -191,6 +196,8 @@

                                        if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-endpoints-responses-options-expirations.html b/docs/files/src-endpoints-responses-options-expirations.html index c6bb667a..7ac0016a 100644 --- a/docs/files/src-endpoints-responses-options-expirations.html +++ b/docs/files/src-endpoints-responses-options-expirations.html @@ -80,6 +80,14 @@

                                      • Exceptions +
                                      • +
                                      • + Logging + +
                                      • +
                                      • + Retry +
                                      • Traits @@ -118,14 +126,12 @@

                                        Fil

                                        Expirations.php

                                        + + + - - - - - - +

                                        Table of Contents @@ -151,7 +157,6 @@

                                        - @@ -191,6 +196,8 @@

                                        if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-endpoints-responses-options-lookup.html b/docs/files/src-endpoints-responses-options-lookup.html index 3e979574..ff350279 100644 --- a/docs/files/src-endpoints-responses-options-lookup.html +++ b/docs/files/src-endpoints-responses-options-lookup.html @@ -80,6 +80,14 @@

                                      • Exceptions +
                                      • +
                                      • + Logging + +
                                      • +
                                      • + Retry +
                                      • Traits @@ -118,14 +126,12 @@

                                        Fil

                                        Lookup.php

                                        + + + - - - - - - +

                                        Table of Contents @@ -151,7 +157,6 @@

                                        - @@ -191,6 +196,8 @@

                                        if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-endpoints-responses-options-optionchains.html b/docs/files/src-endpoints-responses-options-optionchains.html index e8c3e06b..dc64dbd7 100644 --- a/docs/files/src-endpoints-responses-options-optionchains.html +++ b/docs/files/src-endpoints-responses-options-optionchains.html @@ -80,6 +80,14 @@

                                      • Exceptions +
                                      • +
                                      • + Logging + +
                                      • +
                                      • + Retry +
                                      • Traits @@ -118,14 +126,12 @@

                                        Fil

                                        OptionChains.php

                                        + + + - - - - - - +

                                        Table of Contents @@ -151,7 +157,6 @@

                                        - @@ -191,6 +196,8 @@

                                        if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-endpoints-responses-options-optionquote.html b/docs/files/src-endpoints-responses-options-optionquote.html new file mode 100644 index 00000000..0a7bd832 --- /dev/null +++ b/docs/files/src-endpoints-responses-options-optionquote.html @@ -0,0 +1,302 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                                        +

                                        + MarketData SDK +

                                        + + + + + +
                                        + +
                                        +
                                        + + + + +
                                        +
                                        +
                                          +
                                        + +
                                        +

                                        OptionQuote.php

                                        + + + + + + + + +

                                        + Table of Contents + + +

                                        + + + + +

                                        + Classes + + +

                                        +
                                        +
                                        OptionQuote
                                        Represents a single option quote with associated data.
                                        + + + + + + + + + + + + +
                                        +
                                        +
                                        +
                                        +
                                        
                                        +        
                                        + +
                                        +
                                        + + + +
                                        +
                                        +
                                        + +
                                        + On this page + +
                                          +
                                        • Table Of Contents
                                        • +
                                        • + +
                                        • + + +
                                        +
                                        + +
                                        +
                                        +
                                        +
                                        +
                                        +

                                        Search results

                                        + +
                                        +
                                        +
                                          +
                                          +
                                          +
                                          +
                                          + + +
                                          + + + + + + + + diff --git a/docs/files/src-endpoints-responses-options-quotes.html b/docs/files/src-endpoints-responses-options-quotes.html index ebf110f1..a62933fc 100644 --- a/docs/files/src-endpoints-responses-options-quotes.html +++ b/docs/files/src-endpoints-responses-options-quotes.html @@ -80,6 +80,14 @@

                                        • Exceptions +
                                        • +
                                        • + Logging + +
                                        • +
                                        • + Retry +
                                        • Traits @@ -118,14 +126,12 @@

                                          Fil

                                          Quotes.php

                                          + + + - - - - - - +

                                          Table of Contents @@ -151,7 +157,6 @@

                                          - @@ -191,6 +196,8 @@

                                          if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-endpoints-responses-options-strikes.html b/docs/files/src-endpoints-responses-options-strikes.html index fb31ea61..c1389d01 100644 --- a/docs/files/src-endpoints-responses-options-strikes.html +++ b/docs/files/src-endpoints-responses-options-strikes.html @@ -80,6 +80,14 @@

                                        • Exceptions +
                                        • +
                                        • + Logging + +
                                        • +
                                        • + Retry +
                                        • Traits @@ -118,14 +126,12 @@

                                          Fil

                                          Strikes.php

                                          + + + - - - - - - +

                                          Table of Contents @@ -151,7 +157,6 @@

                                          - @@ -191,6 +196,8 @@

                                          if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-endpoints-responses-responsebase.html b/docs/files/src-endpoints-responses-responsebase.html index 24e45068..3996cba9 100644 --- a/docs/files/src-endpoints-responses-responsebase.html +++ b/docs/files/src-endpoints-responses-responsebase.html @@ -80,6 +80,14 @@

                                        • Exceptions +
                                        • +
                                        • + Logging + +
                                        • +
                                        • + Retry +
                                        • Traits @@ -118,14 +126,12 @@

                                          Fil

                                          ResponseBase.php

                                          + + + - - - - - - +

                                          Table of Contents @@ -151,7 +157,6 @@

                                          - @@ -191,6 +196,8 @@

                                          if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-endpoints-responses-stocks-bulkcandles.html b/docs/files/src-endpoints-responses-stocks-bulkcandles.html index 928f870d..ea882f26 100644 --- a/docs/files/src-endpoints-responses-stocks-bulkcandles.html +++ b/docs/files/src-endpoints-responses-stocks-bulkcandles.html @@ -80,6 +80,14 @@

                                        • Exceptions +
                                        • +
                                        • + Logging + +
                                        • +
                                        • + Retry +
                                        • Traits @@ -118,14 +126,12 @@

                                          Fil

                                          BulkCandles.php

                                          + + + - - - - - - +

                                          Table of Contents @@ -151,7 +157,6 @@

                                          - @@ -191,6 +196,8 @@

                                          if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-endpoints-responses-stocks-candle.html b/docs/files/src-endpoints-responses-stocks-candle.html index 2f40db5a..1d834696 100644 --- a/docs/files/src-endpoints-responses-stocks-candle.html +++ b/docs/files/src-endpoints-responses-stocks-candle.html @@ -80,6 +80,14 @@

                                        • Exceptions +
                                        • +
                                        • + Logging + +
                                        • +
                                        • + Retry +
                                        • Traits @@ -118,14 +126,12 @@

                                          Fil

                                          Candle.php

                                          + + + - - - - - - +

                                          Table of Contents @@ -151,7 +157,6 @@

                                          - @@ -191,6 +196,8 @@

                                          if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-endpoints-responses-stocks-candles.html b/docs/files/src-endpoints-responses-stocks-candles.html index 24f287a6..d654499b 100644 --- a/docs/files/src-endpoints-responses-stocks-candles.html +++ b/docs/files/src-endpoints-responses-stocks-candles.html @@ -80,6 +80,14 @@

                                        • Exceptions +
                                        • +
                                        • + Logging + +
                                        • +
                                        • + Retry +
                                        • Traits @@ -118,14 +126,12 @@

                                          Fil

                                          Candles.php

                                          + + + - - - - - - +

                                          Table of Contents @@ -151,7 +157,6 @@

                                          - @@ -191,6 +196,8 @@

                                          if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-endpoints-responses-stocks-earning.html b/docs/files/src-endpoints-responses-stocks-earning.html index 62bc95bf..693f376d 100644 --- a/docs/files/src-endpoints-responses-stocks-earning.html +++ b/docs/files/src-endpoints-responses-stocks-earning.html @@ -80,6 +80,14 @@

                                        • Exceptions +
                                        • +
                                        • + Logging + +
                                        • +
                                        • + Retry +
                                        • Traits @@ -118,14 +126,12 @@

                                          Fil

                                          Earning.php

                                          + + + - - - - - - +

                                          Table of Contents @@ -151,7 +157,6 @@

                                          - @@ -191,6 +196,8 @@

                                          if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-endpoints-responses-stocks-earnings.html b/docs/files/src-endpoints-responses-stocks-earnings.html index db740171..3b5d076f 100644 --- a/docs/files/src-endpoints-responses-stocks-earnings.html +++ b/docs/files/src-endpoints-responses-stocks-earnings.html @@ -80,6 +80,14 @@

                                        • Exceptions +
                                        • +
                                        • + Logging + +
                                        • +
                                        • + Retry +
                                        • Traits @@ -118,14 +126,12 @@

                                          Fil

                                          Earnings.php

                                          + + + - - - - - - +

                                          Table of Contents @@ -151,7 +157,6 @@

                                          - @@ -191,6 +196,8 @@

                                          if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-endpoints-responses-stocks-news.html b/docs/files/src-endpoints-responses-stocks-news.html index c14ffdf5..b59470c3 100644 --- a/docs/files/src-endpoints-responses-stocks-news.html +++ b/docs/files/src-endpoints-responses-stocks-news.html @@ -80,6 +80,14 @@

                                        • Exceptions +
                                        • +
                                        • + Logging + +
                                        • +
                                        • + Retry +
                                        • Traits @@ -118,14 +126,12 @@

                                          Fil

                                          News.php

                                          + + + - - - - - - +

                                          Table of Contents @@ -151,7 +157,6 @@

                                          - @@ -191,6 +196,8 @@

                                          if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-endpoints-responses-stocks-prices.html b/docs/files/src-endpoints-responses-stocks-prices.html new file mode 100644 index 00000000..2920d183 --- /dev/null +++ b/docs/files/src-endpoints-responses-stocks-prices.html @@ -0,0 +1,302 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                                          +

                                          + MarketData SDK +

                                          + + + + + +
                                          + +
                                          +
                                          + + + + +
                                          +
                                          +
                                            +
                                          + +
                                          +

                                          Prices.php

                                          + + + + + + + + +

                                          + Table of Contents + + +

                                          + + + + +

                                          + Classes + + +

                                          +
                                          +
                                          Prices
                                          Class Prices
                                          + + + + + + + + + + + + +
                                          +
                                          +
                                          +
                                          +
                                          
                                          +        
                                          + +
                                          +
                                          + + + +
                                          +
                                          +
                                          + +
                                          + On this page + +
                                            +
                                          • Table Of Contents
                                          • +
                                          • + +
                                          • + + +
                                          +
                                          + +
                                          +
                                          +
                                          +
                                          +
                                          +

                                          Search results

                                          + +
                                          +
                                          +
                                            +
                                            +
                                            +
                                            +
                                            + + +
                                            + + + + + + + + diff --git a/docs/files/src-endpoints-responses-stocks-quote.html b/docs/files/src-endpoints-responses-stocks-quote.html index a6efce47..4080c4e7 100644 --- a/docs/files/src-endpoints-responses-stocks-quote.html +++ b/docs/files/src-endpoints-responses-stocks-quote.html @@ -80,6 +80,14 @@

                                          • Exceptions +
                                          • +
                                          • + Logging + +
                                          • +
                                          • + Retry +
                                          • Traits @@ -118,14 +126,12 @@

                                            Fil

                                            Quote.php

                                            + + + - - - - - - +

                                            Table of Contents @@ -151,7 +157,6 @@

                                            - @@ -191,6 +196,8 @@

                                            if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-endpoints-responses-stocks-quotes.html b/docs/files/src-endpoints-responses-stocks-quotes.html index 087b4d14..0c63c558 100644 --- a/docs/files/src-endpoints-responses-stocks-quotes.html +++ b/docs/files/src-endpoints-responses-stocks-quotes.html @@ -80,6 +80,14 @@

                                          • Exceptions +
                                          • +
                                          • + Logging + +
                                          • +
                                          • + Retry +
                                          • Traits @@ -118,14 +126,12 @@

                                            Fil

                                            Quotes.php

                                            + + + - - - - - - +

                                            Table of Contents @@ -151,7 +157,6 @@

                                            - @@ -191,6 +196,8 @@

                                            if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-endpoints-responses-utilities-apistatus.html b/docs/files/src-endpoints-responses-utilities-apistatus.html index f881e3b7..41abb613 100644 --- a/docs/files/src-endpoints-responses-utilities-apistatus.html +++ b/docs/files/src-endpoints-responses-utilities-apistatus.html @@ -80,6 +80,14 @@

                                          • Exceptions +
                                          • +
                                          • + Logging + +
                                          • +
                                          • + Retry +
                                          • Traits @@ -118,14 +126,12 @@

                                            Fil

                                            ApiStatus.php

                                            + + + - - - - - - +

                                            Table of Contents @@ -151,7 +157,6 @@

                                            - @@ -191,6 +196,8 @@

                                            if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-endpoints-responses-utilities-apistatusdata.html b/docs/files/src-endpoints-responses-utilities-apistatusdata.html new file mode 100644 index 00000000..d08e9d65 --- /dev/null +++ b/docs/files/src-endpoints-responses-utilities-apistatusdata.html @@ -0,0 +1,302 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                                            +

                                            + MarketData SDK +

                                            + + + + + +
                                            + +
                                            +
                                            + + + + +
                                            +
                                            +
                                              +
                                            + +
                                            +

                                            ApiStatusData.php

                                            + + + + + + + + +

                                            + Table of Contents + + +

                                            + + + + +

                                            + Classes + + +

                                            +
                                            +
                                            ApiStatusData
                                            Manages API status caching and provides service status checking.
                                            + + + + + + + + + + + + +
                                            +
                                            +
                                            +
                                            +
                                            
                                            +        
                                            + +
                                            +
                                            + + + +
                                            +
                                            +
                                            + +
                                            + On this page + +
                                              +
                                            • Table Of Contents
                                            • +
                                            • + +
                                            • + + +
                                            +
                                            + +
                                            +
                                            +
                                            +
                                            +
                                            +

                                            Search results

                                            + +
                                            +
                                            +
                                              +
                                              +
                                              +
                                              +
                                              + + +
                                              + + + + + + + + diff --git a/docs/files/src-endpoints-responses-utilities-headers.html b/docs/files/src-endpoints-responses-utilities-headers.html index de9e82da..003b404b 100644 --- a/docs/files/src-endpoints-responses-utilities-headers.html +++ b/docs/files/src-endpoints-responses-utilities-headers.html @@ -80,6 +80,14 @@

                                            • Exceptions +
                                            • +
                                            • + Logging + +
                                            • +
                                            • + Retry +
                                            • Traits @@ -118,14 +126,12 @@

                                              Fil

                                              Headers.php

                                              + + + - - - - - - +

                                              Table of Contents @@ -151,7 +157,6 @@

                                              - @@ -191,6 +196,8 @@

                                              if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-endpoints-responses-utilities-servicestatus.html b/docs/files/src-endpoints-responses-utilities-servicestatus.html index 101ea84d..dd3e32ee 100644 --- a/docs/files/src-endpoints-responses-utilities-servicestatus.html +++ b/docs/files/src-endpoints-responses-utilities-servicestatus.html @@ -80,6 +80,14 @@

                                            • Exceptions +
                                            • +
                                            • + Logging + +
                                            • +
                                            • + Retry +
                                            • Traits @@ -118,14 +126,12 @@

                                              Fil

                                              ServiceStatus.php

                                              + + + - - - - - - +

                                              Table of Contents @@ -151,7 +157,6 @@

                                              - @@ -191,6 +196,8 @@

                                              if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-endpoints-responses-utilities-user.html b/docs/files/src-endpoints-responses-utilities-user.html new file mode 100644 index 00000000..b8bb64b6 --- /dev/null +++ b/docs/files/src-endpoints-responses-utilities-user.html @@ -0,0 +1,302 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                                              +

                                              + MarketData SDK +

                                              + + + + + +
                                              + +
                                              +
                                              + + + + +
                                              +
                                              +
                                                +
                                              + +
                                              +

                                              User.php

                                              + + + + + + + + +

                                              + Table of Contents + + +

                                              + + + + +

                                              + Classes + + +

                                              +
                                              +
                                              User
                                              Represents user/rate limit information from the API.
                                              + + + + + + + + + + + + +
                                              +
                                              +
                                              +
                                              +
                                              
                                              +        
                                              + +
                                              +
                                              + + + +
                                              +
                                              +
                                              + +
                                              + On this page + +
                                                +
                                              • Table Of Contents
                                              • +
                                              • + +
                                              • + + +
                                              +
                                              + +
                                              +
                                              +
                                              +
                                              +
                                              +

                                              Search results

                                              + +
                                              +
                                              +
                                                +
                                                +
                                                +
                                                +
                                                + + +
                                                + + + + + + + + diff --git a/docs/files/src-endpoints-stocks.html b/docs/files/src-endpoints-stocks.html index 7a9dd43a..4db893eb 100644 --- a/docs/files/src-endpoints-stocks.html +++ b/docs/files/src-endpoints-stocks.html @@ -80,6 +80,14 @@

                                              • Exceptions +
                                              • +
                                              • + Logging + +
                                              • +
                                              • + Retry +
                                              • Traits @@ -118,14 +126,12 @@

                                                Fil

                                                Stocks.php

                                                + + + - - - - - - +

                                                Table of Contents @@ -151,7 +157,6 @@

                                                - @@ -191,6 +196,8 @@

                                                if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-endpoints-utilities.html b/docs/files/src-endpoints-utilities.html index dc4f2596..f92691a2 100644 --- a/docs/files/src-endpoints-utilities.html +++ b/docs/files/src-endpoints-utilities.html @@ -80,6 +80,14 @@

                                              • Exceptions +
                                              • +
                                              • + Logging + +
                                              • +
                                              • + Retry +
                                              • Traits @@ -118,14 +126,12 @@

                                                Fil

                                                Utilities.php

                                                + + + - - - - - - +

                                                Table of Contents @@ -151,7 +157,6 @@

                                                - @@ -191,6 +196,8 @@

                                                if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-enums-apistatusresult.html b/docs/files/src-enums-apistatusresult.html new file mode 100644 index 00000000..6a3ccd82 --- /dev/null +++ b/docs/files/src-enums-apistatusresult.html @@ -0,0 +1,302 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                                                +

                                                + MarketData SDK +

                                                + + + + + +
                                                + +
                                                +
                                                + + + + +
                                                +
                                                +
                                                  +
                                                + +
                                                +

                                                ApiStatusResult.php

                                                + + + + + + + + +

                                                + Table of Contents + + +

                                                + + + + + + +

                                                + Enums + + +

                                                +
                                                +
                                                ApiStatusResult
                                                Enum representing the status result of an API service.
                                                + + + + + + + + + + +
                                                +
                                                +
                                                +
                                                +
                                                
                                                +        
                                                + +
                                                +
                                                + + + +
                                                +
                                                +
                                                + +
                                                + On this page + +
                                                  +
                                                • Table Of Contents
                                                • +
                                                • + +
                                                • + + +
                                                +
                                                + +
                                                +
                                                +
                                                +
                                                +
                                                +

                                                Search results

                                                + +
                                                +
                                                +
                                                  +
                                                  +
                                                  +
                                                  +
                                                  + + +
                                                  + + + + + + + + diff --git a/docs/files/src-enums-dateformat.html b/docs/files/src-enums-dateformat.html new file mode 100644 index 00000000..1588b9c0 --- /dev/null +++ b/docs/files/src-enums-dateformat.html @@ -0,0 +1,302 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                                                  +

                                                  + MarketData SDK +

                                                  + + + + + +
                                                  + +
                                                  +
                                                  + + + + +
                                                  +
                                                  +
                                                    +
                                                  + +
                                                  +

                                                  DateFormat.php

                                                  + + + + + + + + +

                                                  + Table of Contents + + +

                                                  + + + + + + +

                                                  + Enums + + +

                                                  +
                                                  +
                                                  DateFormat
                                                  Enum DateFormat
                                                  + + + + + + + + + + +
                                                  +
                                                  +
                                                  +
                                                  +
                                                  
                                                  +        
                                                  + +
                                                  +
                                                  + + + +
                                                  +
                                                  +
                                                  + +
                                                  + On this page + +
                                                    +
                                                  • Table Of Contents
                                                  • +
                                                  • + +
                                                  • + + +
                                                  +
                                                  + +
                                                  +
                                                  +
                                                  +
                                                  +
                                                  +

                                                  Search results

                                                  + +
                                                  +
                                                  +
                                                    +
                                                    +
                                                    +
                                                    +
                                                    + + +
                                                    + + + + + + + + diff --git a/docs/files/src-enums-expiration.html b/docs/files/src-enums-expiration.html index e5c560b2..218a9450 100644 --- a/docs/files/src-enums-expiration.html +++ b/docs/files/src-enums-expiration.html @@ -80,6 +80,14 @@

                                                  • Exceptions +
                                                  • +
                                                  • + Logging + +
                                                  • +
                                                  • + Retry +
                                                  • Traits @@ -118,14 +126,12 @@

                                                    Fil

                                                    Expiration.php

                                                    + + + - - - - - - +

                                                    Table of Contents @@ -151,7 +157,6 @@

                                                    - @@ -191,6 +196,8 @@

                                                    if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-enums-format.html b/docs/files/src-enums-format.html index bdd19fc8..74cb4964 100644 --- a/docs/files/src-enums-format.html +++ b/docs/files/src-enums-format.html @@ -80,6 +80,14 @@

                                                  • Exceptions +
                                                  • +
                                                  • + Logging + +
                                                  • +
                                                  • + Retry +
                                                  • Traits @@ -118,14 +126,12 @@

                                                    Fil

                                                    Format.php

                                                    + + + - - - - - - +

                                                    Table of Contents @@ -151,7 +157,6 @@

                                                    - @@ -191,6 +196,8 @@

                                                    if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-enums-mode.html b/docs/files/src-enums-mode.html new file mode 100644 index 00000000..7176b1b8 --- /dev/null +++ b/docs/files/src-enums-mode.html @@ -0,0 +1,302 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                                                    +

                                                    + MarketData SDK +

                                                    + + + + + +
                                                    + +
                                                    +
                                                    + + + + +
                                                    +
                                                    +
                                                      +
                                                    + +
                                                    +

                                                    Mode.php

                                                    + + + + + + + + +

                                                    + Table of Contents + + +

                                                    + + + + + + +

                                                    + Enums + + +

                                                    +
                                                    +
                                                    Mode
                                                    Enum Mode
                                                    + + + + + + + + + + +
                                                    +
                                                    +
                                                    +
                                                    +
                                                    
                                                    +        
                                                    + +
                                                    +
                                                    + + + +
                                                    +
                                                    +
                                                    + +
                                                    + On this page + +
                                                      +
                                                    • Table Of Contents
                                                    • +
                                                    • + +
                                                    • + + +
                                                    +
                                                    + +
                                                    +
                                                    +
                                                    +
                                                    +
                                                    +

                                                    Search results

                                                    + +
                                                    +
                                                    +
                                                      +
                                                      +
                                                      +
                                                      +
                                                      + + +
                                                      + + + + + + + + diff --git a/docs/files/src-enums-range.html b/docs/files/src-enums-range.html index 3b091477..72c63637 100644 --- a/docs/files/src-enums-range.html +++ b/docs/files/src-enums-range.html @@ -80,6 +80,14 @@

                                                    • Exceptions +
                                                    • +
                                                    • + Logging + +
                                                    • +
                                                    • + Retry +
                                                    • Traits @@ -118,14 +126,12 @@

                                                      Fil

                                                      Range.php

                                                      + + + - - - - - - +

                                                      Table of Contents @@ -151,7 +157,6 @@

                                                      - @@ -191,6 +196,8 @@

                                                      if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-enums-side.html b/docs/files/src-enums-side.html index 4332e0a9..e6a0afb6 100644 --- a/docs/files/src-enums-side.html +++ b/docs/files/src-enums-side.html @@ -80,6 +80,14 @@

                                                    • Exceptions +
                                                    • +
                                                    • + Logging + +
                                                    • +
                                                    • + Retry +
                                                    • Traits @@ -118,14 +126,12 @@

                                                      Fil

                                                      Side.php

                                                      + + + - - - - - - +

                                                      Table of Contents @@ -151,7 +157,6 @@

                                                      - @@ -191,6 +196,8 @@

                                                      if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-exceptions-apiexception.html b/docs/files/src-exceptions-apiexception.html index f1195610..3cf413e2 100644 --- a/docs/files/src-exceptions-apiexception.html +++ b/docs/files/src-exceptions-apiexception.html @@ -80,6 +80,14 @@

                                                    • Exceptions +
                                                    • +
                                                    • + Logging + +
                                                    • +
                                                    • + Retry +
                                                    • Traits @@ -118,14 +126,12 @@

                                                      Fil

                                                      ApiException.php

                                                      + + + - - - - - - +

                                                      Table of Contents @@ -151,7 +157,6 @@

                                                      - @@ -191,6 +196,8 @@

                                                      if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-exceptions-badstatuscodeerror.html b/docs/files/src-exceptions-badstatuscodeerror.html new file mode 100644 index 00000000..836a10e3 --- /dev/null +++ b/docs/files/src-exceptions-badstatuscodeerror.html @@ -0,0 +1,302 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                                                      +

                                                      + MarketData SDK +

                                                      + + + + + +
                                                      + +
                                                      +
                                                      + + + + +
                                                      +
                                                      +
                                                        +
                                                      + +
                                                      +

                                                      BadStatusCodeError.php

                                                      + + + + + + + + +

                                                      + Table of Contents + + +

                                                      + + + + +

                                                      + Classes + + +

                                                      +
                                                      +
                                                      BadStatusCodeError
                                                      BadStatusCodeError class
                                                      + + + + + + + + + + + + +
                                                      +
                                                      +
                                                      +
                                                      +
                                                      
                                                      +        
                                                      + +
                                                      +
                                                      + + + +
                                                      +
                                                      +
                                                      + +
                                                      + On this page + +
                                                        +
                                                      • Table Of Contents
                                                      • +
                                                      • + +
                                                      • + + +
                                                      +
                                                      + +
                                                      +
                                                      +
                                                      +
                                                      +
                                                      +

                                                      Search results

                                                      + +
                                                      +
                                                      +
                                                        +
                                                        +
                                                        +
                                                        +
                                                        + + +
                                                        + + + + + + + + diff --git a/docs/files/src-exceptions-marketdataexception.html b/docs/files/src-exceptions-marketdataexception.html new file mode 100644 index 00000000..1edd2820 --- /dev/null +++ b/docs/files/src-exceptions-marketdataexception.html @@ -0,0 +1,302 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                                                        +

                                                        + MarketData SDK +

                                                        + + + + + +
                                                        + +
                                                        +
                                                        + + + + +
                                                        +
                                                        +
                                                          +
                                                        + +
                                                        +

                                                        MarketDataException.php

                                                        + + + + + + + + +

                                                        + Table of Contents + + +

                                                        + + + + +

                                                        + Classes + + +

                                                        +
                                                        +
                                                        MarketDataException
                                                        Base exception class for all Market Data SDK exceptions.
                                                        + + + + + + + + + + + + +
                                                        +
                                                        +
                                                        +
                                                        +
                                                        
                                                        +        
                                                        + +
                                                        +
                                                        + + + +
                                                        +
                                                        +
                                                        + +
                                                        + On this page + +
                                                          +
                                                        • Table Of Contents
                                                        • +
                                                        • + +
                                                        • + + +
                                                        +
                                                        + +
                                                        +
                                                        +
                                                        +
                                                        +
                                                        +

                                                        Search results

                                                        + +
                                                        +
                                                        +
                                                          +
                                                          +
                                                          +
                                                          +
                                                          + + +
                                                          + + + + + + + + diff --git a/docs/files/src-exceptions-requesterror.html b/docs/files/src-exceptions-requesterror.html new file mode 100644 index 00000000..51465f66 --- /dev/null +++ b/docs/files/src-exceptions-requesterror.html @@ -0,0 +1,302 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                                                          +

                                                          + MarketData SDK +

                                                          + + + + + +
                                                          + +
                                                          +
                                                          + + + + +
                                                          +
                                                          +
                                                            +
                                                          + +
                                                          +

                                                          RequestError.php

                                                          + + + + + + + + +

                                                          + Table of Contents + + +

                                                          + + + + +

                                                          + Classes + + +

                                                          +
                                                          +
                                                          RequestError
                                                          RequestError class
                                                          + + + + + + + + + + + + +
                                                          +
                                                          +
                                                          +
                                                          +
                                                          
                                                          +        
                                                          + +
                                                          +
                                                          + + + +
                                                          +
                                                          +
                                                          + +
                                                          + On this page + +
                                                            +
                                                          • Table Of Contents
                                                          • +
                                                          • + +
                                                          • + + +
                                                          +
                                                          + +
                                                          +
                                                          +
                                                          +
                                                          +
                                                          +

                                                          Search results

                                                          + +
                                                          +
                                                          +
                                                            +
                                                            +
                                                            +
                                                            +
                                                            + + +
                                                            + + + + + + + + diff --git a/docs/files/src-exceptions-unauthorizedexception.html b/docs/files/src-exceptions-unauthorizedexception.html new file mode 100644 index 00000000..7fb8b19e --- /dev/null +++ b/docs/files/src-exceptions-unauthorizedexception.html @@ -0,0 +1,302 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                                                            +

                                                            + MarketData SDK +

                                                            + + + + + +
                                                            + +
                                                            +
                                                            + + + + +
                                                            +
                                                            +
                                                              +
                                                            + +
                                                            +

                                                            UnauthorizedException.php

                                                            + + + + + + + + +

                                                            + Table of Contents + + +

                                                            + + + + +

                                                            + Classes + + +

                                                            +
                                                            +
                                                            UnauthorizedException
                                                            UnauthorizedException class
                                                            + + + + + + + + + + + + +
                                                            +
                                                            +
                                                            +
                                                            +
                                                            
                                                            +        
                                                            + +
                                                            +
                                                            + + + +
                                                            +
                                                            +
                                                            + +
                                                            + On this page + +
                                                              +
                                                            • Table Of Contents
                                                            • +
                                                            • + +
                                                            • + + +
                                                            +
                                                            + +
                                                            +
                                                            +
                                                            +
                                                            +
                                                            +

                                                            Search results

                                                            + +
                                                            +
                                                            +
                                                              +
                                                              +
                                                              +
                                                              +
                                                              + + +
                                                              + + + + + + + + diff --git a/docs/files/src-logging-defaultlogger.html b/docs/files/src-logging-defaultlogger.html new file mode 100644 index 00000000..f26e1b6d --- /dev/null +++ b/docs/files/src-logging-defaultlogger.html @@ -0,0 +1,302 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                                                              +

                                                              + MarketData SDK +

                                                              + + + + + +
                                                              + +
                                                              +
                                                              + + + + +
                                                              +
                                                              +
                                                                +
                                                              + +
                                                              +

                                                              DefaultLogger.php

                                                              + + + + + + + + +

                                                              + Table of Contents + + +

                                                              + + + + +

                                                              + Classes + + +

                                                              +
                                                              +
                                                              DefaultLogger
                                                              Default PSR-3 compliant logger for MarketDataApp SDK.
                                                              + + + + + + + + + + + + +
                                                              +
                                                              +
                                                              +
                                                              +
                                                              
                                                              +        
                                                              + +
                                                              +
                                                              + + + +
                                                              +
                                                              +
                                                              + +
                                                              + On this page + +
                                                                +
                                                              • Table Of Contents
                                                              • +
                                                              • + +
                                                              • + + +
                                                              +
                                                              + +
                                                              +
                                                              +
                                                              +
                                                              +
                                                              +

                                                              Search results

                                                              + +
                                                              +
                                                              +
                                                                +
                                                                +
                                                                +
                                                                +
                                                                + + +
                                                                + + + + + + + + diff --git a/docs/files/src-logging-loggerfactory.html b/docs/files/src-logging-loggerfactory.html new file mode 100644 index 00000000..85e48972 --- /dev/null +++ b/docs/files/src-logging-loggerfactory.html @@ -0,0 +1,302 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                                                                +

                                                                + MarketData SDK +

                                                                + + + + + +
                                                                + +
                                                                +
                                                                + + + + +
                                                                +
                                                                +
                                                                  +
                                                                + +
                                                                +

                                                                LoggerFactory.php

                                                                + + + + + + + + +

                                                                + Table of Contents + + +

                                                                + + + + +

                                                                + Classes + + +

                                                                +
                                                                +
                                                                LoggerFactory
                                                                Factory for creating and managing logger instances.
                                                                + + + + + + + + + + + + +
                                                                +
                                                                +
                                                                +
                                                                +
                                                                
                                                                +        
                                                                + +
                                                                +
                                                                + + + +
                                                                +
                                                                +
                                                                + +
                                                                + On this page + +
                                                                  +
                                                                • Table Of Contents
                                                                • +
                                                                • + +
                                                                • + + +
                                                                +
                                                                + +
                                                                +
                                                                +
                                                                +
                                                                +
                                                                +

                                                                Search results

                                                                + +
                                                                +
                                                                +
                                                                  +
                                                                  +
                                                                  +
                                                                  +
                                                                  + + +
                                                                  + + + + + + + + diff --git a/docs/files/src-logging-loggingutilities.html b/docs/files/src-logging-loggingutilities.html new file mode 100644 index 00000000..3d848b68 --- /dev/null +++ b/docs/files/src-logging-loggingutilities.html @@ -0,0 +1,302 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                                                                  +

                                                                  + MarketData SDK +

                                                                  + + + + + +
                                                                  + +
                                                                  +
                                                                  + + + + +
                                                                  +
                                                                  +
                                                                    +
                                                                  + +
                                                                  +

                                                                  LoggingUtilities.php

                                                                  + + + + + + + + +

                                                                  + Table of Contents + + +

                                                                  + + + + +

                                                                  + Classes + + +

                                                                  +
                                                                  +
                                                                  LoggingUtilities
                                                                  Utility functions for logging.
                                                                  + + + + + + + + + + + + +
                                                                  +
                                                                  +
                                                                  +
                                                                  +
                                                                  
                                                                  +        
                                                                  + +
                                                                  +
                                                                  + + + +
                                                                  +
                                                                  +
                                                                  + +
                                                                  + On this page + +
                                                                    +
                                                                  • Table Of Contents
                                                                  • +
                                                                  • + +
                                                                  • + + +
                                                                  +
                                                                  + +
                                                                  +
                                                                  +
                                                                  +
                                                                  +
                                                                  +

                                                                  Search results

                                                                  + +
                                                                  +
                                                                  +
                                                                    +
                                                                    +
                                                                    +
                                                                    +
                                                                    + + +
                                                                    + + + + + + + + diff --git a/docs/files/src-ratelimits.html b/docs/files/src-ratelimits.html new file mode 100644 index 00000000..9b2e8ba3 --- /dev/null +++ b/docs/files/src-ratelimits.html @@ -0,0 +1,302 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                                                                    +

                                                                    + MarketData SDK +

                                                                    + + + + + +
                                                                    + +
                                                                    +
                                                                    + + + + +
                                                                    +
                                                                    +
                                                                      +
                                                                    + +
                                                                    +

                                                                    RateLimits.php

                                                                    + + + + + + + + +

                                                                    + Table of Contents + + +

                                                                    + + + + +

                                                                    + Classes + + +

                                                                    +
                                                                    +
                                                                    RateLimits
                                                                    Represents rate limit information from API responses.
                                                                    + + + + + + + + + + + + +
                                                                    +
                                                                    +
                                                                    +
                                                                    +
                                                                    
                                                                    +        
                                                                    + +
                                                                    +
                                                                    + + + +
                                                                    +
                                                                    +
                                                                    + +
                                                                    + On this page + +
                                                                      +
                                                                    • Table Of Contents
                                                                    • +
                                                                    • + +
                                                                    • + + +
                                                                    +
                                                                    + +
                                                                    +
                                                                    +
                                                                    +
                                                                    +
                                                                    +

                                                                    Search results

                                                                    + +
                                                                    +
                                                                    +
                                                                      +
                                                                      +
                                                                      +
                                                                      +
                                                                      + + +
                                                                      + + + + + + + + diff --git a/docs/files/src-retry-retryconfig.html b/docs/files/src-retry-retryconfig.html new file mode 100644 index 00000000..60117a64 --- /dev/null +++ b/docs/files/src-retry-retryconfig.html @@ -0,0 +1,302 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                                                                      +

                                                                      + MarketData SDK +

                                                                      + + + + + +
                                                                      + +
                                                                      +
                                                                      + + + + +
                                                                      +
                                                                      +
                                                                        +
                                                                      + +
                                                                      +

                                                                      RetryConfig.php

                                                                      + + + + + + + + +

                                                                      + Table of Contents + + +

                                                                      + + + + +

                                                                      + Classes + + +

                                                                      +
                                                                      +
                                                                      RetryConfig
                                                                      Retry configuration constants matching the Python SDK.
                                                                      + + + + + + + + + + + + +
                                                                      +
                                                                      +
                                                                      +
                                                                      +
                                                                      
                                                                      +        
                                                                      + +
                                                                      +
                                                                      + + + +
                                                                      +
                                                                      +
                                                                      + +
                                                                      + On this page + +
                                                                        +
                                                                      • Table Of Contents
                                                                      • +
                                                                      • + +
                                                                      • + + +
                                                                      +
                                                                      + +
                                                                      +
                                                                      +
                                                                      +
                                                                      +
                                                                      +

                                                                      Search results

                                                                      + +
                                                                      +
                                                                      +
                                                                        +
                                                                        +
                                                                        +
                                                                        +
                                                                        + + +
                                                                        + + + + + + + + diff --git a/docs/files/src-settings.html b/docs/files/src-settings.html new file mode 100644 index 00000000..648eb074 --- /dev/null +++ b/docs/files/src-settings.html @@ -0,0 +1,302 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                                                                        +

                                                                        + MarketData SDK +

                                                                        + + + + + +
                                                                        + +
                                                                        +
                                                                        + + + + +
                                                                        +
                                                                        +
                                                                          +
                                                                        + +
                                                                        +

                                                                        Settings.php

                                                                        + + + + + + + + +

                                                                        + Table of Contents + + +

                                                                        + + + + +

                                                                        + Classes + + +

                                                                        +
                                                                        +
                                                                        Settings
                                                                        Settings class for MarketDataApp SDK.
                                                                        + + + + + + + + + + + + +
                                                                        +
                                                                        +
                                                                        +
                                                                        +
                                                                        
                                                                        +        
                                                                        + +
                                                                        +
                                                                        + + + +
                                                                        +
                                                                        +
                                                                        + +
                                                                        + On this page + +
                                                                          +
                                                                        • Table Of Contents
                                                                        • +
                                                                        • + +
                                                                        • + + +
                                                                        +
                                                                        + +
                                                                        +
                                                                        +
                                                                        +
                                                                        +
                                                                        +

                                                                        Search results

                                                                        + +
                                                                        +
                                                                        +
                                                                          +
                                                                          +
                                                                          +
                                                                          +
                                                                          + + +
                                                                          + + + + + + + + diff --git a/docs/files/src-traits-formatsfordisplay.html b/docs/files/src-traits-formatsfordisplay.html new file mode 100644 index 00000000..34e58aae --- /dev/null +++ b/docs/files/src-traits-formatsfordisplay.html @@ -0,0 +1,302 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                                                                          +

                                                                          + MarketData SDK +

                                                                          + + + + + +
                                                                          + +
                                                                          +
                                                                          + + + + +
                                                                          +
                                                                          +
                                                                            +
                                                                          + +
                                                                          +

                                                                          FormatsForDisplay.php

                                                                          + + + + + + + + +

                                                                          + Table of Contents + + +

                                                                          + + + + + +

                                                                          + Traits + + +

                                                                          +
                                                                          +
                                                                          FormatsForDisplay
                                                                          Trait for formatting values in __toString() methods.
                                                                          + + + + + + + + + + + +
                                                                          +
                                                                          +
                                                                          +
                                                                          +
                                                                          
                                                                          +        
                                                                          + +
                                                                          +
                                                                          + + + +
                                                                          +
                                                                          +
                                                                          + +
                                                                          + On this page + +
                                                                            +
                                                                          • Table Of Contents
                                                                          • +
                                                                          • + +
                                                                          • + + +
                                                                          +
                                                                          + +
                                                                          +
                                                                          +
                                                                          +
                                                                          +
                                                                          +

                                                                          Search results

                                                                          + +
                                                                          +
                                                                          +
                                                                            +
                                                                            +
                                                                            +
                                                                            +
                                                                            + + +
                                                                            + + + + + + + + diff --git a/docs/files/src-traits-universalparameters.html b/docs/files/src-traits-universalparameters.html index e0683288..9cf9a7aa 100644 --- a/docs/files/src-traits-universalparameters.html +++ b/docs/files/src-traits-universalparameters.html @@ -80,6 +80,14 @@

                                                                          • Exceptions +
                                                                          • +
                                                                          • + Logging + +
                                                                          • +
                                                                          • + Retry +
                                                                          • Traits @@ -118,14 +126,12 @@

                                                                            Fil

                                                                            UniversalParameters.php

                                                                            + + + - - - - - - +

                                                                            Table of Contents @@ -151,7 +157,6 @@

                                                                            - @@ -191,6 +196,8 @@

                                                                            if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/files/src-traits-validatesinputs.html b/docs/files/src-traits-validatesinputs.html new file mode 100644 index 00000000..bd8d210d --- /dev/null +++ b/docs/files/src-traits-validatesinputs.html @@ -0,0 +1,302 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                                                                            +

                                                                            + MarketData SDK +

                                                                            + + + + + +
                                                                            + +
                                                                            +
                                                                            + + + + +
                                                                            +
                                                                            +
                                                                              +
                                                                            + +
                                                                            +

                                                                            ValidatesInputs.php

                                                                            + + + + + + + + +

                                                                            + Table of Contents + + +

                                                                            + + + + + +

                                                                            + Traits + + +

                                                                            +
                                                                            +
                                                                            ValidatesInputs
                                                                            Trait for input validation methods.
                                                                            + + + + + + + + + + + +
                                                                            +
                                                                            +
                                                                            +
                                                                            +
                                                                            
                                                                            +        
                                                                            + +
                                                                            +
                                                                            + + + +
                                                                            +
                                                                            +
                                                                            + +
                                                                            + On this page + +
                                                                              +
                                                                            • Table Of Contents
                                                                            • +
                                                                            • + +
                                                                            • + + +
                                                                            +
                                                                            + +
                                                                            +
                                                                            +
                                                                            +
                                                                            +
                                                                            +

                                                                            Search results

                                                                            + +
                                                                            +
                                                                            +
                                                                              +
                                                                              +
                                                                              +
                                                                              +
                                                                              + + +
                                                                              + + + + + + + + diff --git a/docs/graphs/classes.html b/docs/graphs/classes.html index 61f2cf33..b32bb61b 100644 --- a/docs/graphs/classes.html +++ b/docs/graphs/classes.html @@ -68,6 +68,14 @@

                                                                            • Exceptions +
                                                                            • +
                                                                            • + Logging + +
                                                                            • +
                                                                            • + Retry +
                                                                            • Traits diff --git a/docs/index.html b/docs/index.html index 94726575..44a40c44 100644 --- a/docs/index.html +++ b/docs/index.html @@ -5,7 +5,7 @@ Documentation - + @@ -80,6 +80,14 @@

                                                                            • Exceptions +
                                                                            • +
                                                                            • + Logging + +
                                                                            • +
                                                                            • + Retry +
                                                                            • Traits diff --git a/docs/indices/files.html b/docs/indices/files.html index 02bfccac..d71f7fc5 100644 --- a/docs/indices/files.html +++ b/docs/indices/files.html @@ -80,6 +80,14 @@

                                                                            • Exceptions +
                                                                            • +
                                                                            • + Logging + +
                                                                            • +
                                                                            • + Retry +
                                                                            • Traits @@ -117,25 +125,29 @@

                                                                              A

                                                                              B

                                                                              C

                                                                              -

                                                                              E

                                                                              +

                                                                              D

                                                                              + +

                                                                              E

                                                                              O

                                                                              P

                                                                              Q

                                                                              R

                                                                              S

                                                                              U

                                                                              - +

                                                                              V

                                                                              + +
                                                                            • diff --git a/docs/js/searchIndex.js b/docs/js/searchIndex.js index 5e4f8d6b..f434e10d 100644 --- a/docs/js/searchIndex.js +++ b/docs/js/searchIndex.js @@ -11,10 +11,10 @@ Search.appendIndex( "summary": "Constructor\u0020for\u0020the\u0020Client\u0020class.", "url": "classes/MarketDataApp-Client.html#method___construct" }, { - "fqsen": "\\MarketDataApp\\Client\u003A\u003A\u0024indices", - "name": "indices", - "summary": "The\u0020index\u0020endpoints\u0020provided\u0020by\u0020the\u0020Market\u0020Data\u0020API\u0020offer\u0020access\u0020to\u0020both\u0020real\u002Dtime\u0020and\u0020historical\u0020data\u0020related\u0020to\nfinancial\u0020indices.\u0020These\u0020endpoints\u0020are\u0020designed\u0020to\u0020cater\u0020to\u0020a\u0020wide\u0020range\u0020of\u0020financial\u0020data\u0020needs.", - "url": "classes/MarketDataApp-Client.html#property_indices" + "fqsen": "\\MarketDataApp\\Client\u003A\u003AobfuscateToken\u0028\u0029", + "name": "obfuscateToken", + "summary": "Obfuscate\u0020token\u0020for\u0020logging\u0020\u002D\u0020show\u0020full\u0020length\u0020with\u0020asterisks,\u0020last\u00204\u0020chars\u0020visible.", + "url": "classes/MarketDataApp-Client.html#method_obfuscateToken" }, { "fqsen": "\\MarketDataApp\\Client\u003A\u003A\u0024stocks", "name": "stocks", @@ -55,26 +55,101 @@ Search.appendIndex( "name": "setGuzzle", "summary": "Set\u0020a\u0020custom\u0020Guzzle\u0020client.", "url": "classes/MarketDataApp-ClientBase.html#method_setGuzzle" + }, { + "fqsen": "\\MarketDataApp\\ClientBase\u003A\u003A_setup_rate_limits\u0028\u0029", + "name": "_setup_rate_limits", + "summary": "Set\u0020up\u0020initial\u0020rate\u0020limits\u0020by\u0020fetching\u0020from\u0020the\u0020\/user\/\u0020endpoint.", + "url": "classes/MarketDataApp-ClientBase.html#method__setup_rate_limits" }, { "fqsen": "\\MarketDataApp\\ClientBase\u003A\u003Aexecute_in_parallel\u0028\u0029", "name": "execute_in_parallel", - "summary": "Execute\u0020multiple\u0020API\u0020calls\u0020in\u0020parallel.", + "summary": "Execute\u0020multiple\u0020API\u0020calls\u0020in\u0020parallel\u0020with\u0020concurrency\u0020limiting.", "url": "classes/MarketDataApp-ClientBase.html#method_execute_in_parallel" }, { "fqsen": "\\MarketDataApp\\ClientBase\u003A\u003Aasync\u0028\u0029", "name": "async", - "summary": "Perform\u0020an\u0020asynchronous\u0020API\u0020request.", + "summary": "Perform\u0020an\u0020asynchronous\u0020API\u0020request\u0020with\u0020retry\u0020logic.", "url": "classes/MarketDataApp-ClientBase.html#method_async" }, { "fqsen": "\\MarketDataApp\\ClientBase\u003A\u003Aexecute\u0028\u0029", "name": "execute", - "summary": "Execute\u0020a\u0020single\u0020API\u0020request.", + "summary": "Execute\u0020a\u0020single\u0020API\u0020request\u0020with\u0020retry\u0020logic.", "url": "classes/MarketDataApp-ClientBase.html#method_execute" + }, { + "fqsen": "\\MarketDataApp\\ClientBase\u003A\u003AprocessResponse\u0028\u0029", + "name": "processResponse", + "summary": "Process\u0020the\u0020response\u0020and\u0020return\u0020the\u0020appropriate\u0020object.", + "url": "classes/MarketDataApp-ClientBase.html#method_processResponse" + }, { + "fqsen": "\\MarketDataApp\\ClientBase\u003A\u003AvalidateResponseStatusCode\u0028\u0029", + "name": "validateResponseStatusCode", + "summary": "Validate\u0020response\u0020status\u0020code\u0020and\u0020raise\u0020appropriate\u0020exceptions.", + "url": "classes/MarketDataApp-ClientBase.html#method_validateResponseStatusCode" + }, { + "fqsen": "\\MarketDataApp\\ClientBase\u003A\u003AgetErrorMessage\u0028\u0029", + "name": "getErrorMessage", + "summary": "Get\u0020error\u0020message\u0020from\u0020response.", + "url": "classes/MarketDataApp-ClientBase.html#method_getErrorMessage" + }, { + "fqsen": "\\MarketDataApp\\ClientBase\u003A\u003AextractRateLimitsFromResponse\u0028\u0029", + "name": "extractRateLimitsFromResponse", + "summary": "Extract\u0020rate\u0020limit\u0020information\u0020from\u0020response\u0020headers.", + "url": "classes/MarketDataApp-ClientBase.html#method_extractRateLimitsFromResponse" + }, { + "fqsen": "\\MarketDataApp\\ClientBase\u003A\u003AlogRequest\u0028\u0029", + "name": "logRequest", + "summary": "Log\u0020a\u0020completed\u0020HTTP\u0020request.", + "url": "classes/MarketDataApp-ClientBase.html#method_logRequest" + }, { + "fqsen": "\\MarketDataApp\\ClientBase\u003A\u003AisInternalRequest\u0028\u0029", + "name": "isInternalRequest", + "summary": "Check\u0020if\u0020a\u0020URL\u0020is\u0020for\u0020an\u0020internal\u0020request.", + "url": "classes/MarketDataApp-ClientBase.html#method_isInternalRequest" + }, { + "fqsen": "\\MarketDataApp\\ClientBase\u003A\u003AcalculateBackoffDelay\u0028\u0029", + "name": "calculateBackoffDelay", + "summary": "Calculate\u0020exponential\u0020backoff\u0020delay.", + "url": "classes/MarketDataApp-ClientBase.html#method_calculateBackoffDelay" + }, { + "fqsen": "\\MarketDataApp\\ClientBase\u003A\u003AcreateDelayedPromise\u0028\u0029", + "name": "createDelayedPromise", + "summary": "Create\u0020a\u0020promise\u0020that\u0020resolves\u0020after\u0020a\u0020delay.", + "url": "classes/MarketDataApp-ClientBase.html#method_createDelayedPromise" + }, { + "fqsen": "\\MarketDataApp\\ClientBase\u003A\u003AwaitForRetry\u0028\u0029", + "name": "waitForRetry", + "summary": "Wait\u0020for\u0020retry\u0020with\u0020exponential\u0020backoff.", + "url": "classes/MarketDataApp-ClientBase.html#method_waitForRetry" + }, { + "fqsen": "\\MarketDataApp\\ClientBase\u003A\u003AgetServicePath\u0028\u0029", + "name": "getServicePath", + "summary": "Get\u0020service\u0020path\u0020from\u0020method\u0020path\u0020using\u0020hardcoded\u0020mapping.", + "url": "classes/MarketDataApp-ClientBase.html#method_getServicePath" + }, { + "fqsen": "\\MarketDataApp\\ClientBase\u003A\u003AshouldSkipRetryDueToOfflineService\u0028\u0029", + "name": "shouldSkipRetryDueToOfflineService", + "summary": "Check\u0020if\u0020service\u0020is\u0020offline\u0020and\u0020should\u0020skip\u0020retries.", + "url": "classes/MarketDataApp-ClientBase.html#method_shouldSkipRetryDueToOfflineService" }, { "fqsen": "\\MarketDataApp\\ClientBase\u003A\u003Aheaders\u0028\u0029", "name": "headers", "summary": "Generate\u0020headers\u0020for\u0020API\u0020requests.", "url": "classes/MarketDataApp-ClientBase.html#method_headers" + }, { + "fqsen": "\\MarketDataApp\\ClientBase\u003A\u003AgetVersion\u0028\u0029", + "name": "getVersion", + "summary": "Resolve\u0020SDK\u0020version\u0020from\u0020Composer\u0020metadata\u0020when\u0020available.", + "url": "classes/MarketDataApp-ClientBase.html#method_getVersion" + }, { + "fqsen": "\\MarketDataApp\\ClientBase\u003A\u003AgetUserAgent\u0028\u0029", + "name": "getUserAgent", + "summary": "Build\u0020SDK\u0020User\u002DAgent\u0020value.", + "url": "classes/MarketDataApp-ClientBase.html#method_getUserAgent" + }, { + "fqsen": "\\MarketDataApp\\ClientBase\u003A\u003AmakeRawRequest\u0028\u0029", + "name": "makeRawRequest", + "summary": "Make\u0020a\u0020raw\u0020API\u0020request\u0020and\u0020return\u0020the\u0020response\u0020object.", + "url": "classes/MarketDataApp-ClientBase.html#method_makeRawRequest" }, { "fqsen": "\\MarketDataApp\\ClientBase\u003A\u003AAPI_URL", "name": "API_URL", @@ -85,6 +160,16 @@ Search.appendIndex( "name": "API_HOST", "summary": "The\u0020host\u0020for\u0020the\u0020Market\u0020Data\u0020API.", "url": "classes/MarketDataApp-ClientBase.html#constant_API_HOST" + }, { + "fqsen": "\\MarketDataApp\\ClientBase\u003A\u003APACKAGE_NAME", + "name": "PACKAGE_NAME", + "summary": "Composer\u0020package\u0020name\u0020for\u0020this\u0020SDK.", + "url": "classes/MarketDataApp-ClientBase.html#constant_PACKAGE_NAME" + }, { + "fqsen": "\\MarketDataApp\\ClientBase\u003A\u003AVERSION", + "name": "VERSION", + "summary": "Fallback\u0020SDK\u0020version\u0020for\u0020User\u002DAgent\u0020header.", + "url": "classes/MarketDataApp-ClientBase.html#constant_VERSION" }, { "fqsen": "\\MarketDataApp\\ClientBase\u003A\u003A\u0024guzzle", "name": "guzzle", @@ -96,40 +181,20 @@ Search.appendIndex( "summary": "", "url": "classes/MarketDataApp-ClientBase.html#property_token" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Indices", - "name": "Indices", - "summary": "Indices\u0020class\u0020for\u0020handling\u0020index\u002Drelated\u0020API\u0020endpoints.", - "url": "classes/MarketDataApp-Endpoints-Indices.html" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Indices\u003A\u003A__construct\u0028\u0029", - "name": "__construct", - "summary": "Indices\u0020constructor.", - "url": "classes/MarketDataApp-Endpoints-Indices.html#method___construct" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Indices\u003A\u003Aquote\u0028\u0029", - "name": "quote", - "summary": "Get\u0020a\u0020real\u002Dtime\u0020quote\u0020for\u0020an\u0020index.", - "url": "classes/MarketDataApp-Endpoints-Indices.html#method_quote" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Indices\u003A\u003Aquotes\u0028\u0029", - "name": "quotes", - "summary": "Get\u0020real\u002Dtime\u0020price\u0020quotes\u0020for\u0020multiple\u0020indices\u0020by\u0020doing\u0020parallel\u0020requests.", - "url": "classes/MarketDataApp-Endpoints-Indices.html#method_quotes" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Indices\u003A\u003Acandles\u0028\u0029", - "name": "candles", - "summary": "Get\u0020historical\u0020price\u0020candles\u0020for\u0020an\u0020index.", - "url": "classes/MarketDataApp-Endpoints-Indices.html#method_candles" + "fqsen": "\\MarketDataApp\\ClientBase\u003A\u003A\u0024rate_limits", + "name": "rate_limits", + "summary": "", + "url": "classes/MarketDataApp-ClientBase.html#property_rate_limits" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Indices\u003A\u003ABASE_URL", - "name": "BASE_URL", + "fqsen": "\\MarketDataApp\\ClientBase\u003A\u003A\u0024default_params", + "name": "default_params", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Indices.html#constant_BASE_URL" + "url": "classes/MarketDataApp-ClientBase.html#property_default_params" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Indices\u003A\u003A\u0024client", - "name": "client", + "fqsen": "\\MarketDataApp\\ClientBase\u003A\u003A\u0024logger", + "name": "logger", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Indices.html#property_client" + "url": "classes/MarketDataApp-ClientBase.html#property_logger" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Markets", "name": "Markets", @@ -203,7 +268,7 @@ Search.appendIndex( }, { "fqsen": "\\MarketDataApp\\Endpoints\\Options\u003A\u003Astrikes\u0028\u0029", "name": "strikes", - "summary": "Get\u0020a\u0020list\u0020of\u0020current\u0020or\u0020historical\u0020options\u0020strikes\u0020for\u0020an\u0020underlying\u0020symbol.\u0020If\u0020no\u0020optional\u0020parameters\u0020are\nused,\nthe\u0020endpoint\u0020returns\u0020the\u0020strikes\u0020for\u0020every\u0020expiration\u0020in\u0020the\u0020chain.", + "summary": "Get\u0020a\u0020list\u0020of\u0020current\u0020or\u0020historical\u0020options\u0020strikes\u0020for\u0020an\u0020underlying\u0020symbol.\u0020If\u0020no\u0020optional\u0020parameters\u0020are\nused,\u0020the\u0020endpoint\u0020returns\u0020the\u0020strikes\u0020for\u0020every\u0020expiration\u0020in\u0020the\u0020chain.", "url": "classes/MarketDataApp-Endpoints-Options.html#method_strikes" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Options\u003A\u003Aoption_chain\u0028\u0029", @@ -213,8 +278,23 @@ Search.appendIndex( }, { "fqsen": "\\MarketDataApp\\Endpoints\\Options\u003A\u003Aquotes\u0028\u0029", "name": "quotes", - "summary": "Get\u0020a\u0020current\u0020or\u0020historical\u0020end\u0020of\u0020day\u0020quote\u0020for\u0020a\u0020single\u0020options\u0020contract.", + "summary": "Get\u0020current\u0020or\u0020historical\u0020end\u0020of\u0020day\u0020quotes\u0020for\u0020one\u0020or\u0020more\u0020options\u0020contracts.", "url": "classes/MarketDataApp-Endpoints-Options.html#method_quotes" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Options\u003A\u003AquotesMultiple\u0028\u0029", + "name": "quotesMultiple", + "summary": "Get\u0020quotes\u0020for\u0020multiple\u0020option\u0020symbols\u0020concurrently.", + "url": "classes/MarketDataApp-Endpoints-Options.html#method_quotesMultiple" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Options\u003A\u003AquotesMultipleCsv\u0028\u0029", + "name": "quotesMultipleCsv", + "summary": "Handle\u0020CSV\u0020format\u0020for\u0020multiple\u0020option\u0020symbols.", + "url": "classes/MarketDataApp-Endpoints-Options.html#method_quotesMultipleCsv" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Options\u003A\u003AmergeQuotesResponses\u0028\u0029", + "name": "mergeQuotesResponses", + "summary": "Merge\u0020multiple\u0020quotes\u0020responses\u0020into\u0020a\u0020single\u0020Quotes\u0020object.", + "url": "classes/MarketDataApp-Endpoints-Options.html#method_mergeQuotesResponses" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Options\u003A\u003ABASE_URL", "name": "BASE_URL", @@ -228,148 +308,58 @@ Search.appendIndex( }, { "fqsen": "\\MarketDataApp\\Endpoints\\Requests\\Parameters", "name": "Parameters", - "summary": "Represents\u0020parameters\u0020for\u0020API\u0020requests.", + "summary": "Represents\u0020universal\u0020parameters\u0020for\u0020API\u0020requests.", "url": "classes/MarketDataApp-Endpoints-Requests-Parameters.html" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Requests\\Parameters\u003A\u003A__construct\u0028\u0029", "name": "__construct", "summary": "Parameters\u0020constructor.", "url": "classes/MarketDataApp-Endpoints-Requests-Parameters.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Requests\\Parameters\u003A\u003A__toString\u0028\u0029", + "name": "__toString", + "summary": "Returns\u0020a\u0020string\u0020representation\u0020of\u0020the\u0020parameters.", + "url": "classes/MarketDataApp-Endpoints-Requests-Parameters.html#method___toString" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Requests\\Parameters\u003A\u003A\u0024maxage", + "name": "maxage", + "summary": "Maximum\u0020acceptable\u0020age\u0020for\u0020cached\u0020data\u0020in\u0020seconds.", + "url": "classes/MarketDataApp-Endpoints-Requests-Parameters.html#property_maxage" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Requests\\Parameters\u003A\u003A\u0024format", "name": "format", "summary": "", "url": "classes/MarketDataApp-Endpoints-Requests-Parameters.html#property_format" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Indices\\Candle", - "name": "Candle", - "summary": "Represents\u0020a\u0020financial\u0020candle\u0020with\u0020open,\u0020high,\u0020low,\u0020and\u0020close\u0020prices\u0020for\u0020a\u0020specific\u0020timestamp.", - "url": "classes/MarketDataApp-Endpoints-Responses-Indices-Candle.html" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Indices\\Candle\u003A\u003A__construct\u0028\u0029", - "name": "__construct", - "summary": "Constructs\u0020a\u0020new\u0020Candle\u0020instance.", - "url": "classes/MarketDataApp-Endpoints-Responses-Indices-Candle.html#method___construct" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Indices\\Candle\u003A\u003A\u0024open", - "name": "open", + "fqsen": "\\MarketDataApp\\Endpoints\\Requests\\Parameters\u003A\u003A\u0024use_human_readable", + "name": "use_human_readable", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Indices-Candle.html#property_open" + "url": "classes/MarketDataApp-Endpoints-Requests-Parameters.html#property_use_human_readable" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Indices\\Candle\u003A\u003A\u0024high", - "name": "high", + "fqsen": "\\MarketDataApp\\Endpoints\\Requests\\Parameters\u003A\u003A\u0024mode", + "name": "mode", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Indices-Candle.html#property_high" + "url": "classes/MarketDataApp-Endpoints-Requests-Parameters.html#property_mode" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Indices\\Candle\u003A\u003A\u0024low", - "name": "low", + "fqsen": "\\MarketDataApp\\Endpoints\\Requests\\Parameters\u003A\u003A\u0024date_format", + "name": "date_format", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Indices-Candle.html#property_low" + "url": "classes/MarketDataApp-Endpoints-Requests-Parameters.html#property_date_format" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Indices\\Candle\u003A\u003A\u0024close", - "name": "close", + "fqsen": "\\MarketDataApp\\Endpoints\\Requests\\Parameters\u003A\u003A\u0024columns", + "name": "columns", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Indices-Candle.html#property_close" + "url": "classes/MarketDataApp-Endpoints-Requests-Parameters.html#property_columns" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Indices\\Candle\u003A\u003A\u0024timestamp", - "name": "timestamp", + "fqsen": "\\MarketDataApp\\Endpoints\\Requests\\Parameters\u003A\u003A\u0024add_headers", + "name": "add_headers", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Indices-Candle.html#property_timestamp" + "url": "classes/MarketDataApp-Endpoints-Requests-Parameters.html#property_add_headers" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Indices\\Candles", - "name": "Candles", - "summary": "Represents\u0020a\u0020collection\u0020of\u0020financial\u0020candles\u0020with\u0020additional\u0020metadata.", - "url": "classes/MarketDataApp-Endpoints-Responses-Indices-Candles.html" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Indices\\Candles\u003A\u003A__construct\u0028\u0029", - "name": "__construct", - "summary": "Constructs\u0020a\u0020new\u0020Candles\u0020instance\u0020from\u0020the\u0020given\u0020response\u0020object.", - "url": "classes/MarketDataApp-Endpoints-Responses-Indices-Candles.html#method___construct" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Indices\\Candles\u003A\u003A\u0024status", - "name": "status", - "summary": "Status\u0020of\u0020the\u0020candles\u0020request.", - "url": "classes/MarketDataApp-Endpoints-Responses-Indices-Candles.html#property_status" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Indices\\Candles\u003A\u003A\u0024candles", - "name": "candles", - "summary": "Array\u0020of\u0020Candle\u0020objects\u0020representing\u0020financial\u0020data.", - "url": "classes/MarketDataApp-Endpoints-Responses-Indices-Candles.html#property_candles" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Indices\\Candles\u003A\u003A\u0024next_time", - "name": "next_time", - "summary": "Unix\u0020time\u0020of\u0020the\u0020next\u0020quote\u0020if\u0020there\u0020is\u0020no\u0020data\u0020in\u0020the\u0020requested\u0020period,\u0020but\u0020there\u0020is\u0020data\u0020in\u0020a\u0020subsequent\nperiod.", - "url": "classes/MarketDataApp-Endpoints-Responses-Indices-Candles.html#property_next_time" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Indices\\Candles\u003A\u003A\u0024prev_time", - "name": "prev_time", - "summary": "Time\u0020of\u0020the\u0020previous\u0020quote\u0020if\u0020there\u0020is\u0020no\u0020data\u0020in\u0020the\u0020requested\u0020period,\u0020but\u0020there\u0020is\u0020data\u0020in\u0020a\u0020previous\u0020period.", - "url": "classes/MarketDataApp-Endpoints-Responses-Indices-Candles.html#property_prev_time" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Indices\\Quote", - "name": "Quote", - "summary": "Represents\u0020a\u0020financial\u0020quote\u0020for\u0020an\u0020index.", - "url": "classes/MarketDataApp-Endpoints-Responses-Indices-Quote.html" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Indices\\Quote\u003A\u003A__construct\u0028\u0029", - "name": "__construct", - "summary": "Constructs\u0020a\u0020new\u0020Quote\u0020instance.", - "url": "classes/MarketDataApp-Endpoints-Responses-Indices-Quote.html#method___construct" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Indices\\Quote\u003A\u003A\u0024status", - "name": "status", - "summary": "Status\u0020of\u0020the\u0020quote\u0020request.\u0020Will\u0020always\u0020be\u0020ok\u0020when\u0020there\u0020is\u0020data\u0020for\u0020the\u0020symbol\u0020requested.", - "url": "classes/MarketDataApp-Endpoints-Responses-Indices-Quote.html#property_status" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Indices\\Quote\u003A\u003A\u0024symbol", - "name": "symbol", - "summary": "The\u0020symbol\u0020of\u0020the\u0020index.", - "url": "classes/MarketDataApp-Endpoints-Responses-Indices-Quote.html#property_symbol" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Indices\\Quote\u003A\u003A\u0024last", - "name": "last", - "summary": "The\u0020last\u0020price\u0020of\u0020the\u0020index.", - "url": "classes/MarketDataApp-Endpoints-Responses-Indices-Quote.html#property_last" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Indices\\Quote\u003A\u003A\u0024change", - "name": "change", - "summary": "The\u0020difference\u0020in\u0020price\u0020in\u0020dollars\u0020\u0028or\u0020the\u0020index\u0027s\u0020native\u0020currency\u0020if\u0020different\u0020from\u0020dollars\u0029\u0020compared\u0020to\u0020the\nclosing\u0020price\u0020of\u0020the\u0020previous\u0020day.", - "url": "classes/MarketDataApp-Endpoints-Responses-Indices-Quote.html#property_change" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Indices\\Quote\u003A\u003A\u0024change_percent", - "name": "change_percent", - "summary": "The\u0020difference\u0020in\u0020price\u0020in\u0020percent\u0020compared\u0020to\u0020the\u0020closing\u0020price\u0020of\u0020the\u0020previous\u0020day.", - "url": "classes/MarketDataApp-Endpoints-Responses-Indices-Quote.html#property_change_percent" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Indices\\Quote\u003A\u003A\u0024fifty_two_week_high", - "name": "fifty_two_week_high", - "summary": "The\u002052\u002Dweek\u0020high\u0020for\u0020the\u0020index.", - "url": "classes/MarketDataApp-Endpoints-Responses-Indices-Quote.html#property_fifty_two_week_high" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Indices\\Quote\u003A\u003A\u0024fifty_two_week_low", - "name": "fifty_two_week_low", - "summary": "The\u002052\u002Dweek\u0020low\u0020for\u0020the\u0020index.", - "url": "classes/MarketDataApp-Endpoints-Responses-Indices-Quote.html#property_fifty_two_week_low" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Indices\\Quote\u003A\u003A\u0024updated", - "name": "updated", - "summary": "The\u0020date\/time\u0020of\u0020the\u0020quote.", - "url": "classes/MarketDataApp-Endpoints-Responses-Indices-Quote.html#property_updated" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Indices\\Quotes", - "name": "Quotes", - "summary": "Represents\u0020a\u0020collection\u0020of\u0020Quote\u0020objects.", - "url": "classes/MarketDataApp-Endpoints-Responses-Indices-Quotes.html" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Indices\\Quotes\u003A\u003A__construct\u0028\u0029", - "name": "__construct", - "summary": "Constructs\u0020a\u0020new\u0020Quotes\u0020instance\u0020from\u0020an\u0020array\u0020of\u0020quote\u0020data.", - "url": "classes/MarketDataApp-Endpoints-Responses-Indices-Quotes.html#method___construct" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Indices\\Quotes\u003A\u003A\u0024quotes", - "name": "quotes", - "summary": "Array\u0020of\u0020Quote\u0020objects.", - "url": "classes/MarketDataApp-Endpoints-Responses-Indices-Quotes.html#property_quotes" + "fqsen": "\\MarketDataApp\\Endpoints\\Requests\\Parameters\u003A\u003A\u0024filename", + "name": "filename", + "summary": "", + "url": "classes/MarketDataApp-Endpoints-Requests-Parameters.html#property_filename" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Markets\\Status", "name": "Status", @@ -380,6 +370,11 @@ Search.appendIndex( "name": "__construct", "summary": "Constructs\u0020a\u0020new\u0020Status\u0020instance.", "url": "classes/MarketDataApp-Endpoints-Responses-Markets-Status.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Markets\\Status\u003A\u003A__toString\u0028\u0029", + "name": "__toString", + "summary": "Returns\u0020a\u0020string\u0020representation\u0020of\u0020the\u0020market\u0020status.", + "url": "classes/MarketDataApp-Endpoints-Responses-Markets-Status.html#method___toString" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Markets\\Status\u003A\u003A\u0024date", "name": "date", @@ -400,6 +395,11 @@ Search.appendIndex( "name": "__construct", "summary": "Constructs\u0020a\u0020new\u0020Statuses\u0020instance\u0020from\u0020the\u0020given\u0020response\u0020object.", "url": "classes/MarketDataApp-Endpoints-Responses-Markets-Statuses.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Markets\\Statuses\u003A\u003A__toString\u0028\u0029", + "name": "__toString", + "summary": "Returns\u0020a\u0020string\u0020representation\u0020of\u0020the\u0020market\u0020statuses\u0020collection.", + "url": "classes/MarketDataApp-Endpoints-Responses-Markets-Statuses.html#method___toString" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Markets\\Statuses\u003A\u003A\u0024status", "name": "status", @@ -420,6 +420,11 @@ Search.appendIndex( "name": "__construct", "summary": "Constructs\u0020a\u0020new\u0020Candle\u0020instance.", "url": "classes/MarketDataApp-Endpoints-Responses-MutualFunds-Candle.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\MutualFunds\\Candle\u003A\u003A__toString\u0028\u0029", + "name": "__toString", + "summary": "Returns\u0020a\u0020string\u0020representation\u0020of\u0020the\u0020mutual\u0020fund\u0020candle.", + "url": "classes/MarketDataApp-Endpoints-Responses-MutualFunds-Candle.html#method___toString" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\MutualFunds\\Candle\u003A\u003A\u0024open", "name": "open", @@ -455,6 +460,11 @@ Search.appendIndex( "name": "__construct", "summary": "Constructs\u0020a\u0020new\u0020Candles\u0020instance\u0020from\u0020the\u0020given\u0020response\u0020object.", "url": "classes/MarketDataApp-Endpoints-Responses-MutualFunds-Candles.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\MutualFunds\\Candles\u003A\u003A__toString\u0028\u0029", + "name": "__toString", + "summary": "Returns\u0020a\u0020string\u0020representation\u0020of\u0020the\u0020mutual\u0020funds\u0020candles\u0020collection.", + "url": "classes/MarketDataApp-Endpoints-Responses-MutualFunds-Candles.html#method___toString" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\MutualFunds\\Candles\u003A\u003A\u0024status", "name": "status", @@ -480,6 +490,11 @@ Search.appendIndex( "name": "__construct", "summary": "Constructs\u0020a\u0020new\u0020Expirations\u0020instance\u0020from\u0020the\u0020given\u0020response\u0020object.", "url": "classes/MarketDataApp-Endpoints-Responses-Options-Expirations.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Expirations\u003A\u003A__toString\u0028\u0029", + "name": "__toString", + "summary": "Returns\u0020a\u0020string\u0020representation\u0020of\u0020the\u0020expirations\u0020collection.", + "url": "classes/MarketDataApp-Endpoints-Responses-Options-Expirations.html#method___toString" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Expirations\u003A\u003A\u0024status", "name": "status", @@ -515,6 +530,11 @@ Search.appendIndex( "name": "__construct", "summary": "Constructs\u0020a\u0020new\u0020Lookup\u0020instance\u0020from\u0020the\u0020given\u0020response\u0020object.", "url": "classes/MarketDataApp-Endpoints-Responses-Options-Lookup.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Lookup\u003A\u003A__toString\u0028\u0029", + "name": "__toString", + "summary": "Returns\u0020a\u0020string\u0020representation\u0020of\u0020the\u0020lookup\u0020result.", + "url": "classes/MarketDataApp-Endpoints-Responses-Options-Lookup.html#method___toString" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Lookup\u003A\u003A\u0024status", "name": "status", @@ -535,6 +555,56 @@ Search.appendIndex( "name": "__construct", "summary": "Constructs\u0020a\u0020new\u0020OptionChains\u0020instance\u0020from\u0020the\u0020given\u0020response\u0020object.", "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChains.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChains\u003A\u003AtoQuotes\u0028\u0029", + "name": "toQuotes", + "summary": "Convert\u0020the\u0020option\u0020chains\u0020to\u0020a\u0020flat\u0020Quotes\u0020object.", + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChains.html#method_toQuotes" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChains\u003A\u003AgetAllQuotes\u0028\u0029", + "name": "getAllQuotes", + "summary": "Get\u0020all\u0020option\u0020quotes\u0020as\u0020a\u0020flat\u0020array.", + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChains.html#method_getAllQuotes" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChains\u003A\u003AgetExpirationDates\u0028\u0029", + "name": "getExpirationDates", + "summary": "Get\u0020all\u0020expiration\u0020dates\u0020in\u0020the\u0020chain.", + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChains.html#method_getExpirationDates" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChains\u003A\u003AgetQuotesByExpiration\u0028\u0029", + "name": "getQuotesByExpiration", + "summary": "Get\u0020option\u0020quotes\u0020for\u0020a\u0020specific\u0020expiration\u0020date.", + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChains.html#method_getQuotesByExpiration" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChains\u003A\u003Acount\u0028\u0029", + "name": "count", + "summary": "Get\u0020the\u0020total\u0020count\u0020of\u0020option\u0020quotes\u0020across\u0020all\u0020expirations.", + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChains.html#method_count" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChains\u003A\u003AgetCalls\u0028\u0029", + "name": "getCalls", + "summary": "Get\u0020only\u0020call\u0020options\u0020from\u0020the\u0020chain.", + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChains.html#method_getCalls" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChains\u003A\u003AgetPuts\u0028\u0029", + "name": "getPuts", + "summary": "Get\u0020only\u0020put\u0020options\u0020from\u0020the\u0020chain.", + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChains.html#method_getPuts" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChains\u003A\u003AgetByStrike\u0028\u0029", + "name": "getByStrike", + "summary": "Get\u0020option\u0020quotes\u0020for\u0020a\u0020specific\u0020strike\u0020price.", + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChains.html#method_getByStrike" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChains\u003A\u003AgetStrikes\u0028\u0029", + "name": "getStrikes", + "summary": "Get\u0020all\u0020unique\u0020strike\u0020prices\u0020in\u0020the\u0020chain,\u0020sorted\u0020ascending.", + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChains.html#method_getStrikes" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChains\u003A\u003A__toString\u0028\u0029", + "name": "__toString", + "summary": "Returns\u0020a\u0020string\u0020representation\u0020of\u0020the\u0020option\u0020chains\u0020collection.", + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChains.html#method___toString" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChains\u003A\u003A\u0024status", "name": "status", @@ -553,268 +623,168 @@ Search.appendIndex( }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChains\u003A\u003A\u0024option_chains", "name": "option_chains", - "summary": "Multidimensional\u0020array\u0020of\u0020OptionChainStrike\u0020objects\u0020organized\u0020by\u0020date.", + "summary": "Multidimensional\u0020array\u0020of\u0020OptionQuote\u0020objects\u0020organized\u0020by\u0020date.", "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChains.html#property_option_chains" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChainStrike", - "name": "OptionChainStrike", - "summary": "Represents\u0020a\u0020single\u0020option\u0020chain\u0020strike\u0020with\u0020associated\u0020data.", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChainStrike.html" + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionQuote", + "name": "OptionQuote", + "summary": "Represents\u0020a\u0020single\u0020option\u0020quote\u0020with\u0020associated\u0020data.", + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionQuote.html" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChainStrike\u003A\u003A__construct\u0028\u0029", + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionQuote\u003A\u003A__construct\u0028\u0029", "name": "__construct", - "summary": "Constructs\u0020a\u0020new\u0020OptionChainStrike\u0020instance.", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChainStrike.html#method___construct" + "summary": "Constructs\u0020a\u0020new\u0020OptionQuote\u0020instance.", + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionQuote.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionQuote\u003A\u003A__toString\u0028\u0029", + "name": "__toString", + "summary": "Returns\u0020a\u0020string\u0020representation\u0020of\u0020the\u0020option\u0020quote.", + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionQuote.html#method___toString" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChainStrike\u003A\u003A\u0024option_symbol", + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionQuote\u003A\u003A\u0024option_symbol", "name": "option_symbol", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChainStrike.html#property_option_symbol" + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionQuote.html#property_option_symbol" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChainStrike\u003A\u003A\u0024underlying", + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionQuote\u003A\u003A\u0024underlying", "name": "underlying", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChainStrike.html#property_underlying" + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionQuote.html#property_underlying" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChainStrike\u003A\u003A\u0024expiration", + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionQuote\u003A\u003A\u0024expiration", "name": "expiration", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChainStrike.html#property_expiration" + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionQuote.html#property_expiration" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChainStrike\u003A\u003A\u0024side", + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionQuote\u003A\u003A\u0024side", "name": "side", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChainStrike.html#property_side" + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionQuote.html#property_side" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChainStrike\u003A\u003A\u0024strike", + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionQuote\u003A\u003A\u0024strike", "name": "strike", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChainStrike.html#property_strike" + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionQuote.html#property_strike" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChainStrike\u003A\u003A\u0024first_traded", + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionQuote\u003A\u003A\u0024first_traded", "name": "first_traded", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChainStrike.html#property_first_traded" + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionQuote.html#property_first_traded" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChainStrike\u003A\u003A\u0024dte", + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionQuote\u003A\u003A\u0024dte", "name": "dte", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChainStrike.html#property_dte" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChainStrike\u003A\u003A\u0024ask", - "name": "ask", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChainStrike.html#property_ask" + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionQuote.html#property_dte" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChainStrike\u003A\u003A\u0024ask_size", - "name": "ask_size", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChainStrike.html#property_ask_size" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChainStrike\u003A\u003A\u0024bid", - "name": "bid", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChainStrike.html#property_bid" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChainStrike\u003A\u003A\u0024bid_size", - "name": "bid_size", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChainStrike.html#property_bid_size" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChainStrike\u003A\u003A\u0024mid", - "name": "mid", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChainStrike.html#property_mid" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChainStrike\u003A\u003A\u0024last", - "name": "last", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChainStrike.html#property_last" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChainStrike\u003A\u003A\u0024volume", - "name": "volume", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChainStrike.html#property_volume" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChainStrike\u003A\u003A\u0024open_interest", - "name": "open_interest", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChainStrike.html#property_open_interest" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChainStrike\u003A\u003A\u0024underlying_price", - "name": "underlying_price", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChainStrike.html#property_underlying_price" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChainStrike\u003A\u003A\u0024in_the_money", - "name": "in_the_money", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChainStrike.html#property_in_the_money" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChainStrike\u003A\u003A\u0024intrinsic_value", - "name": "intrinsic_value", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChainStrike.html#property_intrinsic_value" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChainStrike\u003A\u003A\u0024extrinsic_value", - "name": "extrinsic_value", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChainStrike.html#property_extrinsic_value" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChainStrike\u003A\u003A\u0024implied_volatility", - "name": "implied_volatility", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChainStrike.html#property_implied_volatility" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChainStrike\u003A\u003A\u0024delta", - "name": "delta", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChainStrike.html#property_delta" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChainStrike\u003A\u003A\u0024gamma", - "name": "gamma", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChainStrike.html#property_gamma" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChainStrike\u003A\u003A\u0024theta", - "name": "theta", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChainStrike.html#property_theta" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChainStrike\u003A\u003A\u0024vega", - "name": "vega", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChainStrike.html#property_vega" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChainStrike\u003A\u003A\u0024rho", - "name": "rho", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChainStrike.html#property_rho" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionChainStrike\u003A\u003A\u0024updated", - "name": "updated", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionChainStrike.html#property_updated" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Quote", - "name": "Quote", - "summary": "Represents\u0020a\u0020single\u0020option\u0020quote\u0020with\u0020associated\u0020data.", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-Quote.html" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Quote\u003A\u003A__construct\u0028\u0029", - "name": "__construct", - "summary": "Constructs\u0020a\u0020new\u0020Quote\u0020instance.", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-Quote.html#method___construct" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Quote\u003A\u003A\u0024option_symbol", - "name": "option_symbol", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-Quote.html#property_option_symbol" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Quote\u003A\u003A\u0024ask", + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionQuote\u003A\u003A\u0024ask", "name": "ask", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-Quote.html#property_ask" + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionQuote.html#property_ask" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Quote\u003A\u003A\u0024ask_size", + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionQuote\u003A\u003A\u0024ask_size", "name": "ask_size", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-Quote.html#property_ask_size" + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionQuote.html#property_ask_size" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Quote\u003A\u003A\u0024bid", + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionQuote\u003A\u003A\u0024bid", "name": "bid", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-Quote.html#property_bid" + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionQuote.html#property_bid" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Quote\u003A\u003A\u0024bid_size", + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionQuote\u003A\u003A\u0024bid_size", "name": "bid_size", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-Quote.html#property_bid_size" + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionQuote.html#property_bid_size" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Quote\u003A\u003A\u0024mid", + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionQuote\u003A\u003A\u0024mid", "name": "mid", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-Quote.html#property_mid" + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionQuote.html#property_mid" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Quote\u003A\u003A\u0024last", + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionQuote\u003A\u003A\u0024last", "name": "last", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-Quote.html#property_last" + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionQuote.html#property_last" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Quote\u003A\u003A\u0024volume", + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionQuote\u003A\u003A\u0024volume", "name": "volume", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-Quote.html#property_volume" + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionQuote.html#property_volume" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Quote\u003A\u003A\u0024open_interest", + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionQuote\u003A\u003A\u0024open_interest", "name": "open_interest", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-Quote.html#property_open_interest" + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionQuote.html#property_open_interest" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Quote\u003A\u003A\u0024underlying_price", + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionQuote\u003A\u003A\u0024underlying_price", "name": "underlying_price", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-Quote.html#property_underlying_price" + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionQuote.html#property_underlying_price" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Quote\u003A\u003A\u0024in_the_money", + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionQuote\u003A\u003A\u0024in_the_money", "name": "in_the_money", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-Quote.html#property_in_the_money" + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionQuote.html#property_in_the_money" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Quote\u003A\u003A\u0024intrinsic_value", + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionQuote\u003A\u003A\u0024intrinsic_value", "name": "intrinsic_value", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-Quote.html#property_intrinsic_value" + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionQuote.html#property_intrinsic_value" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Quote\u003A\u003A\u0024extrinsic_value", + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionQuote\u003A\u003A\u0024extrinsic_value", "name": "extrinsic_value", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-Quote.html#property_extrinsic_value" + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionQuote.html#property_extrinsic_value" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Quote\u003A\u003A\u0024implied_volatility", + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionQuote\u003A\u003A\u0024implied_volatility", "name": "implied_volatility", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-Quote.html#property_implied_volatility" + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionQuote.html#property_implied_volatility" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Quote\u003A\u003A\u0024delta", + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionQuote\u003A\u003A\u0024delta", "name": "delta", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-Quote.html#property_delta" + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionQuote.html#property_delta" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Quote\u003A\u003A\u0024gamma", + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionQuote\u003A\u003A\u0024gamma", "name": "gamma", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-Quote.html#property_gamma" + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionQuote.html#property_gamma" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Quote\u003A\u003A\u0024theta", + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionQuote\u003A\u003A\u0024theta", "name": "theta", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-Quote.html#property_theta" + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionQuote.html#property_theta" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Quote\u003A\u003A\u0024vega", + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionQuote\u003A\u003A\u0024vega", "name": "vega", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-Quote.html#property_vega" + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionQuote.html#property_vega" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Quote\u003A\u003A\u0024rho", - "name": "rho", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-Quote.html#property_rho" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Quote\u003A\u003A\u0024updated", + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\OptionQuote\u003A\u003A\u0024updated", "name": "updated", "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Options-Quote.html#property_updated" + "url": "classes/MarketDataApp-Endpoints-Responses-Options-OptionQuote.html#property_updated" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Quotes", "name": "Quotes", "summary": "Represents\u0020a\u0020collection\u0020of\u0020option\u0020quotes\u0020with\u0020associated\u0020data.", "url": "classes/MarketDataApp-Endpoints-Responses-Options-Quotes.html" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Quotes\u003A\u003AcreateMerged\u0028\u0029", + "name": "createMerged", + "summary": "Create\u0020a\u0020Quotes\u0020object\u0020from\u0020pre\u002Dmerged\u0020data.", + "url": "classes/MarketDataApp-Endpoints-Responses-Options-Quotes.html#method_createMerged" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Quotes\u003A\u003A__construct\u0028\u0029", "name": "__construct", "summary": "Constructs\u0020a\u0020new\u0020Quotes\u0020instance\u0020from\u0020the\u0020given\u0020response\u0020object.", "url": "classes/MarketDataApp-Endpoints-Responses-Options-Quotes.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Quotes\u003A\u003A__toString\u0028\u0029", + "name": "__toString", + "summary": "Returns\u0020a\u0020string\u0020representation\u0020of\u0020the\u0020option\u0020quotes\u0020collection.", + "url": "classes/MarketDataApp-Endpoints-Responses-Options-Quotes.html#method___toString" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Quotes\u003A\u003A\u0024status", "name": "status", @@ -833,8 +803,13 @@ Search.appendIndex( }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Quotes\u003A\u003A\u0024quotes", "name": "quotes", - "summary": "Array\u0020of\u0020Quote\u0020objects.", + "summary": "Array\u0020of\u0020OptionQuote\u0020objects.", "url": "classes/MarketDataApp-Endpoints-Responses-Options-Quotes.html#property_quotes" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Quotes\u003A\u003A\u0024errors", + "name": "errors", + "summary": "Array\u0020of\u0020errors\u0020for\u0020failed\u0020symbol\u0020requests\u0020\u0028multi\u002Dsymbol\u0020requests\u0020only\u0029.", + "url": "classes/MarketDataApp-Endpoints-Responses-Options-Quotes.html#property_errors" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Strikes", "name": "Strikes", @@ -845,6 +820,11 @@ Search.appendIndex( "name": "__construct", "summary": "Constructs\u0020a\u0020new\u0020Strikes\u0020instance\u0020from\u0020the\u0020given\u0020response\u0020object.", "url": "classes/MarketDataApp-Endpoints-Responses-Options-Strikes.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Strikes\u003A\u003A__toString\u0028\u0029", + "name": "__toString", + "summary": "Returns\u0020a\u0020string\u0020representation\u0020of\u0020the\u0020strikes\u0020collection.", + "url": "classes/MarketDataApp-Endpoints-Responses-Options-Strikes.html#method___toString" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Options\\Strikes\u003A\u003A\u0024status", "name": "status", @@ -905,6 +885,11 @@ Search.appendIndex( "name": "isCsv", "summary": "Check\u0020if\u0020the\u0020response\u0020is\u0020in\u0020CSV\u0020format.", "url": "classes/MarketDataApp-Endpoints-Responses-ResponseBase.html#method_isCsv" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\ResponseBase\u003A\u003AsaveToFile\u0028\u0029", + "name": "saveToFile", + "summary": "Save\u0020CSV\/HTML\u0020content\u0020to\u0020a\u0020file.", + "url": "classes/MarketDataApp-Endpoints-Responses-ResponseBase.html#method_saveToFile" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\ResponseBase\u003A\u003A\u0024csv", "name": "csv", @@ -915,6 +900,11 @@ Search.appendIndex( "name": "html", "summary": "", "url": "classes/MarketDataApp-Endpoints-Responses-ResponseBase.html#property_html" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\ResponseBase\u003A\u003A\u0024_saved_filename", + "name": "_saved_filename", + "summary": "", + "url": "classes/MarketDataApp-Endpoints-Responses-ResponseBase.html#property__saved_filename" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\BulkCandles", "name": "BulkCandles", @@ -925,6 +915,11 @@ Search.appendIndex( "name": "__construct", "summary": "Constructs\u0020a\u0020new\u0020BulkCandles\u0020instance\u0020from\u0020the\u0020given\u0020response\u0020object.", "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-BulkCandles.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\BulkCandles\u003A\u003A__toString\u0028\u0029", + "name": "__toString", + "summary": "Returns\u0020a\u0020string\u0020representation\u0020of\u0020the\u0020bulk\u0020candles\u0020collection.", + "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-BulkCandles.html#method___toString" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\BulkCandles\u003A\u003A\u0024status", "name": "status", @@ -935,101 +930,6 @@ Search.appendIndex( "name": "candles", "summary": "Array\u0020of\u0020Candle\u0020objects\u0020representing\u0020individual\u0020stock\u0020candles.", "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-BulkCandles.html#property_candles" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\BulkQuote", - "name": "BulkQuote", - "summary": "Represents\u0020a\u0020bulk\u0020quote\u0020for\u0020a\u0020stock\u0020with\u0020various\u0020price\u0020and\u0020volume\u0020information.", - "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-BulkQuote.html" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\BulkQuote\u003A\u003A__construct\u0028\u0029", - "name": "__construct", - "summary": "Constructs\u0020a\u0020new\u0020BulkQuote\u0020instance.", - "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-BulkQuote.html#method___construct" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\BulkQuote\u003A\u003A\u0024symbol", - "name": "symbol", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-BulkQuote.html#property_symbol" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\BulkQuote\u003A\u003A\u0024ask", - "name": "ask", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-BulkQuote.html#property_ask" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\BulkQuote\u003A\u003A\u0024ask_size", - "name": "ask_size", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-BulkQuote.html#property_ask_size" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\BulkQuote\u003A\u003A\u0024bid", - "name": "bid", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-BulkQuote.html#property_bid" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\BulkQuote\u003A\u003A\u0024bid_size", - "name": "bid_size", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-BulkQuote.html#property_bid_size" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\BulkQuote\u003A\u003A\u0024mid", - "name": "mid", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-BulkQuote.html#property_mid" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\BulkQuote\u003A\u003A\u0024last", - "name": "last", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-BulkQuote.html#property_last" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\BulkQuote\u003A\u003A\u0024change", - "name": "change", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-BulkQuote.html#property_change" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\BulkQuote\u003A\u003A\u0024change_percent", - "name": "change_percent", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-BulkQuote.html#property_change_percent" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\BulkQuote\u003A\u003A\u0024fifty_two_week_high", - "name": "fifty_two_week_high", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-BulkQuote.html#property_fifty_two_week_high" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\BulkQuote\u003A\u003A\u0024fifty_two_week_low", - "name": "fifty_two_week_low", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-BulkQuote.html#property_fifty_two_week_low" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\BulkQuote\u003A\u003A\u0024volume", - "name": "volume", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-BulkQuote.html#property_volume" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\BulkQuote\u003A\u003A\u0024updated", - "name": "updated", - "summary": "", - "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-BulkQuote.html#property_updated" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\BulkQuotes", - "name": "BulkQuotes", - "summary": "Represents\u0020a\u0020collection\u0020of\u0020bulk\u0020stock\u0020quotes.", - "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-BulkQuotes.html" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\BulkQuotes\u003A\u003A__construct\u0028\u0029", - "name": "__construct", - "summary": "Constructs\u0020a\u0020new\u0020BulkQuotes\u0020instance\u0020from\u0020the\u0020given\u0020response\u0020object.", - "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-BulkQuotes.html#method___construct" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\BulkQuotes\u003A\u003A\u0024status", - "name": "status", - "summary": "Status\u0020of\u0020the\u0020bulk\u0020quotes\u0020request.\u0020Will\u0020always\u0020be\u0020ok\u0020when\u0020there\u0020is\u0020data\u0020for\u0020the\u0020symbol\u0020requested.", - "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-BulkQuotes.html#property_status" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\BulkQuotes\u003A\u003A\u0024quotes", - "name": "quotes", - "summary": "Array\u0020of\u0020BulkQuote\u0020objects\u0020representing\u0020individual\u0020stock\u0020quotes.", - "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-BulkQuotes.html#property_quotes" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\Candle", "name": "Candle", @@ -1040,6 +940,11 @@ Search.appendIndex( "name": "__construct", "summary": "Constructs\u0020a\u0020new\u0020Candle\u0020instance.", "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-Candle.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\Candle\u003A\u003A__toString\u0028\u0029", + "name": "__toString", + "summary": "Returns\u0020a\u0020string\u0020representation\u0020of\u0020the\u0020candle.", + "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-Candle.html#method___toString" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\Candle\u003A\u003A\u0024open", "name": "open", @@ -1070,6 +975,11 @@ Search.appendIndex( "name": "timestamp", "summary": "", "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-Candle.html#property_timestamp" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\Candle\u003A\u003A\u0024symbol", + "name": "symbol", + "summary": "", + "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-Candle.html#property_symbol" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\Candles", "name": "Candles", @@ -1080,6 +990,16 @@ Search.appendIndex( "name": "__construct", "summary": "Constructs\u0020a\u0020new\u0020Candles\u0020object\u0020and\u0020parses\u0020the\u0020response\u0020data.", "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-Candles.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\Candles\u003A\u003AcreateMerged\u0028\u0029", + "name": "createMerged", + "summary": "Create\u0020a\u0020Candles\u0020object\u0020from\u0020pre\u002Dmerged\u0020data.", + "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-Candles.html#method_createMerged" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\Candles\u003A\u003A__toString\u0028\u0029", + "name": "__toString", + "summary": "Returns\u0020a\u0020string\u0020representation\u0020of\u0020the\u0020candles\u0020collection.", + "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-Candles.html#method___toString" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\Candles\u003A\u003A\u0024status", "name": "status", @@ -1105,6 +1025,11 @@ Search.appendIndex( "name": "__construct", "summary": "Constructs\u0020a\u0020new\u0020Earning\u0020object\u0020with\u0020detailed\u0020earnings\u0020information.", "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-Earning.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\Earning\u003A\u003A__toString\u0028\u0029", + "name": "__toString", + "summary": "Returns\u0020a\u0020string\u0020representation\u0020of\u0020the\u0020earnings\u0020data.", + "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-Earning.html#method___toString" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\Earning\u003A\u003A\u0024symbol", "name": "symbol", @@ -1175,6 +1100,11 @@ Search.appendIndex( "name": "__construct", "summary": "Constructs\u0020a\u0020new\u0020Earnings\u0020object\u0020and\u0020parses\u0020the\u0020response\u0020data.", "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-Earnings.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\Earnings\u003A\u003A__toString\u0028\u0029", + "name": "__toString", + "summary": "Returns\u0020a\u0020string\u0020representation\u0020of\u0020the\u0020earnings\u0020collection.", + "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-Earnings.html#method___toString" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\Earnings\u003A\u003A\u0024status", "name": "status", @@ -1195,6 +1125,11 @@ Search.appendIndex( "name": "__construct", "summary": "Constructs\u0020a\u0020new\u0020News\u0020object\u0020and\u0020parses\u0020the\u0020response\u0020data.", "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-News.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\News\u003A\u003A__toString\u0028\u0029", + "name": "__toString", + "summary": "Returns\u0020a\u0020string\u0020representation\u0020of\u0020the\u0020news\u0020article.", + "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-News.html#method___toString" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\News\u003A\u003A\u0024status", "name": "status", @@ -1225,6 +1160,51 @@ Search.appendIndex( "name": "publication_date", "summary": "The\u0020date\u0020the\u0020news\u0020was\u0020published\u0020on\u0020the\u0020source\u0020website.", "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-News.html#property_publication_date" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\Prices", + "name": "Prices", + "summary": "Class\u0020Prices", + "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-Prices.html" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\Prices\u003A\u003A__construct\u0028\u0029", + "name": "__construct", + "summary": "Constructs\u0020a\u0020new\u0020Prices\u0020object\u0020and\u0020parses\u0020the\u0020response\u0020data.", + "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-Prices.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\Prices\u003A\u003A__toString\u0028\u0029", + "name": "__toString", + "summary": "Returns\u0020a\u0020string\u0020representation\u0020of\u0020the\u0020prices\u0020collection.", + "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-Prices.html#method___toString" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\Prices\u003A\u003A\u0024status", + "name": "status", + "summary": "The\u0020status\u0020of\u0020the\u0020response.\u0020Will\u0020be\u0020\u0022ok\u0022\u0020when\u0020there\u0020is\u0020data,\u0020\u0022no_data\u0022\u0020when\u0020no\u0020prices\u0020can\u0020be\u0020found,\nor\u0020\u0022error\u0022\u0020if\u0020the\u0020request\u0020produces\u0020an\u0020error\u0020response.", + "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-Prices.html#property_status" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\Prices\u003A\u003A\u0024symbols", + "name": "symbols", + "summary": "Array\u0020of\u0020ticker\u0020symbols\u0020that\u0020were\u0020requested.", + "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-Prices.html#property_symbols" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\Prices\u003A\u003A\u0024mid", + "name": "mid", + "summary": "Array\u0020of\u0020midpoint\u0020prices,\u0020as\u0020calculated\u0020by\u0020the\u0020SmartMid\u0020model.", + "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-Prices.html#property_mid" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\Prices\u003A\u003A\u0024change", + "name": "change", + "summary": "Array\u0020of\u0020price\u0020changes\u0020in\u0020currency\u0020units\u0020compared\u0020to\u0020the\u0020closing\u0020price\u0020of\u0020the\u0020previous\u0020primary\u0020trading\u0020session.", + "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-Prices.html#property_change" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\Prices\u003A\u003A\u0024changepct", + "name": "changepct", + "summary": "Array\u0020of\u0020price\u0020changes\u0020in\u0020percent,\u0020expressed\u0020as\u0020a\u0020decimal,\u0020compared\u0020to\u0020the\u0020closing\u0020price\u0020of\u0020the\u0020previous\u0020day.", + "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-Prices.html#property_changepct" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\Prices\u003A\u003A\u0024updated", + "name": "updated", + "summary": "Array\u0020of\u0020date\/times\u0020for\u0020each\u0020stock\u0020price.", + "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-Prices.html#property_updated" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\Quote", "name": "Quote", @@ -1235,6 +1215,11 @@ Search.appendIndex( "name": "__construct", "summary": "Constructs\u0020a\u0020new\u0020Quote\u0020object\u0020and\u0020parses\u0020the\u0020response\u0020data.", "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-Quote.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\Quote\u003A\u003A__toString\u0028\u0029", + "name": "__toString", + "summary": "Returns\u0020a\u0020string\u0020representation\u0020of\u0020the\u0020quote.", + "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-Quote.html#method___toString" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\Quote\u003A\u003A\u0024status", "name": "status", @@ -1315,6 +1300,16 @@ Search.appendIndex( "name": "__construct", "summary": "Quotes\u0020constructor.", "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-Quotes.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\Quotes\u003A\u003AextractQuoteAtIndex\u0028\u0029", + "name": "extractQuoteAtIndex", + "summary": "Extract\u0020quote\u0020data\u0020at\u0020a\u0020specific\u0020index\u0020from\u0020the\u0020multi\u002Dsymbol\u0020response.", + "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-Quotes.html#method_extractQuoteAtIndex" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\Quotes\u003A\u003A__toString\u0028\u0029", + "name": "__toString", + "summary": "Returns\u0020a\u0020string\u0020representation\u0020of\u0020the\u0020quotes\u0020collection.", + "url": "classes/MarketDataApp-Endpoints-Responses-Stocks-Quotes.html#method___toString" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Stocks\\Quotes\u003A\u003A\u0024quotes", "name": "quotes", @@ -1330,6 +1325,11 @@ Search.appendIndex( "name": "__construct", "summary": "ApiStatus\u0020constructor.", "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-ApiStatus.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\ApiStatus\u003A\u003A__toString\u0028\u0029", + "name": "__toString", + "summary": "Returns\u0020a\u0020string\u0020representation\u0020of\u0020the\u0020API\u0020status.", + "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-ApiStatus.html#method___toString" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\ApiStatus\u003A\u003A\u0024status", "name": "status", @@ -1340,6 +1340,106 @@ Search.appendIndex( "name": "services", "summary": "Array\u0020of\u0020ServiceStatus\u0020objects\u0020representing\u0020the\u0020status\u0020of\u0020each\u0020service.", "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-ApiStatus.html#property_services" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\ApiStatusData", + "name": "ApiStatusData", + "summary": "Manages\u0020API\u0020status\u0020caching\u0020and\u0020provides\u0020service\u0020status\u0020checking.", + "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-ApiStatusData.html" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\ApiStatusData\u003A\u003Aupdate\u0028\u0029", + "name": "update", + "summary": "Update\u0020internal\u0020state\u0020from\u0020API\u0020response.", + "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-ApiStatusData.html#method_update" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\ApiStatusData\u003A\u003AisValid\u0028\u0029", + "name": "isValid", + "summary": "Check\u0020if\u0020cache\u0020is\u0020still\u0020valid\u0020\u0028within\u00205\u0020minutes\u0029.", + "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-ApiStatusData.html#method_isValid" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\ApiStatusData\u003A\u003AinRefreshWindow\u0028\u0029", + "name": "inRefreshWindow", + "summary": "Check\u0020if\u0020cache\u0020is\u0020in\u0020refresh\u0020window\u0020\u00284min30sec\u0020\u002D\u00205min\u0029.", + "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-ApiStatusData.html#method_inRefreshWindow" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\ApiStatusData\u003A\u003Arefresh\u0028\u0029", + "name": "refresh", + "summary": "Fetch\u0020fresh\u0020status\u0020from\u0020API.", + "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-ApiStatusData.html#method_refresh" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\ApiStatusData\u003A\u003ArefreshBlocking\u0028\u0029", + "name": "refreshBlocking", + "summary": "Blocking\u0020refresh\u0020\u002D\u0020wait\u0020for\u0020response.", + "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-ApiStatusData.html#method_refreshBlocking" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\ApiStatusData\u003A\u003ArefreshAsync\u0028\u0029", + "name": "refreshAsync", + "summary": "Trigger\u0020non\u002Dblocking\u0020async\u0020refresh.", + "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-ApiStatusData.html#method_refreshAsync" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\ApiStatusData\u003A\u003AgetApiStatus\u0028\u0029", + "name": "getApiStatus", + "summary": "Get\u0020status\u0020for\u0020specific\u0020service.", + "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-ApiStatusData.html#method_getApiStatus" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\ApiStatusData\u003A\u003AgetServiceStatus\u0028\u0029", + "name": "getServiceStatus", + "summary": "Get\u0020status\u0020for\u0020a\u0020specific\u0020service\u0020from\u0020cached\u0020data.", + "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-ApiStatusData.html#method_getServiceStatus" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\ApiStatusData\u003A\u003AgetLastRefreshed\u0028\u0029", + "name": "getLastRefreshed", + "summary": "Get\u0020last\u0020refresh\u0020timestamp.", + "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-ApiStatusData.html#method_getLastRefreshed" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\ApiStatusData\u003A\u003AhasData\u0028\u0029", + "name": "hasData", + "summary": "Check\u0020if\u0020cache\u0020has\u0020data.", + "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-ApiStatusData.html#method_hasData" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\ApiStatusData\u003A\u003AgetCachedApiStatus\u0028\u0029", + "name": "getCachedApiStatus", + "summary": "Get\u0020cached\u0020ApiStatus\u0020object.", + "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-ApiStatusData.html#method_getCachedApiStatus" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\ApiStatusData\u003A\u003A\u0024service", + "name": "service", + "summary": "", + "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-ApiStatusData.html#property_service" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\ApiStatusData\u003A\u003A\u0024status", + "name": "status", + "summary": "", + "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-ApiStatusData.html#property_status" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\ApiStatusData\u003A\u003A\u0024online", + "name": "online", + "summary": "", + "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-ApiStatusData.html#property_online" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\ApiStatusData\u003A\u003A\u0024uptimePct30d", + "name": "uptimePct30d", + "summary": "", + "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-ApiStatusData.html#property_uptimePct30d" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\ApiStatusData\u003A\u003A\u0024uptimePct90d", + "name": "uptimePct90d", + "summary": "", + "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-ApiStatusData.html#property_uptimePct90d" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\ApiStatusData\u003A\u003A\u0024updated", + "name": "updated", + "summary": "", + "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-ApiStatusData.html#property_updated" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\ApiStatusData\u003A\u003A\u0024lastRefreshed", + "name": "lastRefreshed", + "summary": "", + "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-ApiStatusData.html#property_lastRefreshed" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\ApiStatusData\u003A\u003A\u0024refreshPromise", + "name": "refreshPromise", + "summary": "", + "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-ApiStatusData.html#property_refreshPromise" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\Headers", "name": "Headers", @@ -1350,6 +1450,11 @@ Search.appendIndex( "name": "__construct", "summary": "Headers\u0020constructor.", "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-Headers.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\Headers\u003A\u003A__toString\u0028\u0029", + "name": "__toString", + "summary": "Returns\u0020a\u0020string\u0020representation\u0020of\u0020the\u0020headers.", + "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-Headers.html#method___toString" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\ServiceStatus", "name": "ServiceStatus", @@ -1360,6 +1465,11 @@ Search.appendIndex( "name": "__construct", "summary": "ServiceStatus\u0020constructor.", "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-ServiceStatus.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\ServiceStatus\u003A\u003A__toString\u0028\u0029", + "name": "__toString", + "summary": "Returns\u0020a\u0020string\u0020representation\u0020of\u0020the\u0020service\u0020status.", + "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-ServiceStatus.html#method___toString" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\ServiceStatus\u003A\u003A\u0024service", "name": "service", @@ -1370,6 +1480,11 @@ Search.appendIndex( "name": "status", "summary": "", "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-ServiceStatus.html#property_status" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\ServiceStatus\u003A\u003A\u0024online", + "name": "online", + "summary": "", + "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-ServiceStatus.html#property_online" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\ServiceStatus\u003A\u003A\u0024uptime_percentage_30d", "name": "uptime_percentage_30d", @@ -1385,6 +1500,26 @@ Search.appendIndex( "name": "updated", "summary": "", "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-ServiceStatus.html#property_updated" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\User", + "name": "User", + "summary": "Represents\u0020user\/rate\u0020limit\u0020information\u0020from\u0020the\u0020API.", + "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-User.html" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\User\u003A\u003A__construct\u0028\u0029", + "name": "__construct", + "summary": "User\u0020constructor.", + "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-User.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\User\u003A\u003A__toString\u0028\u0029", + "name": "__toString", + "summary": "Returns\u0020a\u0020string\u0020representation\u0020of\u0020the\u0020user\u0020info.", + "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-User.html#method___toString" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Utilities\\User\u003A\u003A\u0024rate_limits", + "name": "rate_limits", + "summary": "The\u0020rate\u0020limit\u0020information.", + "url": "classes/MarketDataApp-Endpoints-Responses-Utilities-User.html#property_rate_limits" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Stocks", "name": "Stocks", @@ -1395,6 +1530,36 @@ Search.appendIndex( "name": "__construct", "summary": "Stocks\u0020constructor.", "url": "classes/MarketDataApp-Endpoints-Stocks.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Stocks\u003A\u003AisIntradayResolution\u0028\u0029", + "name": "isIntradayResolution", + "summary": "Check\u0020if\u0020a\u0020resolution\u0020is\u0020intraday\u0020\u0028minutely\u0020or\u0020hourly\u0029.", + "url": "classes/MarketDataApp-Endpoints-Stocks.html#method_isIntradayResolution" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Stocks\u003A\u003AparseUserDate\u0028\u0029", + "name": "parseUserDate", + "summary": "Parse\u0020a\u0020user\u002Dprovided\u0020date\u0020string\u0020into\u0020a\u0020Carbon\u0020instance.", + "url": "classes/MarketDataApp-Endpoints-Stocks.html#method_parseUserDate" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Stocks\u003A\u003AisParseableDate\u0028\u0029", + "name": "isParseableDate", + "summary": "Check\u0020if\u0020a\u0020date\u0020string\u0020can\u0020be\u0020parsed\u0020as\u0020an\u0020absolute\u0020date.", + "url": "classes/MarketDataApp-Endpoints-Stocks.html#method_isParseableDate" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Stocks\u003A\u003AsplitDateRangeIntoYearChunks\u0028\u0029", + "name": "splitDateRangeIntoYearChunks", + "summary": "Split\u0020a\u0020date\u0020range\u0020into\u0020year\u002Dlong\u0020chunks\u0020for\u0020concurrent\u0020fetching.", + "url": "classes/MarketDataApp-Endpoints-Stocks.html#method_splitDateRangeIntoYearChunks" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Stocks\u003A\u003AneedsAutomaticSplitting\u0028\u0029", + "name": "needsAutomaticSplitting", + "summary": "Determine\u0020if\u0020a\u0020candles\u0020request\u0020needs\u0020automatic\u0020date\u0020range\u0020splitting.", + "url": "classes/MarketDataApp-Endpoints-Stocks.html#method_needsAutomaticSplitting" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Stocks\u003A\u003AmergeCandleResponses\u0028\u0029", + "name": "mergeCandleResponses", + "summary": "Merge\u0020multiple\u0020candle\u0020responses\u0020into\u0020a\u0020single\u0020Candles\u0020object.", + "url": "classes/MarketDataApp-Endpoints-Stocks.html#method_mergeCandleResponses" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Stocks\u003A\u003AbulkCandles\u0028\u0029", "name": "bulkCandles", @@ -1403,8 +1568,18 @@ Search.appendIndex( }, { "fqsen": "\\MarketDataApp\\Endpoints\\Stocks\u003A\u003Acandles\u0028\u0029", "name": "candles", - "summary": "Get\u0020historical\u0020price\u0020candles\u0020for\u0020an\u0020index.", + "summary": "Get\u0020historical\u0020price\u0020candles\u0020for\u0020a\u0020stock.", "url": "classes/MarketDataApp-Endpoints-Stocks.html#method_candles" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Stocks\u003A\u003AcandlesConcurrent\u0028\u0029", + "name": "candlesConcurrent", + "summary": "Fetch\u0020candles\u0020concurrently\u0020by\u0020splitting\u0020date\u0020range\u0020into\u0020year\u002Dlong\u0020chunks.", + "url": "classes/MarketDataApp-Endpoints-Stocks.html#method_candlesConcurrent" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Stocks\u003A\u003AcandlesConcurrentCsv\u0028\u0029", + "name": "candlesConcurrentCsv", + "summary": "Handle\u0020CSV\u0020format\u0020for\u0020concurrent\u0020candle\u0020requests.", + "url": "classes/MarketDataApp-Endpoints-Stocks.html#method_candlesConcurrentCsv" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Stocks\u003A\u003Aquote\u0028\u0029", "name": "quote", @@ -1413,13 +1588,13 @@ Search.appendIndex( }, { "fqsen": "\\MarketDataApp\\Endpoints\\Stocks\u003A\u003Aquotes\u0028\u0029", "name": "quotes", - "summary": "Get\u0020real\u002Dtime\u0020price\u0020quotes\u0020for\u0020multiple\u0020stocks\u0020by\u0020doing\u0020parallel\u0020requests.", + "summary": "Get\u0020real\u002Dtime\u0020price\u0020quotes\u0020for\u0020multiple\u0020stocks\u0020in\u0020a\u0020single\u0020API\u0020request.", "url": "classes/MarketDataApp-Endpoints-Stocks.html#method_quotes" }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Stocks\u003A\u003AbulkQuotes\u0028\u0029", - "name": "bulkQuotes", - "summary": "Get\u0020real\u002Dtime\u0020price\u0020quotes\u0020for\u0020multiple\u0020stocks\u0020in\u0020a\u0020single\u0020API\u0020request.", - "url": "classes/MarketDataApp-Endpoints-Stocks.html#method_bulkQuotes" + "fqsen": "\\MarketDataApp\\Endpoints\\Stocks\u003A\u003Aprices\u0028\u0029", + "name": "prices", + "summary": "Get\u0020real\u002Dtime\u0020midpoint\u0020prices\u0020for\u0020one\u0020or\u0020more\u0020stocks.", + "url": "classes/MarketDataApp-Endpoints-Stocks.html#method_prices" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Stocks\u003A\u003Aearnings\u0028\u0029", "name": "earnings", @@ -1428,7 +1603,7 @@ Search.appendIndex( }, { "fqsen": "\\MarketDataApp\\Endpoints\\Stocks\u003A\u003Anews\u0028\u0029", "name": "news", - "summary": "Retrieve\u0020news\u0020articles\u0020for\u0020a\u0020given\u0020stock\u0020symbol\u0020within\u0020a\u0020specified\u0020date\u0020range.", + "summary": "Retrieve\u0020news\u0020articles\u0020for\u0020a\u0020given\u0020stock\u0020symbol.", "url": "classes/MarketDataApp-Endpoints-Stocks.html#method_news" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Stocks\u003A\u003ABASE_URL", @@ -1450,6 +1625,16 @@ Search.appendIndex( "name": "__construct", "summary": "Utilities\u0020constructor.", "url": "classes/MarketDataApp-Endpoints-Utilities.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Utilities\u003A\u003AgetApiStatusData\u0028\u0029", + "name": "getApiStatusData", + "summary": "Get\u0020the\u0020singleton\u0020ApiStatusData\u0020instance.", + "url": "classes/MarketDataApp-Endpoints-Utilities.html#method_getApiStatusData" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Utilities\u003A\u003AclearApiStatusCache\u0028\u0029", + "name": "clearApiStatusCache", + "summary": "Clear\u0020the\u0020API\u0020status\u0020cache\u0020\u0028useful\u0020for\u0020testing\u0029.", + "url": "classes/MarketDataApp-Endpoints-Utilities.html#method_clearApiStatusCache" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Utilities\u003A\u003Aapi_status\u0028\u0029", "name": "api_status", @@ -1460,11 +1645,71 @@ Search.appendIndex( "name": "headers", "summary": "Retrieve\u0020the\u0020headers\u0020sent\u0020by\u0020the\u0020application.", "url": "classes/MarketDataApp-Endpoints-Utilities.html#method_headers" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Utilities\u003A\u003Auser\u0028\u0029", + "name": "user", + "summary": "Retrieve\u0020rate\u0020limit\u0020information\u0020for\u0020the\u0020current\u0020user.", + "url": "classes/MarketDataApp-Endpoints-Utilities.html#method_user" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Utilities\u003A\u003AgetServiceStatus\u0028\u0029", + "name": "getServiceStatus", + "summary": "Get\u0020the\u0020status\u0020of\u0020a\u0020specific\u0020service.", + "url": "classes/MarketDataApp-Endpoints-Utilities.html#method_getServiceStatus" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Utilities\u003A\u003ArefreshApiStatus\u0028\u0029", + "name": "refreshApiStatus", + "summary": "Manually\u0020refresh\u0020the\u0020API\u0020status\u0020cache.", + "url": "classes/MarketDataApp-Endpoints-Utilities.html#method_refreshApiStatus" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Utilities\u003A\u003A\u0024client", "name": "client", "summary": "", "url": "classes/MarketDataApp-Endpoints-Utilities.html#property_client" + }, { + "fqsen": "\\MarketDataApp\\Endpoints\\Utilities\u003A\u003A\u0024apiStatusData", + "name": "apiStatusData", + "summary": "", + "url": "classes/MarketDataApp-Endpoints-Utilities.html#property_apiStatusData" + }, { + "fqsen": "\\MarketDataApp\\Enums\\ApiStatusResult", + "name": "ApiStatusResult", + "summary": "Enum\u0020representing\u0020the\u0020status\u0020result\u0020of\u0020an\u0020API\u0020service.", + "url": "classes/MarketDataApp-Enums-ApiStatusResult.html" + }, { + "fqsen": "\\MarketDataApp\\Enums\\ApiStatusResult\u003A\u003AONLINE", + "name": "ONLINE", + "summary": "", + "url": "classes/MarketDataApp-Enums-ApiStatusResult.html#enumcase_ONLINE" + }, { + "fqsen": "\\MarketDataApp\\Enums\\ApiStatusResult\u003A\u003AOFFLINE", + "name": "OFFLINE", + "summary": "", + "url": "classes/MarketDataApp-Enums-ApiStatusResult.html#enumcase_OFFLINE" + }, { + "fqsen": "\\MarketDataApp\\Enums\\ApiStatusResult\u003A\u003AUNKNOWN", + "name": "UNKNOWN", + "summary": "", + "url": "classes/MarketDataApp-Enums-ApiStatusResult.html#enumcase_UNKNOWN" + }, { + "fqsen": "\\MarketDataApp\\Enums\\DateFormat", + "name": "DateFormat", + "summary": "Enum\u0020DateFormat", + "url": "classes/MarketDataApp-Enums-DateFormat.html" + }, { + "fqsen": "\\MarketDataApp\\Enums\\DateFormat\u003A\u003ATIMESTAMP", + "name": "TIMESTAMP", + "summary": "ISO\u0020timestamp\u0020format\u0020\u0028e.g.,\u0020\u00222023\u002D01\u002D20T10\u003A30\u003A00Z\u0022\u0029.", + "url": "classes/MarketDataApp-Enums-DateFormat.html#enumcase_TIMESTAMP" + }, { + "fqsen": "\\MarketDataApp\\Enums\\DateFormat\u003A\u003AUNIX", + "name": "UNIX", + "summary": "Unix\u0020timestamp\u0020format\u0020\u0028seconds\u0020since\u0020epoch,\u0020e.g.,\u00201674210600\u0029.", + "url": "classes/MarketDataApp-Enums-DateFormat.html#enumcase_UNIX" + }, { + "fqsen": "\\MarketDataApp\\Enums\\DateFormat\u003A\u003ASPREADSHEET", + "name": "SPREADSHEET", + "summary": "Spreadsheet\u002Dcompatible\u0020format\u0020\u0028Excel\u0020serial\u0020date\u0020numbers\u0029.", + "url": "classes/MarketDataApp-Enums-DateFormat.html#enumcase_SPREADSHEET" }, { "fqsen": "\\MarketDataApp\\Enums\\Expiration", "name": "Expiration", @@ -1495,6 +1740,26 @@ Search.appendIndex( "name": "HTML", "summary": "Represents\u0020HTML\u0020format\u0020output.", "url": "classes/MarketDataApp-Enums-Format.html#enumcase_HTML" + }, { + "fqsen": "\\MarketDataApp\\Enums\\Mode", + "name": "Mode", + "summary": "Enum\u0020Mode", + "url": "classes/MarketDataApp-Enums-Mode.html" + }, { + "fqsen": "\\MarketDataApp\\Enums\\Mode\u003A\u003ALIVE", + "name": "LIVE", + "summary": "Represents\u0020live\u0020market\u0020data.", + "url": "classes/MarketDataApp-Enums-Mode.html#enumcase_LIVE" + }, { + "fqsen": "\\MarketDataApp\\Enums\\Mode\u003A\u003ACACHED", + "name": "CACHED", + "summary": "Represents\u0020cached\u0020data.", + "url": "classes/MarketDataApp-Enums-Mode.html#enumcase_CACHED" + }, { + "fqsen": "\\MarketDataApp\\Enums\\Mode\u003A\u003ADELAYED", + "name": "DELAYED", + "summary": "Represents\u0020delayed\u0020data.", + "url": "classes/MarketDataApp-Enums-Mode.html#enumcase_DELAYED" }, { "fqsen": "\\MarketDataApp\\Enums\\Range", "name": "Range", @@ -1541,20 +1806,390 @@ Search.appendIndex( "summary": "ApiException\u0020constructor.", "url": "classes/MarketDataApp-Exceptions-ApiException.html#method___construct" }, { - "fqsen": "\\MarketDataApp\\Exceptions\\ApiException\u003A\u003AgetResponse\u0028\u0029", - "name": "getResponse", - "summary": "Get\u0020the\u0020API\u0020response\u0020associated\u0020with\u0020this\u0020exception.", - "url": "classes/MarketDataApp-Exceptions-ApiException.html#method_getResponse" + "fqsen": "\\MarketDataApp\\Exceptions\\BadStatusCodeError", + "name": "BadStatusCodeError", + "summary": "BadStatusCodeError\u0020class", + "url": "classes/MarketDataApp-Exceptions-BadStatusCodeError.html" + }, { + "fqsen": "\\MarketDataApp\\Exceptions\\BadStatusCodeError\u003A\u003A__construct\u0028\u0029", + "name": "__construct", + "summary": "BadStatusCodeError\u0020constructor.", + "url": "classes/MarketDataApp-Exceptions-BadStatusCodeError.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\Exceptions\\MarketDataException", + "name": "MarketDataException", + "summary": "Base\u0020exception\u0020class\u0020for\u0020all\u0020Market\u0020Data\u0020SDK\u0020exceptions.", + "url": "classes/MarketDataApp-Exceptions-MarketDataException.html" }, { - "fqsen": "\\MarketDataApp\\Exceptions\\ApiException\u003A\u003A\u0024response", + "fqsen": "\\MarketDataApp\\Exceptions\\MarketDataException\u003A\u003A__construct\u0028\u0029", + "name": "__construct", + "summary": "MarketDataException\u0020constructor.", + "url": "classes/MarketDataApp-Exceptions-MarketDataException.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\Exceptions\\MarketDataException\u003A\u003AextractRequestId\u0028\u0029", + "name": "extractRequestId", + "summary": "Extract\u0020the\u0020request\u0020ID\u0020\u0028cf\u002Dray\u0020header\u0029\u0020from\u0020the\u0020response.", + "url": "classes/MarketDataApp-Exceptions-MarketDataException.html#method_extractRequestId" + }, { + "fqsen": "\\MarketDataApp\\Exceptions\\MarketDataException\u003A\u003AgetResponse\u0028\u0029", + "name": "getResponse", + "summary": "Get\u0020the\u0020HTTP\u0020response\u0020associated\u0020with\u0020this\u0020exception.", + "url": "classes/MarketDataApp-Exceptions-MarketDataException.html#method_getResponse" + }, { + "fqsen": "\\MarketDataApp\\Exceptions\\MarketDataException\u003A\u003AgetRequestId\u0028\u0029", + "name": "getRequestId", + "summary": "Get\u0020the\u0020Cloudflare\u0020request\u0020ID\u0020for\u0020support\u0020tickets.", + "url": "classes/MarketDataApp-Exceptions-MarketDataException.html#method_getRequestId" + }, { + "fqsen": "\\MarketDataApp\\Exceptions\\MarketDataException\u003A\u003AgetRequestUrl\u0028\u0029", + "name": "getRequestUrl", + "summary": "Get\u0020the\u0020URL\u0020that\u0020was\u0020requested\u0020when\u0020the\u0020error\u0020occurred.", + "url": "classes/MarketDataApp-Exceptions-MarketDataException.html#method_getRequestUrl" + }, { + "fqsen": "\\MarketDataApp\\Exceptions\\MarketDataException\u003A\u003AgetTimestamp\u0028\u0029", + "name": "getTimestamp", + "summary": "Get\u0020the\u0020timestamp\u0020when\u0020the\u0020exception\u0020occurred.", + "url": "classes/MarketDataApp-Exceptions-MarketDataException.html#method_getTimestamp" + }, { + "fqsen": "\\MarketDataApp\\Exceptions\\MarketDataException\u003A\u003AgetSupportContext\u0028\u0029", + "name": "getSupportContext", + "summary": "Get\u0020all\u0020support\u0020ticket\u0020context\u0020as\u0020an\u0020associative\u0020array.", + "url": "classes/MarketDataApp-Exceptions-MarketDataException.html#method_getSupportContext" + }, { + "fqsen": "\\MarketDataApp\\Exceptions\\MarketDataException\u003A\u003AgetSupportInfo\u0028\u0029", + "name": "getSupportInfo", + "summary": "Get\u0020a\u0020pre\u002Dformatted\u0020string\u0020with\u0020all\u0020information\u0020needed\u0020for\u0020a\u0020support\u0020ticket.", + "url": "classes/MarketDataApp-Exceptions-MarketDataException.html#method_getSupportInfo" + }, { + "fqsen": "\\MarketDataApp\\Exceptions\\MarketDataException\u003A\u003A__toString\u0028\u0029", + "name": "__toString", + "summary": "Get\u0020string\u0020representation\u0020of\u0020the\u0020exception.", + "url": "classes/MarketDataApp-Exceptions-MarketDataException.html#method___toString" + }, { + "fqsen": "\\MarketDataApp\\Exceptions\\MarketDataException\u003A\u003A\u0024response", "name": "response", "summary": "", - "url": "classes/MarketDataApp-Exceptions-ApiException.html#property_response" + "url": "classes/MarketDataApp-Exceptions-MarketDataException.html#property_response" + }, { + "fqsen": "\\MarketDataApp\\Exceptions\\MarketDataException\u003A\u003A\u0024requestId", + "name": "requestId", + "summary": "", + "url": "classes/MarketDataApp-Exceptions-MarketDataException.html#property_requestId" + }, { + "fqsen": "\\MarketDataApp\\Exceptions\\MarketDataException\u003A\u003A\u0024requestUrl", + "name": "requestUrl", + "summary": "", + "url": "classes/MarketDataApp-Exceptions-MarketDataException.html#property_requestUrl" + }, { + "fqsen": "\\MarketDataApp\\Exceptions\\MarketDataException\u003A\u003A\u0024timestamp", + "name": "timestamp", + "summary": "", + "url": "classes/MarketDataApp-Exceptions-MarketDataException.html#property_timestamp" + }, { + "fqsen": "\\MarketDataApp\\Exceptions\\RequestError", + "name": "RequestError", + "summary": "RequestError\u0020class", + "url": "classes/MarketDataApp-Exceptions-RequestError.html" + }, { + "fqsen": "\\MarketDataApp\\Exceptions\\RequestError\u003A\u003A__construct\u0028\u0029", + "name": "__construct", + "summary": "RequestError\u0020constructor.", + "url": "classes/MarketDataApp-Exceptions-RequestError.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\Exceptions\\UnauthorizedException", + "name": "UnauthorizedException", + "summary": "UnauthorizedException\u0020class", + "url": "classes/MarketDataApp-Exceptions-UnauthorizedException.html" + }, { + "fqsen": "\\MarketDataApp\\Exceptions\\UnauthorizedException\u003A\u003A__construct\u0028\u0029", + "name": "__construct", + "summary": "UnauthorizedException\u0020constructor.", + "url": "classes/MarketDataApp-Exceptions-UnauthorizedException.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\Logging\\DefaultLogger", + "name": "DefaultLogger", + "summary": "Default\u0020PSR\u002D3\u0020compliant\u0020logger\u0020for\u0020MarketDataApp\u0020SDK.", + "url": "classes/MarketDataApp-Logging-DefaultLogger.html" + }, { + "fqsen": "\\MarketDataApp\\Logging\\DefaultLogger\u003A\u003A__construct\u0028\u0029", + "name": "__construct", + "summary": "Create\u0020a\u0020new\u0020DefaultLogger\u0020instance.", + "url": "classes/MarketDataApp-Logging-DefaultLogger.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\Logging\\DefaultLogger\u003A\u003Alog\u0028\u0029", + "name": "log", + "summary": "Log\u0020a\u0020message\u0020at\u0020the\u0020specified\u0020level.", + "url": "classes/MarketDataApp-Logging-DefaultLogger.html#method_log" + }, { + "fqsen": "\\MarketDataApp\\Logging\\DefaultLogger\u003A\u003Ainterpolate\u0028\u0029", + "name": "interpolate", + "summary": "Interpolate\u0020context\u0020values\u0020into\u0020message\u0020placeholders.", + "url": "classes/MarketDataApp-Logging-DefaultLogger.html#method_interpolate" + }, { + "fqsen": "\\MarketDataApp\\Logging\\DefaultLogger\u003A\u003ALOGGER_NAME", + "name": "LOGGER_NAME", + "summary": "Logger\u0020name\u0020used\u0020in\u0020output\u0020format.", + "url": "classes/MarketDataApp-Logging-DefaultLogger.html#constant_LOGGER_NAME" + }, { + "fqsen": "\\MarketDataApp\\Logging\\DefaultLogger\u003A\u003A\u0024minLevel", + "name": "minLevel", + "summary": "", + "url": "classes/MarketDataApp-Logging-DefaultLogger.html#property_minLevel" + }, { + "fqsen": "\\MarketDataApp\\Logging\\DefaultLogger\u003A\u003A\u0024output", + "name": "output", + "summary": "", + "url": "classes/MarketDataApp-Logging-DefaultLogger.html#property_output" + }, { + "fqsen": "\\MarketDataApp\\Logging\\DefaultLogger\u003A\u003A\u0024levels", + "name": "levels", + "summary": "", + "url": "classes/MarketDataApp-Logging-DefaultLogger.html#property_levels" + }, { + "fqsen": "\\MarketDataApp\\Logging\\LoggerFactory", + "name": "LoggerFactory", + "summary": "Factory\u0020for\u0020creating\u0020and\u0020managing\u0020logger\u0020instances.", + "url": "classes/MarketDataApp-Logging-LoggerFactory.html" + }, { + "fqsen": "\\MarketDataApp\\Logging\\LoggerFactory\u003A\u003AgetLogger\u0028\u0029", + "name": "getLogger", + "summary": "Get\u0020the\u0020configured\u0020logger\u0020instance.", + "url": "classes/MarketDataApp-Logging-LoggerFactory.html#method_getLogger" + }, { + "fqsen": "\\MarketDataApp\\Logging\\LoggerFactory\u003A\u003AsetLogger\u0028\u0029", + "name": "setLogger", + "summary": "Set\u0020a\u0020custom\u0020logger\u0020instance.", + "url": "classes/MarketDataApp-Logging-LoggerFactory.html#method_setLogger" + }, { + "fqsen": "\\MarketDataApp\\Logging\\LoggerFactory\u003A\u003AresetLogger\u0028\u0029", + "name": "resetLogger", + "summary": "Reset\u0020the\u0020logger\u0020singleton.", + "url": "classes/MarketDataApp-Logging-LoggerFactory.html#method_resetLogger" + }, { + "fqsen": "\\MarketDataApp\\Logging\\LoggerFactory\u003A\u003A\u0024instance", + "name": "instance", + "summary": "", + "url": "classes/MarketDataApp-Logging-LoggerFactory.html#property_instance" + }, { + "fqsen": "\\MarketDataApp\\Logging\\LoggingUtilities", + "name": "LoggingUtilities", + "summary": "Utility\u0020functions\u0020for\u0020logging.", + "url": "classes/MarketDataApp-Logging-LoggingUtilities.html" + }, { + "fqsen": "\\MarketDataApp\\Logging\\LoggingUtilities\u003A\u003AformatDuration\u0028\u0029", + "name": "formatDuration", + "summary": "Format\u0020duration\u0020in\u0020milliseconds\u0020to\u0020human\u002Dreadable\u0020string.", + "url": "classes/MarketDataApp-Logging-LoggingUtilities.html#method_formatDuration" + }, { + "fqsen": "\\MarketDataApp\\RateLimits", + "name": "RateLimits", + "summary": "Represents\u0020rate\u0020limit\u0020information\u0020from\u0020API\u0020responses.", + "url": "classes/MarketDataApp-RateLimits.html" + }, { + "fqsen": "\\MarketDataApp\\RateLimits\u003A\u003A__construct\u0028\u0029", + "name": "__construct", + "summary": "RateLimits\u0020constructor.", + "url": "classes/MarketDataApp-RateLimits.html#method___construct" + }, { + "fqsen": "\\MarketDataApp\\RateLimits\u003A\u003A__toString\u0028\u0029", + "name": "__toString", + "summary": "Returns\u0020a\u0020string\u0020representation\u0020of\u0020the\u0020rate\u0020limits.", + "url": "classes/MarketDataApp-RateLimits.html#method___toString" + }, { + "fqsen": "\\MarketDataApp\\RateLimits\u003A\u003A\u0024limit", + "name": "limit", + "summary": "Total\u0020number\u0020of\u0020credits\u0020allowed\u0020in\u0020the\u0020current\u0020rate\u0020limit\u0020window.", + "url": "classes/MarketDataApp-RateLimits.html#property_limit" + }, { + "fqsen": "\\MarketDataApp\\RateLimits\u003A\u003A\u0024remaining", + "name": "remaining", + "summary": "Number\u0020of\u0020credits\u0020remaining\u0020in\u0020the\u0020current\u0020rate\u0020limit\u0020window.", + "url": "classes/MarketDataApp-RateLimits.html#property_remaining" + }, { + "fqsen": "\\MarketDataApp\\RateLimits\u003A\u003A\u0024reset", + "name": "reset", + "summary": "Unix\u0020timestamp\u0020when\u0020the\u0020rate\u0020limit\u0020resets.", + "url": "classes/MarketDataApp-RateLimits.html#property_reset" + }, { + "fqsen": "\\MarketDataApp\\RateLimits\u003A\u003A\u0024consumed", + "name": "consumed", + "summary": "Number\u0020of\u0020credits\u0020consumed\u0020in\u0020the\u0020current\u0020request.", + "url": "classes/MarketDataApp-RateLimits.html#property_consumed" + }, { + "fqsen": "\\MarketDataApp\\Retry\\RetryConfig", + "name": "RetryConfig", + "summary": "Retry\u0020configuration\u0020constants\u0020matching\u0020the\u0020Python\u0020SDK.", + "url": "classes/MarketDataApp-Retry-RetryConfig.html" + }, { + "fqsen": "\\MarketDataApp\\Retry\\RetryConfig\u003A\u003AisRetryableStatusCode\u0028\u0029", + "name": "isRetryableStatusCode", + "summary": "Check\u0020if\u0020a\u0020status\u0020code\u0020is\u0020retryable\u0020\u0028status\u0020code\u0020\u003E\u0020500\u0029.", + "url": "classes/MarketDataApp-Retry-RetryConfig.html#method_isRetryableStatusCode" + }, { + "fqsen": "\\MarketDataApp\\Retry\\RetryConfig\u003A\u003AMAX_RETRY_ATTEMPTS", + "name": "MAX_RETRY_ATTEMPTS", + "summary": "Maximum\u0020number\u0020of\u0020retry\u0020attempts.", + "url": "classes/MarketDataApp-Retry-RetryConfig.html#constant_MAX_RETRY_ATTEMPTS" + }, { + "fqsen": "\\MarketDataApp\\Retry\\RetryConfig\u003A\u003ARETRY_BACKOFF", + "name": "RETRY_BACKOFF", + "summary": "Exponential\u0020backoff\u0020multiplier.", + "url": "classes/MarketDataApp-Retry-RetryConfig.html#constant_RETRY_BACKOFF" + }, { + "fqsen": "\\MarketDataApp\\Retry\\RetryConfig\u003A\u003AMIN_RETRY_BACKOFF", + "name": "MIN_RETRY_BACKOFF", + "summary": "Minimum\u0020backoff\u0020time\u0020in\u0020seconds.", + "url": "classes/MarketDataApp-Retry-RetryConfig.html#constant_MIN_RETRY_BACKOFF" + }, { + "fqsen": "\\MarketDataApp\\Retry\\RetryConfig\u003A\u003AMAX_RETRY_BACKOFF", + "name": "MAX_RETRY_BACKOFF", + "summary": "Maximum\u0020backoff\u0020time\u0020in\u0020seconds.", + "url": "classes/MarketDataApp-Retry-RetryConfig.html#constant_MAX_RETRY_BACKOFF" + }, { + "fqsen": "\\MarketDataApp\\Settings", + "name": "Settings", + "summary": "Settings\u0020class\u0020for\u0020MarketDataApp\u0020SDK.", + "url": "classes/MarketDataApp-Settings.html" + }, { + "fqsen": "\\MarketDataApp\\Settings\u003A\u003AgetToken\u0028\u0029", + "name": "getToken", + "summary": "Get\u0020the\u0020API\u0020token\u0020with\u0020automatic\u0020resolution\u0020from\u0020multiple\u0020sources.", + "url": "classes/MarketDataApp-Settings.html#method_getToken" + }, { + "fqsen": "\\MarketDataApp\\Settings\u003A\u003AgetEnvToken\u0028\u0029", + "name": "getEnvToken", + "summary": "Get\u0020token\u0020from\u0020environment\u0020variables.", + "url": "classes/MarketDataApp-Settings.html#method_getEnvToken" + }, { + "fqsen": "\\MarketDataApp\\Settings\u003A\u003AgetDotenvToken\u0028\u0029", + "name": "getDotenvToken", + "summary": "Get\u0020token\u0020from\u0020.env\u0020file.", + "url": "classes/MarketDataApp-Settings.html#method_getDotenvToken" + }, { + "fqsen": "\\MarketDataApp\\Settings\u003A\u003AloadDotenv\u0028\u0029", + "name": "loadDotenv", + "summary": "Load\u0020.env\u0020file\u0020if\u0020it\u0020exists.", + "url": "classes/MarketDataApp-Settings.html#method_loadDotenv" + }, { + "fqsen": "\\MarketDataApp\\Settings\u003A\u003AgetDefaultParameters\u0028\u0029", + "name": "getDefaultParameters", + "summary": "Get\u0020default\u0020universal\u0020parameters\u0020from\u0020environment\u0020variables\u0020and\u0020.env\u0020file.", + "url": "classes/MarketDataApp-Settings.html#method_getDefaultParameters" + }, { + "fqsen": "\\MarketDataApp\\Settings\u003A\u003AgetEnvFormat\u0028\u0029", + "name": "getEnvFormat", + "summary": "Get\u0020format\u0020from\u0020environment\u0020variable\u0020MARKETDATA_OUTPUT_FORMAT.", + "url": "classes/MarketDataApp-Settings.html#method_getEnvFormat" + }, { + "fqsen": "\\MarketDataApp\\Settings\u003A\u003AgetEnvDateFormat\u0028\u0029", + "name": "getEnvDateFormat", + "summary": "Get\u0020date\u0020format\u0020from\u0020environment\u0020variable\u0020MARKETDATA_DATE_FORMAT.", + "url": "classes/MarketDataApp-Settings.html#method_getEnvDateFormat" + }, { + "fqsen": "\\MarketDataApp\\Settings\u003A\u003AgetEnvMode\u0028\u0029", + "name": "getEnvMode", + "summary": "Get\u0020mode\u0020from\u0020environment\u0020variable\u0020MARKETDATA_MODE.", + "url": "classes/MarketDataApp-Settings.html#method_getEnvMode" + }, { + "fqsen": "\\MarketDataApp\\Settings\u003A\u003AgetEnvColumns\u0028\u0029", + "name": "getEnvColumns", + "summary": "Get\u0020columns\u0020array\u0020from\u0020environment\u0020variable\u0020MARKETDATA_COLUMNS.", + "url": "classes/MarketDataApp-Settings.html#method_getEnvColumns" + }, { + "fqsen": "\\MarketDataApp\\Settings\u003A\u003AgetEnvBool\u0028\u0029", + "name": "getEnvBool", + "summary": "Get\u0020boolean\u0020value\u0020from\u0020environment\u0020variable.", + "url": "classes/MarketDataApp-Settings.html#method_getEnvBool" + }, { + "fqsen": "\\MarketDataApp\\Settings\u003A\u003AgetLogLevel\u0028\u0029", + "name": "getLogLevel", + "summary": "Get\u0020the\u0020logging\u0020level\u0020from\u0020environment\u0020variable\u0020MARKETDATA_LOGGING_LEVEL.", + "url": "classes/MarketDataApp-Settings.html#method_getLogLevel" + }, { + "fqsen": "\\MarketDataApp\\Settings\u003A\u003AgetEnvValue\u0028\u0029", + "name": "getEnvValue", + "summary": "Get\u0020environment\u0020variable\u0020value\u0020from\u0020multiple\u0020sources.", + "url": "classes/MarketDataApp-Settings.html#method_getEnvValue" + }, { + "fqsen": "\\MarketDataApp\\Settings\u003A\u003AMAX_CONCURRENT_REQUESTS", + "name": "MAX_CONCURRENT_REQUESTS", + "summary": "Maximum\u0020number\u0020of\u0020concurrent\u0020requests\u0020allowed\u0020for\u0020the\u0020entire\u0020API.", + "url": "classes/MarketDataApp-Settings.html#constant_MAX_CONCURRENT_REQUESTS" + }, { + "fqsen": "\\MarketDataApp\\Settings\u003A\u003AREFRESH_API_STATUS_INTERVAL", + "name": "REFRESH_API_STATUS_INTERVAL", + "summary": "Refresh\u0020interval\u0020for\u0020API\u0020status\u0020cache.", + "url": "classes/MarketDataApp-Settings.html#constant_REFRESH_API_STATUS_INTERVAL" + }, { + "fqsen": "\\MarketDataApp\\Settings\u003A\u003AAPI_STATUS_CACHE_VALIDITY", + "name": "API_STATUS_CACHE_VALIDITY", + "summary": "Cache\u0020validity\u0020period\u0020for\u0020API\u0020status.", + "url": "classes/MarketDataApp-Settings.html#constant_API_STATUS_CACHE_VALIDITY" + }, { + "fqsen": "\\MarketDataApp\\Settings\u003A\u003A\u0024dotenvLoaded", + "name": "dotenvLoaded", + "summary": "", + "url": "classes/MarketDataApp-Settings.html#property_dotenvLoaded" + }, { + "fqsen": "\\MarketDataApp\\Traits\\FormatsForDisplay", + "name": "FormatsForDisplay", + "summary": "Trait\u0020for\u0020formatting\u0020values\u0020in\u0020__toString\u0028\u0029\u0020methods.", + "url": "classes/MarketDataApp-Traits-FormatsForDisplay.html" + }, { + "fqsen": "\\MarketDataApp\\Traits\\FormatsForDisplay\u003A\u003AformatCurrency\u0028\u0029", + "name": "formatCurrency", + "summary": "Format\u0020a\u0020float\u0020as\u0020currency\u0020\u0028e.g.,\u0020\u0022\u0024150.25\u0022\u0029.", + "url": "classes/MarketDataApp-Traits-FormatsForDisplay.html#method_formatCurrency" + }, { + "fqsen": "\\MarketDataApp\\Traits\\FormatsForDisplay\u003A\u003AformatPercent\u0028\u0029", + "name": "formatPercent", + "summary": "Format\u0020a\u0020percentage\u0020with\u0020sign\u0020\u0028e.g.,\u0020\u0022\u002B3.25\u0025\u0022\u0020or\u0020\u0022\u002D1.50\u0025\u0022\u0029.", + "url": "classes/MarketDataApp-Traits-FormatsForDisplay.html#method_formatPercent" + }, { + "fqsen": "\\MarketDataApp\\Traits\\FormatsForDisplay\u003A\u003AformatPercentRaw\u0028\u0029", + "name": "formatPercentRaw", + "summary": "Format\u0020a\u0020percentage\u0020that\u0020is\u0020already\u0020in\u0020percent\u0020form\u0020\u0028e.g.,\u0020\u002232.50\u0025\u0022\u0029.", + "url": "classes/MarketDataApp-Traits-FormatsForDisplay.html#method_formatPercentRaw" + }, { + "fqsen": "\\MarketDataApp\\Traits\\FormatsForDisplay\u003A\u003AformatVolume\u0028\u0029", + "name": "formatVolume", + "summary": "Format\u0020volume\u0020with\u0020K\/M\/B\u0020suffixes\u0020\u0028e.g.,\u0020\u002254.9M\u0022,\u0020\u002212.3K\u0022\u0029.", + "url": "classes/MarketDataApp-Traits-FormatsForDisplay.html#method_formatVolume" + }, { + "fqsen": "\\MarketDataApp\\Traits\\FormatsForDisplay\u003A\u003AformatDateTime\u0028\u0029", + "name": "formatDateTime", + "summary": "Format\u0020a\u0020Carbon\u0020date\u0020with\u0020time\u0020\u0028e.g.,\u0020\u0022Jan\u002024,\u00202026\u00203\u003A45\u0020PM\u0022\u0029.", + "url": "classes/MarketDataApp-Traits-FormatsForDisplay.html#method_formatDateTime" + }, { + "fqsen": "\\MarketDataApp\\Traits\\FormatsForDisplay\u003A\u003AformatDate\u0028\u0029", + "name": "formatDate", + "summary": "Format\u0020a\u0020Carbon\u0020date\u0020without\u0020time\u0020\u0028e.g.,\u0020\u0022Jan\u002024,\u00202026\u0022\u0029.", + "url": "classes/MarketDataApp-Traits-FormatsForDisplay.html#method_formatDate" + }, { + "fqsen": "\\MarketDataApp\\Traits\\FormatsForDisplay\u003A\u003AformatGreek\u0028\u0029", + "name": "formatGreek", + "summary": "Format\u0020a\u0020Greek\u0020value\u0020\u00284\u0020decimal\u0020places,\u0020e.g.,\u0020\u00220.4520\u0022\u0029.", + "url": "classes/MarketDataApp-Traits-FormatsForDisplay.html#method_formatGreek" + }, { + "fqsen": "\\MarketDataApp\\Traits\\FormatsForDisplay\u003A\u003AformatNumber\u0028\u0029", + "name": "formatNumber", + "summary": "Format\u0020a\u0020number\u0020with\u0020commas\u0020\u0028e.g.,\u0020\u002215,234\u0022\u0029.", + "url": "classes/MarketDataApp-Traits-FormatsForDisplay.html#method_formatNumber" + }, { + "fqsen": "\\MarketDataApp\\Traits\\FormatsForDisplay\u003A\u003AformatChange\u0028\u0029", + "name": "formatChange", + "summary": "Format\u0020a\u0020change\u0020value\u0020with\u0020sign\u0020and\u0020currency\u0020\u0028e.g.,\u0020\u0022\u002B\u00241.25\u0022\u0020or\u0020\u0022\u002D\u00240.50\u0022\u0029.", + "url": "classes/MarketDataApp-Traits-FormatsForDisplay.html#method_formatChange" }, { "fqsen": "\\MarketDataApp\\Traits\\UniversalParameters", "name": "UniversalParameters", "summary": "Trait\u0020UniversalParameters", "url": "classes/MarketDataApp-Traits-UniversalParameters.html" + }, { + "fqsen": "\\MarketDataApp\\Traits\\UniversalParameters\u003A\u003AmergeParameters\u0028\u0029", + "name": "mergeParameters", + "summary": "Merge\u0020method\u002Dlevel\u0020parameters\u0020with\u0020client\u0020default\u0020parameters.", + "url": "classes/MarketDataApp-Traits-UniversalParameters.html#method_mergeParameters" }, { "fqsen": "\\MarketDataApp\\Traits\\UniversalParameters\u003A\u003Aexecute\u0028\u0029", "name": "execute", @@ -1565,6 +2200,66 @@ Search.appendIndex( "name": "execute_in_parallel", "summary": "Execute\u0020multiple\u0020API\u0020requests\u0020in\u0020parallel\u0020with\u0020universal\u0020parameters.", "url": "classes/MarketDataApp-Traits-UniversalParameters.html#method_execute_in_parallel" + }, { + "fqsen": "\\MarketDataApp\\Traits\\ValidatesInputs", + "name": "ValidatesInputs", + "summary": "Trait\u0020for\u0020input\u0020validation\u0020methods.", + "url": "classes/MarketDataApp-Traits-ValidatesInputs.html" + }, { + "fqsen": "\\MarketDataApp\\Traits\\ValidatesInputs\u003A\u003AcanParseAsDate\u0028\u0029", + "name": "canParseAsDate", + "summary": "Check\u0020if\u0020a\u0020string\u0020can\u0020be\u0020parsed\u0020as\u0020a\u0020date.", + "url": "classes/MarketDataApp-Traits-ValidatesInputs.html#method_canParseAsDate" + }, { + "fqsen": "\\MarketDataApp\\Traits\\ValidatesInputs\u003A\u003AparseDateToTimestamp\u0028\u0029", + "name": "parseDateToTimestamp", + "summary": "Parse\u0020a\u0020date\u0020string\u0020to\u0020unix\u0020timestamp.", + "url": "classes/MarketDataApp-Traits-ValidatesInputs.html#method_parseDateToTimestamp" + }, { + "fqsen": "\\MarketDataApp\\Traits\\ValidatesInputs\u003A\u003AvalidateDateRange\u0028\u0029", + "name": "validateDateRange", + "summary": "Validate\u0020date\u0020range\u0020logic.", + "url": "classes/MarketDataApp-Traits-ValidatesInputs.html#method_validateDateRange" + }, { + "fqsen": "\\MarketDataApp\\Traits\\ValidatesInputs\u003A\u003AvalidatePositiveInteger\u0028\u0029", + "name": "validatePositiveInteger", + "summary": "Validate\u0020that\u0020an\u0020integer\u0020is\u0020positive\u0020if\u0020provided.", + "url": "classes/MarketDataApp-Traits-ValidatesInputs.html#method_validatePositiveInteger" + }, { + "fqsen": "\\MarketDataApp\\Traits\\ValidatesInputs\u003A\u003AvalidatePositiveNumber\u0028\u0029", + "name": "validatePositiveNumber", + "summary": "Validate\u0020that\u0020a\u0020number\u0020\u0028int\u0020or\u0020float\u0029\u0020is\u0020positive\u0020if\u0020provided.", + "url": "classes/MarketDataApp-Traits-ValidatesInputs.html#method_validatePositiveNumber" + }, { + "fqsen": "\\MarketDataApp\\Traits\\ValidatesInputs\u003A\u003AvalidateNumericRange\u0028\u0029", + "name": "validateNumericRange", + "summary": "Validate\u0020that\u0020min\u0020\u003C\u0020max\u0020when\u0020both\u0020are\u0020provided.", + "url": "classes/MarketDataApp-Traits-ValidatesInputs.html#method_validateNumericRange" + }, { + "fqsen": "\\MarketDataApp\\Traits\\ValidatesInputs\u003A\u003AvalidateNonEmptyString\u0028\u0029", + "name": "validateNonEmptyString", + "summary": "Validate\u0020that\u0020a\u0020string\u0020is\u0020non\u002Dempty.", + "url": "classes/MarketDataApp-Traits-ValidatesInputs.html#method_validateNonEmptyString" + }, { + "fqsen": "\\MarketDataApp\\Traits\\ValidatesInputs\u003A\u003AvalidateNonEmptyArray\u0028\u0029", + "name": "validateNonEmptyArray", + "summary": "Validate\u0020that\u0020an\u0020array\u0020is\u0020non\u002Dempty.", + "url": "classes/MarketDataApp-Traits-ValidatesInputs.html#method_validateNonEmptyArray" + }, { + "fqsen": "\\MarketDataApp\\Traits\\ValidatesInputs\u003A\u003AvalidateSymbols\u0028\u0029", + "name": "validateSymbols", + "summary": "Validate\u0020symbols\u0020array\u0020\u0028trim\u0020and\u0020ensure\u0020non\u002Dempty\u0029.", + "url": "classes/MarketDataApp-Traits-ValidatesInputs.html#method_validateSymbols" + }, { + "fqsen": "\\MarketDataApp\\Traits\\ValidatesInputs\u003A\u003AvalidateResolution\u0028\u0029", + "name": "validateResolution", + "summary": "Validate\u0020resolution\u0020format.", + "url": "classes/MarketDataApp-Traits-ValidatesInputs.html#method_validateResolution" + }, { + "fqsen": "\\MarketDataApp\\Traits\\ValidatesInputs\u003A\u003AvalidateCountryCode\u0028\u0029", + "name": "validateCountryCode", + "summary": "Validate\u0020ISO\u00203166\u0020two\u002Dletter\u0020country\u0020code.", + "url": "classes/MarketDataApp-Traits-ValidatesInputs.html#method_validateCountryCode" }, { "fqsen": "\\", "name": "\\", @@ -1585,11 +2280,6 @@ Search.appendIndex( "name": "Requests", "summary": "", "url": "namespaces/marketdataapp-endpoints-requests.html" - }, { - "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Indices", - "name": "Indices", - "summary": "", - "url": "namespaces/marketdataapp-endpoints-responses-indices.html" }, { "fqsen": "\\MarketDataApp\\Endpoints\\Responses\\Markets", "name": "Markets", @@ -1630,6 +2320,16 @@ Search.appendIndex( "name": "Exceptions", "summary": "", "url": "namespaces/marketdataapp-exceptions.html" + }, { + "fqsen": "\\MarketDataApp\\Logging", + "name": "Logging", + "summary": "", + "url": "namespaces/marketdataapp-logging.html" + }, { + "fqsen": "\\MarketDataApp\\Retry", + "name": "Retry", + "summary": "", + "url": "namespaces/marketdataapp-retry.html" }, { "fqsen": "\\MarketDataApp\\Traits", "name": "Traits", diff --git a/docs/js/template.js b/docs/js/template.js index 49383291..83931d2e 100644 --- a/docs/js/template.js +++ b/docs/js/template.js @@ -15,3 +15,20 @@ observer.observe(el); }) })(); +function openSvg(svg) { + // convert to a valid XML source + const as_text = new XMLSerializer().serializeToString(svg); + // store in a Blob + const blob = new Blob([as_text], { type: "image/svg+xml" }); + // create an URI pointing to that blob + const url = URL.createObjectURL(blob); + const win = open(url); + // so the Garbage Collector can collect the blob + win.onload = (evt) => URL.revokeObjectURL(url); +}; + + +var svgs = document.querySelectorAll(".phpdocumentor-uml-diagram svg"); +for( var i=0,il = svgs.length; i< il; i ++ ) { + svgs[i].onclick = (evt) => openSvg(evt.target); +} \ No newline at end of file diff --git a/docs/namespaces/default.html b/docs/namespaces/default.html index 344a2892..9e8961c3 100644 --- a/docs/namespaces/default.html +++ b/docs/namespaces/default.html @@ -80,6 +80,14 @@

                                                                            • Exceptions +
                                                                            • +
                                                                            • + Logging + +
                                                                            • +
                                                                            • + Retry +
                                                                            • Traits @@ -182,6 +190,8 @@

                                                                              if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/namespaces/marketdataapp-endpoints-requests.html b/docs/namespaces/marketdataapp-endpoints-requests.html index 7d7a0667..2844bfbd 100644 --- a/docs/namespaces/marketdataapp-endpoints-requests.html +++ b/docs/namespaces/marketdataapp-endpoints-requests.html @@ -80,6 +80,14 @@

                                                                            • Exceptions +
                                                                            • +
                                                                            • + Logging + +
                                                                            • +
                                                                            • + Retry +
                                                                            • Traits @@ -135,7 +143,7 @@

                                                                              -
                                                                              Parameters
                                                                              Represents parameters for API requests.
                                                                              +
                                                                              Parameters
                                                                              Represents universal parameters for API requests.
                                                                              @@ -183,6 +191,8 @@

                                                                              if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/namespaces/marketdataapp-endpoints-responses-markets.html b/docs/namespaces/marketdataapp-endpoints-responses-markets.html index 7c57a7a8..c57194d0 100644 --- a/docs/namespaces/marketdataapp-endpoints-responses-markets.html +++ b/docs/namespaces/marketdataapp-endpoints-responses-markets.html @@ -80,6 +80,14 @@

                                                                            • Exceptions +
                                                                            • +
                                                                            • + Logging + +
                                                                            • +
                                                                            • + Retry +
                                                                            • Traits @@ -184,6 +192,8 @@

                                                                              if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/namespaces/marketdataapp-endpoints-responses-mutualfunds.html b/docs/namespaces/marketdataapp-endpoints-responses-mutualfunds.html index f1c39cbe..68968e59 100644 --- a/docs/namespaces/marketdataapp-endpoints-responses-mutualfunds.html +++ b/docs/namespaces/marketdataapp-endpoints-responses-mutualfunds.html @@ -80,6 +80,14 @@

                                                                            • Exceptions +
                                                                            • +
                                                                            • + Logging + +
                                                                            • +
                                                                            • + Retry +
                                                                            • Traits @@ -184,6 +192,8 @@

                                                                              if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/namespaces/marketdataapp-endpoints-responses-options.html b/docs/namespaces/marketdataapp-endpoints-responses-options.html index d72d5f33..76f7962a 100644 --- a/docs/namespaces/marketdataapp-endpoints-responses-options.html +++ b/docs/namespaces/marketdataapp-endpoints-responses-options.html @@ -80,6 +80,14 @@

                                                                            • Exceptions +
                                                                            • +
                                                                            • + Logging + +
                                                                            • +
                                                                            • + Retry +
                                                                            • Traits @@ -136,7 +144,7 @@

                                                                              -
                                                                              Expirations
                                                                              Represents a collection of option expirations dates and related data.
                                                                              Lookup
                                                                              Represents a lookup response for generating OCC option symbols.
                                                                              OptionChains
                                                                              Represents a collection of option chains with associated data.
                                                                              OptionChainStrike
                                                                              Represents a single option chain strike with associated data.
                                                                              Quote
                                                                              Represents a single option quote with associated data.
                                                                              Quotes
                                                                              Represents a collection of option quotes with associated data.
                                                                              Strikes
                                                                              Represents a collection of option strikes with associated data.
                                                                              +
                                                                              Expirations
                                                                              Represents a collection of option expirations dates and related data.
                                                                              Lookup
                                                                              Represents a lookup response for generating OCC option symbols.
                                                                              OptionChains
                                                                              Represents a collection of option chains with associated data.
                                                                              OptionQuote
                                                                              Represents a single option quote with associated data.
                                                                              Quotes
                                                                              Represents a collection of option quotes with associated data.
                                                                              Strikes
                                                                              Represents a collection of option strikes with associated data.
                                                                              @@ -184,6 +192,8 @@

                                                                              if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/namespaces/marketdataapp-endpoints-responses-stocks.html b/docs/namespaces/marketdataapp-endpoints-responses-stocks.html index 84b139d7..574f4341 100644 --- a/docs/namespaces/marketdataapp-endpoints-responses-stocks.html +++ b/docs/namespaces/marketdataapp-endpoints-responses-stocks.html @@ -80,6 +80,14 @@

                                                                            • Exceptions +
                                                                            • +
                                                                            • + Logging + +
                                                                            • +
                                                                            • + Retry +
                                                                            • Traits @@ -136,7 +144,7 @@

                                                                              -
                                                                              BulkCandles
                                                                              Represents a collection of stock candles data in bulk format.
                                                                              BulkQuote
                                                                              Represents a bulk quote for a stock with various price and volume information.
                                                                              BulkQuotes
                                                                              Represents a collection of bulk stock quotes.
                                                                              Candle
                                                                              Represents a single stock candle with open, high, low, close prices, volume, and timestamp.
                                                                              Candles
                                                                              Class Candles
                                                                              Earning
                                                                              Class Earning
                                                                              Earnings
                                                                              Class Earnings
                                                                              News
                                                                              Class News
                                                                              Quote
                                                                              Class Quote
                                                                              Quotes
                                                                              Represents a collection of stock quotes.
                                                                              +
                                                                              BulkCandles
                                                                              Represents a collection of stock candles data in bulk format.
                                                                              Candle
                                                                              Represents a single stock candle with open, high, low, close prices, volume, and timestamp.
                                                                              Candles
                                                                              Class Candles
                                                                              Earning
                                                                              Class Earning
                                                                              Earnings
                                                                              Class Earnings
                                                                              News
                                                                              Class News
                                                                              Prices
                                                                              Class Prices
                                                                              Quote
                                                                              Class Quote
                                                                              Quotes
                                                                              Represents a collection of stock quotes.
                                                                              @@ -184,6 +192,8 @@

                                                                              if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/namespaces/marketdataapp-endpoints-responses-utilities.html b/docs/namespaces/marketdataapp-endpoints-responses-utilities.html index c258c39a..2d61169e 100644 --- a/docs/namespaces/marketdataapp-endpoints-responses-utilities.html +++ b/docs/namespaces/marketdataapp-endpoints-responses-utilities.html @@ -80,6 +80,14 @@

                                                                            • Exceptions +
                                                                            • +
                                                                            • + Logging + +
                                                                            • +
                                                                            • + Retry +
                                                                            • Traits @@ -136,7 +144,7 @@

                                                                              -
                                                                              ApiStatus
                                                                              Represents the status of the API and its services.
                                                                              Headers
                                                                              Represents the headers of an API response.
                                                                              ServiceStatus
                                                                              Represents the status of a service.
                                                                              +
                                                                              ApiStatus
                                                                              Represents the status of the API and its services.
                                                                              ApiStatusData
                                                                              Manages API status caching and provides service status checking.
                                                                              Headers
                                                                              Represents the headers of an API response.
                                                                              ServiceStatus
                                                                              Represents the status of a service.
                                                                              User
                                                                              Represents user/rate limit information from the API.
                                                                              @@ -184,6 +192,8 @@

                                                                              if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/namespaces/marketdataapp-endpoints-responses.html b/docs/namespaces/marketdataapp-endpoints-responses.html index 35a86822..7cb77031 100644 --- a/docs/namespaces/marketdataapp-endpoints-responses.html +++ b/docs/namespaces/marketdataapp-endpoints-responses.html @@ -80,6 +80,14 @@

                                                                            • Exceptions +
                                                                            • +
                                                                            • + Logging + +
                                                                            • +
                                                                            • + Retry +
                                                                            • Traits @@ -133,7 +141,6 @@

                                                                              -
                                                                              Indices
                                                                              Markets
                                                                              MutualFunds
                                                                              Options
                                                                              @@ -196,6 +203,8 @@

                                                                              if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/namespaces/marketdataapp-endpoints.html b/docs/namespaces/marketdataapp-endpoints.html index 92c925b4..d398df5b 100644 --- a/docs/namespaces/marketdataapp-endpoints.html +++ b/docs/namespaces/marketdataapp-endpoints.html @@ -80,6 +80,14 @@

                                                                            • Exceptions +
                                                                            • +
                                                                            • + Logging + +
                                                                            • +
                                                                            • + Retry +
                                                                            • Traits @@ -143,7 +151,7 @@

                                                                              -
                                                                              Indices
                                                                              Indices class for handling index-related API endpoints.
                                                                              Markets
                                                                              Markets class for handling market-related API endpoints.
                                                                              MutualFunds
                                                                              MutualFunds class for handling mutual fund-related API endpoints.
                                                                              Options
                                                                              Class Options
                                                                              Stocks
                                                                              Stocks class for handling stock-related API endpoints.
                                                                              Utilities
                                                                              Utilities class for Market Data API.
                                                                              +
                                                                              Markets
                                                                              Markets class for handling market-related API endpoints.
                                                                              MutualFunds
                                                                              MutualFunds class for handling mutual fund-related API endpoints.
                                                                              Options
                                                                              Class Options
                                                                              Stocks
                                                                              Stocks class for handling stock-related API endpoints.
                                                                              Utilities
                                                                              Utilities class for Market Data API.
                                                                            • @@ -191,6 +199,8 @@

                                                                              if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/namespaces/marketdataapp-enums.html b/docs/namespaces/marketdataapp-enums.html index 56d1d195..11e92e9e 100644 --- a/docs/namespaces/marketdataapp-enums.html +++ b/docs/namespaces/marketdataapp-enums.html @@ -80,6 +80,14 @@

                                                                            • Exceptions +
                                                                            • +
                                                                            • + Logging + +
                                                                            • +
                                                                            • + Retry +
                                                                            • Traits @@ -136,7 +144,7 @@

                                                                              -
                                                                              Expiration
                                                                              Enum Expiration
                                                                              Format
                                                                              Enum Format
                                                                              Range
                                                                              Enum Range
                                                                              Side
                                                                              Enum Side
                                                                              +
                                                                              ApiStatusResult
                                                                              Enum representing the status result of an API service.
                                                                              DateFormat
                                                                              Enum DateFormat
                                                                              Expiration
                                                                              Enum Expiration
                                                                              Format
                                                                              Enum Format
                                                                              Mode
                                                                              Enum Mode
                                                                              Range
                                                                              Enum Range
                                                                              Side
                                                                              Enum Side
                                                                              @@ -182,6 +190,8 @@

                                                                              if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/namespaces/marketdataapp-exceptions.html b/docs/namespaces/marketdataapp-exceptions.html index fbc08e4b..f5564f7e 100644 --- a/docs/namespaces/marketdataapp-exceptions.html +++ b/docs/namespaces/marketdataapp-exceptions.html @@ -80,6 +80,14 @@

                                                                            • Exceptions +
                                                                            • +
                                                                            • + Logging + +
                                                                            • +
                                                                            • + Retry +
                                                                            • Traits @@ -134,7 +142,7 @@

                                                                              -
                                                                              ApiException
                                                                              ApiException class
                                                                              +
                                                                              ApiException
                                                                              ApiException class
                                                                              BadStatusCodeError
                                                                              BadStatusCodeError class
                                                                              MarketDataException
                                                                              Base exception class for all Market Data SDK exceptions.
                                                                              RequestError
                                                                              RequestError class
                                                                              UnauthorizedException
                                                                              UnauthorizedException class
                                                                              @@ -182,6 +190,8 @@

                                                                              if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/namespaces/marketdataapp-logging.html b/docs/namespaces/marketdataapp-logging.html new file mode 100644 index 00000000..bf7c9a8e --- /dev/null +++ b/docs/namespaces/marketdataapp-logging.html @@ -0,0 +1,296 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                                                                              +

                                                                              + MarketData SDK +

                                                                              + + + + + +
                                                                              + +
                                                                              +
                                                                              + + + + +
                                                                              +
                                                                              + + +
                                                                              +

                                                                              Logging

                                                                              + + +

                                                                              + Table of Contents + + +

                                                                              + + + + +

                                                                              + Classes + + +

                                                                              +
                                                                              +
                                                                              DefaultLogger
                                                                              Default PSR-3 compliant logger for MarketDataApp SDK.
                                                                              LoggerFactory
                                                                              Factory for creating and managing logger instances.
                                                                              LoggingUtilities
                                                                              Utility functions for logging.
                                                                              + + + + + + + + + + + +
                                                                              +
                                                                              +
                                                                              +
                                                                              +
                                                                              
                                                                              +        
                                                                              + +
                                                                              +
                                                                              + + + +
                                                                              +
                                                                              +
                                                                              + +
                                                                              + On this page + +
                                                                                +
                                                                              • Table Of Contents
                                                                              • +
                                                                              • + +
                                                                              • + + +
                                                                              +
                                                                              + +
                                                                              +
                                                                              +
                                                                              +
                                                                              +
                                                                              +

                                                                              Search results

                                                                              + +
                                                                              +
                                                                              +
                                                                                +
                                                                                +
                                                                                +
                                                                                +
                                                                                + + +
                                                                                + + + + + + + + diff --git a/docs/namespaces/marketdataapp-retry.html b/docs/namespaces/marketdataapp-retry.html new file mode 100644 index 00000000..8ef018d5 --- /dev/null +++ b/docs/namespaces/marketdataapp-retry.html @@ -0,0 +1,296 @@ + + + + + Documentation + + + + + + + + + + + + + + + + + + + + + +
                                                                                +

                                                                                + MarketData SDK +

                                                                                + + + + + +
                                                                                + +
                                                                                +
                                                                                + + + + +
                                                                                +
                                                                                + + +
                                                                                +

                                                                                Retry

                                                                                + + +

                                                                                + Table of Contents + + +

                                                                                + + + + +

                                                                                + Classes + + +

                                                                                +
                                                                                +
                                                                                RetryConfig
                                                                                Retry configuration constants matching the Python SDK.
                                                                                + + + + + + + + + + + +
                                                                                +
                                                                                +
                                                                                +
                                                                                +
                                                                                
                                                                                +        
                                                                                + +
                                                                                +
                                                                                + + + +
                                                                                +
                                                                                +
                                                                                + +
                                                                                + On this page + +
                                                                                  +
                                                                                • Table Of Contents
                                                                                • +
                                                                                • + +
                                                                                • + + +
                                                                                +
                                                                                + +
                                                                                +
                                                                                +
                                                                                +
                                                                                +
                                                                                +

                                                                                Search results

                                                                                + +
                                                                                +
                                                                                +
                                                                                  +
                                                                                  +
                                                                                  +
                                                                                  +
                                                                                  + + +
                                                                                  + + + + + + + + diff --git a/docs/namespaces/marketdataapp-traits.html b/docs/namespaces/marketdataapp-traits.html index 95368e6e..b48b2f8c 100644 --- a/docs/namespaces/marketdataapp-traits.html +++ b/docs/namespaces/marketdataapp-traits.html @@ -80,6 +80,14 @@

                                                                                • Exceptions +
                                                                                • +
                                                                                • + Logging + +
                                                                                • +
                                                                                • + Retry +
                                                                                • Traits @@ -135,7 +143,7 @@

                                                                                  -
                                                                                  UniversalParameters
                                                                                  Trait UniversalParameters
                                                                                  +
                                                                                  FormatsForDisplay
                                                                                  Trait for formatting values in __toString() methods.
                                                                                  UniversalParameters
                                                                                  Trait UniversalParameters
                                                                                  ValidatesInputs
                                                                                  Trait for input validation methods.
                                                                                  @@ -182,6 +190,8 @@

                                                                                  if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/namespaces/marketdataapp.html b/docs/namespaces/marketdataapp.html index 449892e6..dd3ea322 100644 --- a/docs/namespaces/marketdataapp.html +++ b/docs/namespaces/marketdataapp.html @@ -80,6 +80,14 @@

                                                                                • Exceptions +
                                                                                • +
                                                                                • + Logging + +
                                                                                • +
                                                                                • + Retry +
                                                                                • Traits @@ -134,6 +142,8 @@

                                                                                  Endpoints
                                                                                  Enums
                                                                                  Exceptions
                                                                                  +
                                                                                  Logging
                                                                                  +
                                                                                  Retry
                                                                                  Traits
                                                                                  @@ -144,7 +154,7 @@

                                                                                  -
                                                                                  Client
                                                                                  Client class for the Market Data API.
                                                                                  ClientBase
                                                                                  Abstract base class for Market Data API client.
                                                                                  +
                                                                                  Client
                                                                                  Client class for the Market Data API.
                                                                                  ClientBase
                                                                                  Abstract base class for Market Data API client.
                                                                                  RateLimits
                                                                                  Represents rate limit information from API responses.
                                                                                  Settings
                                                                                  Settings class for MarketDataApp SDK.
                                                                                  @@ -192,6 +202,8 @@

                                                                                  if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/packages/Application.html b/docs/packages/Application.html index 97be266c..809e64b7 100644 --- a/docs/packages/Application.html +++ b/docs/packages/Application.html @@ -80,6 +80,14 @@

                                                                                • Exceptions +
                                                                                • +
                                                                                • + Logging + +
                                                                                • +
                                                                                • + Retry +
                                                                                • Traits @@ -133,7 +141,7 @@

                                                                                  -
                                                                                  Client
                                                                                  Client class for the Market Data API.
                                                                                  ClientBase
                                                                                  Abstract base class for Market Data API client.
                                                                                  Indices
                                                                                  Indices class for handling index-related API endpoints.
                                                                                  Markets
                                                                                  Markets class for handling market-related API endpoints.
                                                                                  MutualFunds
                                                                                  MutualFunds class for handling mutual fund-related API endpoints.
                                                                                  Options
                                                                                  Class Options
                                                                                  Parameters
                                                                                  Represents parameters for API requests.
                                                                                  Candle
                                                                                  Represents a financial candle with open, high, low, and close prices for a specific timestamp.
                                                                                  Candles
                                                                                  Represents a collection of financial candles with additional metadata.
                                                                                  Quote
                                                                                  Represents a financial quote for an index.
                                                                                  Quotes
                                                                                  Represents a collection of Quote objects.
                                                                                  Status
                                                                                  Represents the status of a market for a specific date.
                                                                                  Statuses
                                                                                  Represents a collection of market statuses for different dates.
                                                                                  Candle
                                                                                  Represents a financial candle for mutual funds with open, high, low, and close prices for a specific timestamp.
                                                                                  Candles
                                                                                  Represents a collection of financial candles for mutual funds.
                                                                                  Expirations
                                                                                  Represents a collection of option expirations dates and related data.
                                                                                  Lookup
                                                                                  Represents a lookup response for generating OCC option symbols.
                                                                                  OptionChains
                                                                                  Represents a collection of option chains with associated data.
                                                                                  OptionChainStrike
                                                                                  Represents a single option chain strike with associated data.
                                                                                  Quote
                                                                                  Represents a single option quote with associated data.
                                                                                  Quotes
                                                                                  Represents a collection of option quotes with associated data.
                                                                                  Strikes
                                                                                  Represents a collection of option strikes with associated data.
                                                                                  ResponseBase
                                                                                  Base class for API responses.
                                                                                  BulkCandles
                                                                                  Represents a collection of stock candles data in bulk format.
                                                                                  BulkQuote
                                                                                  Represents a bulk quote for a stock with various price and volume information.
                                                                                  BulkQuotes
                                                                                  Represents a collection of bulk stock quotes.
                                                                                  Candle
                                                                                  Represents a single stock candle with open, high, low, close prices, volume, and timestamp.
                                                                                  Candles
                                                                                  Class Candles
                                                                                  Earning
                                                                                  Class Earning
                                                                                  Earnings
                                                                                  Class Earnings
                                                                                  News
                                                                                  Class News
                                                                                  Quote
                                                                                  Class Quote
                                                                                  Quotes
                                                                                  Represents a collection of stock quotes.
                                                                                  ApiStatus
                                                                                  Represents the status of the API and its services.
                                                                                  Headers
                                                                                  Represents the headers of an API response.
                                                                                  ServiceStatus
                                                                                  Represents the status of a service.
                                                                                  Stocks
                                                                                  Stocks class for handling stock-related API endpoints.
                                                                                  Utilities
                                                                                  Utilities class for Market Data API.
                                                                                  ApiException
                                                                                  ApiException class
                                                                                  +
                                                                                  Client
                                                                                  Client class for the Market Data API.
                                                                                  ClientBase
                                                                                  Abstract base class for Market Data API client.
                                                                                  Markets
                                                                                  Markets class for handling market-related API endpoints.
                                                                                  MutualFunds
                                                                                  MutualFunds class for handling mutual fund-related API endpoints.
                                                                                  Options
                                                                                  Class Options
                                                                                  Parameters
                                                                                  Represents universal parameters for API requests.
                                                                                  Status
                                                                                  Represents the status of a market for a specific date.
                                                                                  Statuses
                                                                                  Represents a collection of market statuses for different dates.
                                                                                  Candle
                                                                                  Represents a financial candle for mutual funds with open, high, low, and close prices for a specific timestamp.
                                                                                  Candles
                                                                                  Represents a collection of financial candles for mutual funds.
                                                                                  Expirations
                                                                                  Represents a collection of option expirations dates and related data.
                                                                                  Lookup
                                                                                  Represents a lookup response for generating OCC option symbols.
                                                                                  OptionChains
                                                                                  Represents a collection of option chains with associated data.
                                                                                  OptionQuote
                                                                                  Represents a single option quote with associated data.
                                                                                  Quotes
                                                                                  Represents a collection of option quotes with associated data.
                                                                                  Strikes
                                                                                  Represents a collection of option strikes with associated data.
                                                                                  ResponseBase
                                                                                  Base class for API responses.
                                                                                  BulkCandles
                                                                                  Represents a collection of stock candles data in bulk format.
                                                                                  Candle
                                                                                  Represents a single stock candle with open, high, low, close prices, volume, and timestamp.
                                                                                  Candles
                                                                                  Class Candles
                                                                                  Earning
                                                                                  Class Earning
                                                                                  Earnings
                                                                                  Class Earnings
                                                                                  News
                                                                                  Class News
                                                                                  Prices
                                                                                  Class Prices
                                                                                  Quote
                                                                                  Class Quote
                                                                                  Quotes
                                                                                  Represents a collection of stock quotes.
                                                                                  ApiStatus
                                                                                  Represents the status of the API and its services.
                                                                                  ApiStatusData
                                                                                  Manages API status caching and provides service status checking.
                                                                                  Headers
                                                                                  Represents the headers of an API response.
                                                                                  ServiceStatus
                                                                                  Represents the status of a service.
                                                                                  User
                                                                                  Represents user/rate limit information from the API.
                                                                                  Stocks
                                                                                  Stocks class for handling stock-related API endpoints.
                                                                                  Utilities
                                                                                  Utilities class for Market Data API.
                                                                                  ApiException
                                                                                  ApiException class
                                                                                  BadStatusCodeError
                                                                                  BadStatusCodeError class
                                                                                  MarketDataException
                                                                                  Base exception class for all Market Data SDK exceptions.
                                                                                  RequestError
                                                                                  RequestError class
                                                                                  UnauthorizedException
                                                                                  UnauthorizedException class
                                                                                  DefaultLogger
                                                                                  Default PSR-3 compliant logger for MarketDataApp SDK.
                                                                                  LoggerFactory
                                                                                  Factory for creating and managing logger instances.
                                                                                  LoggingUtilities
                                                                                  Utility functions for logging.
                                                                                  RateLimits
                                                                                  Represents rate limit information from API responses.
                                                                                  RetryConfig
                                                                                  Retry configuration constants matching the Python SDK.
                                                                                  Settings
                                                                                  Settings class for MarketDataApp SDK.

                                                                                  Traits @@ -141,7 +149,7 @@

                                                                                  -
                                                                                  UniversalParameters
                                                                                  Trait UniversalParameters
                                                                                  +
                                                                                  FormatsForDisplay
                                                                                  Trait for formatting values in __toString() methods.
                                                                                  UniversalParameters
                                                                                  Trait UniversalParameters
                                                                                  ValidatesInputs
                                                                                  Trait for input validation methods.

                                                                                  Enums @@ -149,7 +157,7 @@

                                                                                  -
                                                                                  Expiration
                                                                                  Enum Expiration
                                                                                  Format
                                                                                  Enum Format
                                                                                  Range
                                                                                  Enum Range
                                                                                  Side
                                                                                  Enum Side
                                                                                  +
                                                                                  ApiStatusResult
                                                                                  Enum representing the status result of an API service.
                                                                                  DateFormat
                                                                                  Enum DateFormat
                                                                                  Expiration
                                                                                  Enum Expiration
                                                                                  Format
                                                                                  Enum Format
                                                                                  Mode
                                                                                  Enum Mode
                                                                                  Range
                                                                                  Enum Range
                                                                                  Side
                                                                                  Enum Side
                                                                                  @@ -195,6 +203,8 @@

                                                                                  if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/packages/default.html b/docs/packages/default.html index 98e23853..2d8b013b 100644 --- a/docs/packages/default.html +++ b/docs/packages/default.html @@ -80,6 +80,14 @@

                                                                                • Exceptions +
                                                                                • +
                                                                                • + Logging + +
                                                                                • +
                                                                                • + Retry +
                                                                                • Traits @@ -182,6 +190,8 @@

                                                                                  if (xhr.status < 400 && xhr.responseText) { code.textContent = xhr.responseText; Prism.highlightElement(code); + d=document.getElementsByClassName("line-numbers"); + d[0].scrollTop = d[0].children[1].offsetTop; return; } diff --git a/docs/reports/deprecated.html b/docs/reports/deprecated.html index 8d53db26..306a6c6c 100644 --- a/docs/reports/deprecated.html +++ b/docs/reports/deprecated.html @@ -81,6 +81,14 @@

                                                                                • Exceptions +
                                                                                • +
                                                                                • + Logging + +
                                                                                • +
                                                                                • + Retry +
                                                                                • Traits diff --git a/docs/reports/errors.html b/docs/reports/errors.html index a51b93b3..3c747891 100644 --- a/docs/reports/errors.html +++ b/docs/reports/errors.html @@ -81,6 +81,14 @@

                                                                                • Exceptions +
                                                                                • +
                                                                                • + Logging + +
                                                                                • +
                                                                                • + Retry +
                                                                                • Traits diff --git a/docs/reports/markers.html b/docs/reports/markers.html index 8db0ef94..2bc2f3ec 100644 --- a/docs/reports/markers.html +++ b/docs/reports/markers.html @@ -81,6 +81,14 @@

                                                                                • Exceptions +
                                                                                • +
                                                                                • + Logging + +
                                                                                • +
                                                                                • + Retry +
                                                                                • Traits