@bitget-ai/getagent-skill 0.2.1 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. package/.claude-plugin/marketplace.json +15 -4
  2. package/.claude-plugin/plugin.json +1 -1
  3. package/VERSION +1 -1
  4. package/package.json +1 -1
  5. package/skills/getagent/SKILL.md +169 -6
  6. package/skills/getagent/examples/btc-ema-cross-demo/backtest.yaml +4 -0
  7. package/skills/getagent/references/api/confirm.md +59 -0
  8. package/skills/getagent/references/api/index.md +9 -7
  9. package/skills/getagent/references/api/publish.md +13 -6
  10. package/skills/getagent/references/api/run.md +5 -5
  11. package/skills/getagent/references/api/upload.md +22 -4
  12. package/skills/getagent/references/backtest-engine.md +82 -152
  13. package/skills/getagent/references/package-schema.md +31 -8
  14. package/skills/getagent/references/sdk/backtest/catalog.md +17 -2
  15. package/skills/getagent/references/sdk/data/arxiv.md +8 -10
  16. package/skills/getagent/references/sdk/data/catalog.md +3 -8
  17. package/skills/getagent/references/sdk/data/commodity.md +71 -39
  18. package/skills/getagent/references/sdk/data/coverage.md +0 -3
  19. package/skills/getagent/references/sdk/data/crypto.md +1583 -402
  20. package/skills/getagent/references/sdk/data/currency.md +55 -15
  21. package/skills/getagent/references/sdk/data/derivatives.md +161 -50
  22. package/skills/getagent/references/sdk/data/economy.md +911 -259
  23. package/skills/getagent/references/sdk/data/equity.md +1719 -393
  24. package/skills/getagent/references/sdk/data/etf.md +550 -64
  25. package/skills/getagent/references/sdk/data/famafrench.md +38 -50
  26. package/skills/getagent/references/sdk/data/fixedincome.md +574 -139
  27. package/skills/getagent/references/sdk/data/imf_utils.md +0 -8
  28. package/skills/getagent/references/sdk/data/index.md +18 -32
  29. package/skills/getagent/references/sdk/data/news.md +128 -58
  30. package/skills/getagent/references/sdk/data/regulators.md +108 -43
  31. package/skills/getagent/references/sdk/data/sentiment.md +188 -34
  32. package/skills/getagent/references/sdk/data/uscongress.md +13 -21
  33. package/skills/getagent/references/sdk/data/web_search.md +3 -7
  34. package/skills/getagent/references/sdk/data/wikipedia.md +12 -18
  35. package/skills/getagent/references/sdk.md +14 -5
  36. package/skills/getagent/scripts/validate.py +109 -3
  37. package/skills/getagent/scripts/version_check.sh +13 -12
  38. package/skills/getagent/references/sdk/data/playbook-supported.md +0 -9871
@@ -15,7 +15,7 @@ are callable through the DataSDK wrapper.
15
15
  ### `currency.price.historical`
16
16
 
17
17
  ```python
18
- data.currency.price.historical(symbol=..., start_time=None, end_time=None, interval='1d', provider=...)
18
+ data.currency.price.historical(symbol=..., start_time=None, end_time=None, interval='1d')
19
19
  ```
20
20
 
21
21
  Summary: Historical
@@ -25,7 +25,6 @@ Summary: Historical
25
25
  | Endpoint ID | `currency.price.historical` |
26
26
  | HTTP | `GET` |
27
27
  | Path | `/inner/v1/agent-data/currency/price/historical` |
28
- | Default provider | - |
29
28
  | SDK | `supported` |
30
29
  | Host | `supported` |
31
30
  | Notes | - |
@@ -34,18 +33,31 @@ Summary: Historical
34
33
 
35
34
  | Param | Required | Type | Default | Notes |
36
35
  |---|---|---|---|---|
37
- | `symbol` | `yes` | `string` | `-` | Symbol to get data for. Can use CURR1-CURR2 or CURR1CURR2 format. Multiple comma separated items allowed for provider(s): fmp, tiingo, yfinance. |
36
+ | `symbol` | `yes` | `string` | `-` | Symbol to get data for. Can use CURR1-CURR2 or CURR1CURR2 format. Multiple comma separated items allowed |
38
37
  | `start_time` | `no` | `integer | null` | `-` | Start time of the data as a Unix timestamp in milliseconds. Takes priority over start_date when both are provided. |
39
38
  | `end_time` | `no` | `integer | null` | `-` | End time of the data as a Unix timestamp in milliseconds. Takes priority over end_date when both are provided. |
40
- | `interval` | `no` | `string` | `1d` | Time interval of the data to return. (provider: fmp,tiingo, yfinance) |
41
- | `provider` | `yes` | `string` | `-` | enum: fmp, tiingo, yfinance |
39
+ | `interval` | `no` | `string` | `1d` | Time interval of the data to return. |
40
+
41
+ #### Response fields
42
+
43
+ | Field | Type | Notes |
44
+ |---|---|---|
45
+ | `date` | `string` | The date of the data. |
46
+ | `open` | `number` | The open price. |
47
+ | `high` | `number` | The high price. |
48
+ | `low` | `number` | The low price. |
49
+ | `close` | `number` | The close price. |
50
+ | `volume` | `number` | The trading volume. |
51
+ | `vwap` | `number` | Volume Weighted Average Price over the period. |
52
+ | `change` | `number` | Change in the price from the previous close. |
53
+ | `change_percent` | `number` | Percent change in the price from the previous close. |
42
54
 
43
55
  ---
44
56
 
45
57
  ### `currency.reference_rates`
46
58
 
47
59
  ```python
48
- data.currency.reference_rates(provider='ecb')
60
+ data.currency.reference_rates()
49
61
  ```
50
62
 
51
63
  Summary: Reference Rates
@@ -55,7 +67,6 @@ Summary: Reference Rates
55
67
  | Endpoint ID | `currency.reference_rates` |
56
68
  | HTTP | `GET` |
57
69
  | Path | `/inner/v1/agent-data/currency/reference_rates` |
58
- | Default provider | `ecb` |
59
70
  | SDK | `supported` |
60
71
  | Host | `supported` |
61
72
  | Notes | - |
@@ -64,14 +75,13 @@ Summary: Reference Rates
64
75
 
65
76
  | Param | Required | Type | Default | Notes |
66
77
  |---|---|---|---|---|
67
- | `provider` | `no` | `string` | `ecb` | - |
68
78
 
69
79
  ---
70
80
 
71
81
  ### `currency.search`
72
82
 
73
83
  ```python
74
- data.currency.search(query=None, provider=...)
84
+ data.currency.search(query=None)
75
85
  ```
76
86
 
77
87
  Summary: Search
@@ -81,7 +91,6 @@ Summary: Search
81
91
  | Endpoint ID | `currency.search` |
82
92
  | HTTP | `GET` |
83
93
  | Path | `/inner/v1/agent-data/currency/search` |
84
- | Default provider | - |
85
94
  | SDK | `supported` |
86
95
  | Host | `supported` |
87
96
  | Notes | - |
@@ -91,14 +100,26 @@ Summary: Search
91
100
  | Param | Required | Type | Default | Notes |
92
101
  |---|---|---|---|---|
93
102
  | `query` | `no` | `string | null` | `-` | Query to search for currency pairs. |
94
- | `provider` | `yes` | `string` | `-` | enum: fmp, intrinio |
103
+
104
+ #### Response fields
105
+
106
+ | Field | Type | Notes |
107
+ |---|---|---|
108
+ | `symbol` | `string` | Symbol representing the entity requested in the data. |
109
+ | `name` | `string` | Name of the currency pair. |
110
+ | `base_currency` | `string` | ISO 4217 currency code of the base currency. |
111
+ | `quote_currency` | `string` | ISO 4217 currency code of the quote currency. |
112
+ | `from_currency` | `string` | Base currency of the currency pair. |
113
+ | `to_currency` | `string` | Quote currency of the currency pair. |
114
+ | `from_name` | `string` | Name of the base currency. |
115
+ | `to_name` | `string` | Name of the quote currency. |
95
116
 
96
117
  ---
97
118
 
98
119
  ### `currency.snapshots`
99
120
 
100
121
  ```python
101
- data.currency.snapshots(base='usd', quote_type='indirect', counter_currencies=None, provider=...)
122
+ data.currency.snapshots(base='usd', quote_type='indirect', counter_currencies=None)
102
123
  ```
103
124
 
104
125
  Summary: Snapshots
@@ -108,7 +129,6 @@ Summary: Snapshots
108
129
  | Endpoint ID | `currency.snapshots` |
109
130
  | HTTP | `GET` |
110
131
  | Path | `/inner/v1/agent-data/currency/snapshots` |
111
- | Default provider | - |
112
132
  | SDK | `supported` |
113
133
  | Host | `supported` |
114
134
  | Notes | - |
@@ -117,7 +137,27 @@ Summary: Snapshots
117
137
 
118
138
  | Param | Required | Type | Default | Notes |
119
139
  |---|---|---|---|---|
120
- | `base` | `no` | `string` | `usd` | The base currency symbol. Multiple comma separated items allowed for provider(s): fmp. |
140
+ | `base` | `no` | `string` | `usd` | The base currency symbol. Multiple comma separated items allowed |
121
141
  | `quote_type` | `no` | `string` | `indirect` | enum: direct, indirect Whether the quote is direct or indirect. Selecting 'direct' will return the exchange rate as the amount of domestic currency required to buy one unit of the foreign currency. Selecting 'indirect' (default) will return the exchange rate as the amount of foreign currency required to buy one unit of the domestic currency. |
122
142
  | `counter_currencies` | `no` | `string | array | null` | `-` | accepts array values An optional list of counter currency symbols to filter for. None returns all. |
123
- | `provider` | `yes` | `string` | `-` | enum: exchangerate_api, fmp |
143
+
144
+ #### Response fields
145
+
146
+ | Field | Type | Notes |
147
+ |---|---|---|
148
+ | `base_currency` | `string` | The base, or domestic, currency. |
149
+ | `counter_currency` | `string` | The counter, or foreign, currency. |
150
+ | `last_rate` | `number` | The exchange rate, relative to the base currency. |
151
+ | `open` | `number` | The open price. |
152
+ | `high` | `number` | The high price. |
153
+ | `low` | `number` | The low price. |
154
+ | `close` | `number` | The close price. |
155
+ | `volume` | `integer` | The trading volume. |
156
+ | `prev_close` | `number` | The previous close price. |
157
+ | `last_rate_timestamp` | `string` | UTC timestamp of when the exchange rate was last updated. |
158
+ | `change` | `number` | The change in the price from the previous close. |
159
+ | `change_percent` | `number` | The change in the price from the previous close, as a normalized percent. |
160
+ | `ma_50` | `number` | The 50-day moving average. |
161
+ | `ma_200` | `number` | The 200-day moving average. |
162
+ | `year_high` | `number` | The 52-week high. |
163
+ | `year_low` | `number` | The 52-week low. |
@@ -19,7 +19,7 @@ are callable through the DataSDK wrapper.
19
19
  ### `derivatives.futures.curve`
20
20
 
21
21
  ```python
22
- data.derivatives.futures.curve(symbol=..., date=None, hours_ago=None, provider=...)
22
+ data.derivatives.futures.curve(symbol=..., date=None, hours_ago=None)
23
23
  ```
24
24
 
25
25
  Summary: Curve
@@ -29,7 +29,6 @@ Summary: Curve
29
29
  | Endpoint ID | `derivatives.futures.curve` |
30
30
  | HTTP | `GET` |
31
31
  | Path | `/inner/v1/agent-data/derivatives/futures/curve` |
32
- | Default provider | - |
33
32
  | SDK | `supported` |
34
33
  | Host | `supported` |
35
34
  | Notes | - |
@@ -38,17 +37,26 @@ Summary: Curve
38
37
 
39
38
  | Param | Required | Type | Default | Notes |
40
39
  |---|---|---|---|---|
41
- | `symbol` | `yes` | `string` | `-` | Symbol to get data for.; Symbol to get data for.Default is 'VX_EOD'. Entered dates return the data nearest to the entered date. 'VX_AM' = Mid-Morning TWAP Levels 'VX_EOD' = 4PM Eastern Time Levels (provider: cboe); Symbol to get data for. Default is 'btc' Supported symbols are: ['btc', 'eth', 'paxg'] (provider: deribit) |
42
- | `date` | `no` | `string | null` | `-` | A specific date to get data for. Multiple comma separated items allowed for provider(s): cboe, yfinance. |
43
- | `hours_ago` | `no` | `integer | array | string | null` | `-` | accepts array values Compare the current curve with the specified number of hours ago. Default is None. Multiple comma separated items allowed. (provider: deribit) |
44
- | `provider` | `yes` | `string` | `-` | enum: cboe, deribit, yfinance |
40
+ | `symbol` | `yes` | `string` | `-` | Symbol to get data for.; Symbol to get data for.Default is 'VX_EOD'. Entered dates return the data nearest to the entered date. 'VX_AM' = Mid-Morning TWAP Levels 'VX_EOD' = 4PM Eastern Time Levels; Symbol to get data for. Default is 'btc' Supported symbols are: ['btc', 'eth', 'paxg'] |
41
+ | `date` | `no` | `string | null` | `-` | A specific date to get data for. Multiple comma separated items allowed |
42
+ | `hours_ago` | `no` | `integer | array | string | null` | `-` | accepts array values Compare the current curve with the specified number of hours ago. Default is None. Multiple comma separated items allowed. |
43
+
44
+ #### Response fields
45
+
46
+ | Field | Type | Notes |
47
+ |---|---|---|
48
+ | `date` | `string` | The date of the data. |
49
+ | `expiration` | `string` | Futures expiration month. |
50
+ | `price` | `number` | The price of the futures contract. |
51
+ | `symbol` | `string` | Symbol representing the entity requested in the data. |
52
+ | `hours_ago` | `integer` | The number of hours ago represented by the price. Only available when hours_ago is set in the query. |
45
53
 
46
54
  ---
47
55
 
48
56
  ### `derivatives.futures.historical`
49
57
 
50
58
  ```python
51
- data.derivatives.futures.historical(symbol=..., start_time=None, end_time=None, expiration=None, interval='1d', provider=...)
59
+ data.derivatives.futures.historical(symbol=..., start_time=None, end_time=None, expiration=None, interval='1d')
52
60
  ```
53
61
 
54
62
  Summary: Historical
@@ -58,7 +66,6 @@ Summary: Historical
58
66
  | Endpoint ID | `derivatives.futures.historical` |
59
67
  | HTTP | `GET` |
60
68
  | Path | `/inner/v1/agent-data/derivatives/futures/historical` |
61
- | Default provider | - |
62
69
  | SDK | `supported` |
63
70
  | Host | `supported` |
64
71
  | Notes | - |
@@ -67,19 +74,30 @@ Summary: Historical
67
74
 
68
75
  | Param | Required | Type | Default | Notes |
69
76
  |---|---|---|---|---|
70
- | `symbol` | `yes` | `string` | `-` | Symbol to get data for. Multiple comma separated items allowed for provider(s): deribit, yfinance. |
77
+ | `symbol` | `yes` | `string` | `-` | Symbol to get data for. Multiple comma separated items allowed |
71
78
  | `start_time` | `no` | `integer | null` | `-` | Start time of the data as a Unix timestamp in milliseconds. Takes priority over start_date when both are provided. |
72
79
  | `end_time` | `no` | `integer | null` | `-` | End time of the data as a Unix timestamp in milliseconds. Takes priority over end_date when both are provided. |
73
80
  | `expiration` | `no` | `string | null` | `-` | Future expiry date with format YYYY-MM |
74
- | `interval` | `no` | `string` | `1d` | Time interval of the data to return. (provider: deribit, yfinance) |
75
- | `provider` | `yes` | `string` | `-` | enum: deribit, yfinance |
81
+ | `interval` | `no` | `string` | `1d` | Time interval of the data to return. |
82
+
83
+ #### Response fields
84
+
85
+ | Field | Type | Notes |
86
+ |---|---|---|
87
+ | `date` | `string` | The date of the data. |
88
+ | `open` | `number` | The open price. |
89
+ | `high` | `number` | The high price. |
90
+ | `low` | `number` | The low price. |
91
+ | `close` | `number` | The close price. |
92
+ | `volume` | `number` | The trading volume. |
93
+ | `volume_notional` | `number` | Trading volume in quote currency. |
76
94
 
77
95
  ---
78
96
 
79
97
  ### `derivatives.futures.info`
80
98
 
81
99
  ```python
82
- data.derivatives.futures.info(symbol=None, provider='deribit')
100
+ data.derivatives.futures.info(symbol=None)
83
101
  ```
84
102
 
85
103
  Summary: Info
@@ -89,7 +107,6 @@ Summary: Info
89
107
  | Endpoint ID | `derivatives.futures.info` |
90
108
  | HTTP | `GET` |
91
109
  | Path | `/inner/v1/agent-data/derivatives/futures/info` |
92
- | Default provider | `deribit` |
93
110
  | SDK | `supported` |
94
111
  | Host | `supported` |
95
112
  | Notes | - |
@@ -98,15 +115,43 @@ Summary: Info
98
115
 
99
116
  | Param | Required | Type | Default | Notes |
100
117
  |---|---|---|---|---|
101
- | `symbol` | `no` | `string | null` | `-` | Symbol to get data for. Perpetual contracts can be referenced by their currency pair - i.e, SOLUSDC - or by their official Deribit symbol - i.e, SOL_USDC-PERPETUAL For a list of currently available instruments, use `derivatives.futures.instruments()` Multiple comma separated items allowed. (provider: deribit) |
102
- | `provider` | `no` | `string` | `deribit` | - |
118
+ | `symbol` | `no` | `string | null` | `-` | Symbol to get data for. Perpetual contracts can be referenced by their currency pair - i.e, SOLUSDC - or by their official Deribit symbol - i.e, SOL_USDC-PERPETUAL For a list of currently available instruments, use `derivatives.futures.instruments()` Multiple comma separated items allowed. |
119
+
120
+ #### Response fields
121
+
122
+ | Field | Type | Notes |
123
+ |---|---|---|
124
+ | `symbol` | `string` | Symbol representing the entity requested in the data. |
125
+ | `state` | `string` | The state of the order book. Possible values are open and closed. |
126
+ | `open_interest` | `number` | The total amount of outstanding contracts in the corresponding amount units. |
127
+ | `index_price` | `number` | Current index (reference) price. |
128
+ | `best_ask_amount` | `number` | Requested order size of all best asks. |
129
+ | `best_ask_price` | `number` | The current best ask price, null if there aren't any asks. |
130
+ | `best_bid_price` | `number` | The current best bid price, null if there aren't any bids. |
131
+ | `best_bid_amount` | `number` | Requested order size of all best bids. |
132
+ | `last_price` | `number` | The price for the last trade. |
133
+ | `high` | `number` | Highest price during 24h. |
134
+ | `low` | `number` | Lowest price during 24h. |
135
+ | `change_percent` | `number` | 24-hour price change expressed as a percentage. |
136
+ | `volume` | `number` | Volume during last 24h in base currency. |
137
+ | `volume_usd` | `number` | Volume in USD. |
138
+ | `mark_price` | `number` | The mark price for the instrument. |
139
+ | `settlement_price` | `number` | The settlement price for the instrument. Only when state = open. |
140
+ | `delivery_price` | `number` | The settlement price for the instrument. Only when state = closed. |
141
+ | `estimated_delivery_price` | `number` | Estimated delivery price for the market. |
142
+ | `current_funding` | `number` | Current funding (perpetual only). |
143
+ | `funding_8h` | `number` | Funding 8h (perpetual only). |
144
+ | `interest_value` | `number` | Value used to calculate realized_funding in positions (perpetual only). |
145
+ | `max_price` | `number` | The maximum price for the future. |
146
+ | `min_price` | `number` | The minimum price for the future. |
147
+ | `timestamp` | `string` | The timestamp of the data. |
103
148
 
104
149
  ---
105
150
 
106
151
  ### `derivatives.futures.instruments`
107
152
 
108
153
  ```python
109
- data.derivatives.futures.instruments(provider='deribit')
154
+ data.derivatives.futures.instruments()
110
155
  ```
111
156
 
112
157
  Summary: Instruments
@@ -116,7 +161,6 @@ Summary: Instruments
116
161
  | Endpoint ID | `derivatives.futures.instruments` |
117
162
  | HTTP | `GET` |
118
163
  | Path | `/inner/v1/agent-data/derivatives/futures/instruments` |
119
- | Default provider | `deribit` |
120
164
  | SDK | `supported` |
121
165
  | Host | `supported` |
122
166
  | Notes | - |
@@ -125,14 +169,40 @@ Summary: Instruments
125
169
 
126
170
  | Param | Required | Type | Default | Notes |
127
171
  |---|---|---|---|---|
128
- | `provider` | `no` | `string` | `deribit` | - |
172
+
173
+ #### Response fields
174
+
175
+ | Field | Type | Notes |
176
+ |---|---|---|
177
+ | `instrument_id` | `integer` | Deribit Instrument ID. |
178
+ | `symbol` | `string` | Symbol representing the entity requested in the data. |
179
+ | `base_currency` | `string` | The underlying currency being traded. |
180
+ | `counter_currency` | `string` | Counter currency for the instrument. |
181
+ | `quote_currency` | `string` | The currency in which the instrument prices are quoted. |
182
+ | `settlement_currency` | `string` | Settlement currency for the instrument. |
183
+ | `future_type` | `string` | Type of the instrument. linear or reversed. |
184
+ | `settlement_period` | `string` | The settlement period. |
185
+ | `price_index` | `string` | Name of price index that is used for this instrument. |
186
+ | `contract_size` | `number` | Contract size for instrument. |
187
+ | `is_active` | `boolean` | Indicates if the instrument can currently be traded. |
188
+ | `creation_timestamp` | `string` | The time when the instrument was first created (milliseconds since the UNIX epoch). |
189
+ | `expiration_timestamp` | `string` | The time when the instrument will expire (milliseconds since the UNIX epoch). |
190
+ | `tick_size` | `number` | Specifies minimal price change and the number of decimal places for instrument prices. |
191
+ | `min_trade_amount` | `number` | Minimum amount for trading, in USD units. |
192
+ | `max_leverage` | `integer` | Maximal leverage for instrument. |
193
+ | `max_liquidation_commission` | `number` | Maximal liquidation trade commission for instrument. |
194
+ | `block_trade_commission` | `number` | Block Trade commission for instrument. |
195
+ | `block_trade_min_trade_amount` | `number` | Minimum amount for block trading. |
196
+ | `block_trade_tick_size` | `number` | Specifies minimal price change for block trading. |
197
+ | `maker_commission` | `number` | Maker commission for instrument. |
198
+ | `taker_commission` | `number` | Taker commission for instrument. |
129
199
 
130
200
  ---
131
201
 
132
202
  ### `derivatives.options.chains`
133
203
 
134
204
  ```python
135
- data.derivatives.options.chains(symbol=..., use_cache=True, delay='eod', date=None, option_type=None, moneyness='all', strike_gt=None, strike_lt=None, volume_gt=None, volume_lt=None, oi_gt=None, oi_lt=None, model='black_scholes', show_extended_price=True, include_related_symbols=False, provider=...)
205
+ data.derivatives.options.chains(symbol=..., use_cache=True, delay='eod', date=None, option_type=None, moneyness='all', strike_gt=None, strike_lt=None, volume_gt=None, volume_lt=None, oi_gt=None, oi_lt=None, model='black_scholes', show_extended_price=True, include_related_symbols=False)
136
206
  ```
137
207
 
138
208
  Summary: Chains
@@ -142,7 +212,6 @@ Summary: Chains
142
212
  | Endpoint ID | `derivatives.options.chains` |
143
213
  | HTTP | `GET` |
144
214
  | Path | `/inner/v1/agent-data/derivatives/options/chains` |
145
- | Default provider | - |
146
215
  | SDK | `supported` |
147
216
  | Host | `supported` |
148
217
  | Notes | - |
@@ -152,28 +221,27 @@ Summary: Chains
152
221
  | Param | Required | Type | Default | Notes |
153
222
  |---|---|---|---|---|
154
223
  | `symbol` | `yes` | `string` | `-` | Symbol to get data for. |
155
- | `use_cache` | `no` | `boolean` | `true` | When True, the company directories will be cached for24 hours and are used to validate symbols. The results of the function are not cached. Set as False to bypass. (provider: cboe); Caching is used to validate the supplied ticker symbol, or if a historical EOD chain is requested. To bypass, set to False. (provider: tmx) |
156
- | `delay` | `no` | `string` | `eod` | enum: eod, realtime, delayed Whether to return delayed, realtime, or eod data. (provider: intrinio) |
157
- | `date` | `no` | `string | null` | `-` | The end-of-day date for options chains data. (provider: intrinio); A specific date to get data for. (provider: tmx) |
158
- | `option_type` | `no` | `string | null` | `-` | The option type, call or put, 'None' is both (default). (provider: intrinio) |
159
- | `moneyness` | `no` | `string` | `all` | enum: otm, itm, all Return only contracts that are in or out of the money, default is 'all'. Parameter is ignored when a date is supplied. (provider: intrinio) |
160
- | `strike_gt` | `no` | `integer | null` | `-` | Return options with a strike price greater than the given value. Parameter is ignored when a date is supplied. (provider: intrinio) |
161
- | `strike_lt` | `no` | `integer | null` | `-` | Return options with a strike price less than the given value. Parameter is ignored when a date is supplied. (provider: intrinio) |
162
- | `volume_gt` | `no` | `integer | null` | `-` | Return options with a volume greater than the given value. Parameter is ignored when a date is supplied. (provider: intrinio) |
163
- | `volume_lt` | `no` | `integer | null` | `-` | Return options with a volume less than the given value. Parameter is ignored when a date is supplied. (provider: intrinio) |
164
- | `oi_gt` | `no` | `integer | null` | `-` | Return options with an open interest greater than the given value. Parameter is ignored when a date is supplied. (provider: intrinio) |
165
- | `oi_lt` | `no` | `integer | null` | `-` | Return options with an open interest less than the given value. Parameter is ignored when a date is supplied. (provider: intrinio) |
166
- | `model` | `no` | `string` | `black_scholes` | enum: black_scholes, bjerk The pricing model to use for options chains data, default is 'black_scholes'. Parameter is ignored when a date is supplied. (provider: intrinio) |
167
- | `show_extended_price` | `no` | `boolean` | `true` | Whether to include OHLC type fields, default is True. Parameter is ignored when a date is supplied. (provider: intrinio) |
168
- | `include_related_symbols` | `no` | `boolean` | `false` | Include related symbols that end in a 1 or 2 because of a corporate action, default is False. (provider: intrinio) |
169
- | `provider` | `yes` | `string` | `-` | enum: cboe, deribit, intrinio, tmx, tradier, yfinance |
224
+ | `use_cache` | `no` | `boolean` | `true` | When True, the company directories will be cached for24 hours and are used to validate symbols. The results of the function are not cached. Set as False to bypass.; Caching is used to validate the supplied ticker symbol, or if a historical EOD chain is requested. To bypass, set to False. |
225
+ | `delay` | `no` | `string` | `eod` | enum: eod, realtime, delayed Whether to return delayed, realtime, or eod data. |
226
+ | `date` | `no` | `string | null` | `-` | The end-of-day date for options chains data.; A specific date to get data for. |
227
+ | `option_type` | `no` | `string | null` | `-` | The option type, call or put, 'None' is both (default). |
228
+ | `moneyness` | `no` | `string` | `all` | enum: otm, itm, all Return only contracts that are in or out of the money, default is 'all'. Parameter is ignored when a date is supplied. |
229
+ | `strike_gt` | `no` | `integer | null` | `-` | Return options with a strike price greater than the given value. Parameter is ignored when a date is supplied. |
230
+ | `strike_lt` | `no` | `integer | null` | `-` | Return options with a strike price less than the given value. Parameter is ignored when a date is supplied. |
231
+ | `volume_gt` | `no` | `integer | null` | `-` | Return options with a volume greater than the given value. Parameter is ignored when a date is supplied. |
232
+ | `volume_lt` | `no` | `integer | null` | `-` | Return options with a volume less than the given value. Parameter is ignored when a date is supplied. |
233
+ | `oi_gt` | `no` | `integer | null` | `-` | Return options with an open interest greater than the given value. Parameter is ignored when a date is supplied. |
234
+ | `oi_lt` | `no` | `integer | null` | `-` | Return options with an open interest less than the given value. Parameter is ignored when a date is supplied. |
235
+ | `model` | `no` | `string` | `black_scholes` | enum: black_scholes, bjerk The pricing model to use for options chains data, default is 'black_scholes'. Parameter is ignored when a date is supplied. |
236
+ | `show_extended_price` | `no` | `boolean` | `true` | Whether to include OHLC type fields, default is True. Parameter is ignored when a date is supplied. |
237
+ | `include_related_symbols` | `no` | `boolean` | `false` | Include related symbols that end in a 1 or 2 because of a corporate action, default is False. |
170
238
 
171
239
  ---
172
240
 
173
241
  ### `derivatives.options.snapshots`
174
242
 
175
243
  ```python
176
- data.derivatives.options.snapshots(date=None, only_traded=True, provider='intrinio')
244
+ data.derivatives.options.snapshots(date=None, only_traded=True)
177
245
  ```
178
246
 
179
247
  Summary: Snapshots
@@ -183,7 +251,6 @@ Summary: Snapshots
183
251
  | Endpoint ID | `derivatives.options.snapshots` |
184
252
  | HTTP | `GET` |
185
253
  | Path | `/inner/v1/agent-data/derivatives/options/snapshots` |
186
- | Default provider | `intrinio` |
187
254
  | SDK | `supported` |
188
255
  | Host | `supported` |
189
256
  | Notes | - |
@@ -192,9 +259,40 @@ Summary: Snapshots
192
259
 
193
260
  | Param | Required | Type | Default | Notes |
194
261
  |---|---|---|---|---|
195
- | `date` | `no` | `string | null` | `-` | The date of the data. Can be a datetime or an ISO datetime string. Data appears to go back to around 2022-06-01 Example: '2024-03-08T12:15:00+0400' (provider: intrinio) |
196
- | `only_traded` | `no` | `boolean` | `true` | Only include options that have been traded during the session, default is True. Setting to false will dramatically increase the size of the response - use with caution. (provider: intrinio) |
197
- | `provider` | `no` | `string` | `intrinio` | - |
262
+ | `date` | `no` | `string | null` | `-` | The date of the data. Can be a datetime or an ISO datetime string. Data appears to go back to around 2022-06-01 Example: '2024-03-08T12:15:00+0400' |
263
+ | `only_traded` | `no` | `boolean` | `true` | Only include options that have been traded during the session, default is True. Setting to false will dramatically increase the size of the response - use with caution. |
264
+
265
+ #### Response fields
266
+
267
+ | Field | Type | Notes |
268
+ |---|---|---|
269
+ | `underlying_symbol` | `array` | Ticker symbol of the underlying asset. |
270
+ | `contract_symbol` | `array` | Symbol of the options contract. |
271
+ | `expiration` | `array` | Expiration date of the options contract. |
272
+ | `dte` | `array` | Number of days to expiration of the options contract. |
273
+ | `strike` | `array` | Strike price of the options contract. |
274
+ | `option_type` | `array` | The type of option. |
275
+ | `volume` | `array` | The trading volume. |
276
+ | `open_interest` | `array` | Open interest at the time. |
277
+ | `last_price` | `array` | Last trade price at the time. |
278
+ | `last_size` | `array` | Lot size of the last trade. |
279
+ | `last_timestamp` | `array` | Timestamp of the last price. |
280
+ | `open` | `array` | The open price. |
281
+ | `high` | `array` | The high price. |
282
+ | `low` | `array` | The low price. |
283
+ | `close` | `array` | The close price. |
284
+ | `bid` | `array` | The last bid price at the time. |
285
+ | `bid_size` | `array` | The size of the last bid price. |
286
+ | `bid_timestamp` | `array` | The timestamp of the last bid price. |
287
+ | `ask` | `array` | The last ask price at the time. |
288
+ | `ask_size` | `array` | The size of the last ask price. |
289
+ | `ask_timestamp` | `array` | The timestamp of the last ask price. |
290
+ | `total_bid_volume` | `array` | Total volume of bids. |
291
+ | `bid_high` | `array` | The highest bid price. |
292
+ | `bid_low` | `array` | The lowest bid price. |
293
+ | `total_ask_volume` | `array` | Total volume of asks. |
294
+ | `ask_high` | `array` | The highest ask price. |
295
+ | `ask_low` | `array` | The lowest ask price. |
198
296
 
199
297
  ---
200
298
 
@@ -211,7 +309,6 @@ Summary: Surface
211
309
  | Endpoint ID | `derivatives.options.surface` |
212
310
  | HTTP | `POST` |
213
311
  | Path | `/inner/v1/agent-data/derivatives/options/surface` |
214
- | Default provider | - |
215
312
  | SDK | `supported` |
216
313
  | Host | `supported` |
217
314
  | Notes | - |
@@ -238,7 +335,7 @@ Summary: Surface
238
335
  ### `derivatives.options.unusual`
239
336
 
240
337
  ```python
241
- data.derivatives.options.unusual(symbol=None, start_time=None, end_time=None, trade_type=None, sentiment=None, min_value=None, max_value=None, limit=100000, source='delayed', provider='intrinio')
338
+ data.derivatives.options.unusual(symbol=None, start_time=None, end_time=None, trade_type=None, sentiment=None, min_value=None, max_value=None, limit=100000, source='delayed')
242
339
  ```
243
340
 
244
341
  Summary: Unusual
@@ -248,7 +345,6 @@ Summary: Unusual
248
345
  | Endpoint ID | `derivatives.options.unusual` |
249
346
  | HTTP | `GET` |
250
347
  | Path | `/inner/v1/agent-data/derivatives/options/unusual` |
251
- | Default provider | `intrinio` |
252
348
  | SDK | `supported` |
253
349
  | Host | `supported` |
254
350
  | Notes | - |
@@ -260,10 +356,25 @@ Summary: Unusual
260
356
  | `symbol` | `no` | `string | null` | `-` | Symbol to get data for. (the underlying symbol) |
261
357
  | `start_time` | `no` | `integer | null` | `-` | Start time of the data as a Unix timestamp in milliseconds. Takes priority over start_date when both are provided. |
262
358
  | `end_time` | `no` | `integer | null` | `-` | End time of the data as a Unix timestamp in milliseconds. Takes priority over end_date when both are provided. |
263
- | `trade_type` | `no` | `string | null` | `-` | The type of unusual activity to query for. (provider: intrinio) |
264
- | `sentiment` | `no` | `string | null` | `-` | The sentiment type to query for. (provider: intrinio) |
265
- | `min_value` | `no` | `integer | number | null` | `-` | The inclusive minimum total value for the unusual activity. (provider: intrinio) |
266
- | `max_value` | `no` | `integer | number | null` | `-` | The inclusive maximum total value for the unusual activity. (provider: intrinio) |
267
- | `limit` | `no` | `integer` | `100000` | The number of data entries to return. A typical day for all symbols will yield 50-80K records. The API will paginate at 1000 records. The high default limit (100K) is to be able to reliably capture the most days. The high absolute limit (1.25M) is to allow for outlier days. Queries at the absolute limit will take a long time, and might be unreliable. Apply filters to improve performance. (provider: intrinio) |
268
- | `source` | `no` | `string` | `delayed` | The source of the data. Either realtime or delayed. (provider: intrinio) |
269
- | `provider` | `no` | `string` | `intrinio` | - |
359
+ | `trade_type` | `no` | `string | null` | `-` | The type of unusual activity to query for. |
360
+ | `sentiment` | `no` | `string | null` | `-` | The sentiment type to query for. |
361
+ | `min_value` | `no` | `integer | number | null` | `-` | The inclusive minimum total value for the unusual activity. |
362
+ | `max_value` | `no` | `integer | number | null` | `-` | The inclusive maximum total value for the unusual activity. |
363
+ | `limit` | `no` | `integer` | `100000` | The number of data entries to return. A typical day for all symbols will yield 50-80K records. The API will paginate at 1000 records. The high default limit (100K) is to be able to reliably capture the most days. The high absolute limit (1.25M) is to allow for outlier days. Queries at the absolute limit will take a long time, and might be unreliable. Apply filters to improve performance. |
364
+ | `source` | `no` | `string` | `delayed` | The source of the data. Either realtime or delayed. |
365
+
366
+ #### Response fields
367
+
368
+ | Field | Type | Notes |
369
+ |---|---|---|
370
+ | `underlying_symbol` | `string` | Symbol representing the entity requested in the data (the underlying symbol). |
371
+ | `contract_symbol` | `string` | Contract symbol for the option. |
372
+ | `trade_timestamp` | `string` | The datetime of order placement. |
373
+ | `trade_type` | `string` | The type of unusual trade. |
374
+ | `sentiment` | `string` | Bullish, Bearish, or Neutral Sentiment estimated based on whether the trade was executed at the bid, ask, or mark price. |
375
+ | `bid_at_execution` | `number` | Bid price at execution. |
376
+ | `ask_at_execution` | `number` | Ask price at execution. |
377
+ | `average_price` | `number` | The average premium paid per option contract. |
378
+ | `underlying_price_at_execution` | `number` | Price of the underlying security at execution of trade. |
379
+ | `total_size` | `integer` | The total number of contracts involved in a single transaction. |
380
+ | `total_value` | `integer` | The aggregated value of all option contract premiums included in the trade. |