agent-finance-cli-linux-arm64 0.2.2 → 0.3.1

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 (12) hide show
  1. package/README.md +2 -2
  2. package/bin/agent-finance +0 -0
  3. package/package.json +5 -5
  4. package/skill-data/core/SKILL.md +70 -37
  5. package/skill-data/core/references/command-map.md +74 -37
  6. package/skill-data/crypto/SKILL.md +30 -33
  7. package/skill-data/history-indicators/SKILL.md +14 -14
  8. package/skill-data/prediction-markets/SKILL.md +6 -7
  9. package/skill-data/price/SKILL.md +13 -13
  10. package/skill-data/profile/SKILL.md +152 -0
  11. package/skill-data/providers/SKILL.md +10 -11
  12. package/skill-data/research-data/SKILL.md +14 -14
package/README.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # agent-finance-cli-linux-arm64
2
2
 
3
- Prebuilt linux/arm64 binary package for `agent-finance-cli`.
3
+ Prebuilt linux/arm64 binary package for `agent-finance`.
4
4
 
5
- Install the main package instead:
5
+ Install the main npm package instead:
6
6
 
7
7
  ```bash
8
8
  npm install -g agent-finance-cli
package/bin/agent-finance CHANGED
Binary file
package/package.json CHANGED
@@ -1,15 +1,15 @@
1
1
  {
2
2
  "name": "agent-finance-cli-linux-arm64",
3
- "version": "0.2.2",
4
- "description": "Prebuilt linux/arm64 binary for agent-finance-cli.",
3
+ "version": "0.3.1",
4
+ "description": "Prebuilt linux/arm64 binary for agent-finance.",
5
5
  "license": "MIT OR Apache-2.0",
6
6
  "repository": {
7
7
  "type": "git",
8
- "url": "git+https://github.com/M4n5ter/agent-finance-cli.git"
8
+ "url": "git+https://github.com/M4n5ter/agent-finance.git"
9
9
  },
10
- "homepage": "https://github.com/M4n5ter/agent-finance-cli#readme",
10
+ "homepage": "https://github.com/M4n5ter/agent-finance#readme",
11
11
  "bugs": {
12
- "url": "https://github.com/M4n5ter/agent-finance-cli/issues"
12
+ "url": "https://github.com/M4n5ter/agent-finance/issues"
13
13
  },
14
14
  "os": [
15
15
  "linux"
package/skill-data/core/SKILL.md CHANGED
@@ -1,87 +1,120 @@
1
1
  ---
2
2
  name: core
3
- description: Entry guide for agent-finance price, sessions, crypto, history, research data, provider coverage, prediction markets, proxy context, and safe source handling. Read this before using agent-finance commands.
3
+ description: Entry guide for agent-finance market price, sessions, crypto, history, research data, provider coverage, prediction markets, proxy context, and safe source handling. Read this before using agent-finance commands.
4
4
  ---
5
5
 
6
6
  # agent-finance core skill
7
7
 
8
- This skill is printed by the `agent-finance` CLI. It is the first thing an AI Agent should read before using the tool.
8
+ This is the runtime entry guide for using `agent-finance`.
9
9
 
10
- ## Start Here
10
+ ## Start
11
11
 
12
12
  ```bash
13
13
  agent-finance skills list
14
- agent-finance skills get core --full
15
- agent-finance providers
14
+ agent-finance market providers
15
+ agent-finance capabilities
16
+ ```
17
+
18
+ ## Task Router
19
+
20
+ ```bash
21
+ agent-finance skills get price
22
+ agent-finance skills get history-indicators
23
+ agent-finance skills get research-data
16
24
  agent-finance skills get crypto
25
+ agent-finance skills get prediction-markets
26
+ agent-finance skills get providers
27
+ agent-finance skills get profile
17
28
  ```
18
29
 
19
- ## Default Workflow
30
+ Load a narrow skill before task-specific commands. Use `skills get core --full` when you need the extended command map.
31
+
32
+ ## Default Evidence Flow
20
33
 
21
34
  1. Current observable price:
22
35
 
23
36
  ```bash
24
- agent-finance price CRDO
25
- agent-finance price CRDO --json
37
+ agent-finance market price CRDO
38
+ agent-finance market price CRDO --json
26
39
  ```
27
40
 
28
41
  2. Precise session/provider split:
29
42
 
30
43
  ```bash
31
- agent-finance sessions CRDO
32
- agent-finance sessions LITE --proxy-symbol LITEUSDT
44
+ agent-finance market sessions CRDO
45
+ agent-finance market sessions LITE --proxy-symbol LITEUSDT
33
46
  ```
34
47
 
35
48
  3. History before a trading or order-quality conclusion:
36
49
 
37
50
  ```bash
38
- agent-finance history LITE --interval 1d --range 1mo --adjustment auto --limit 30
39
- agent-finance history LITE --interval 1m --range 5d --session extended --adjustment raw --no-actions --limit 120
51
+ agent-finance market history LITE --interval 1d --range 1mo --adjustment auto --limit 30
52
+ agent-finance market history LITE --interval 1m --range 5d --session extended --adjustment raw --no-actions --limit 120
40
53
  ```
41
54
 
42
- 4. Research data:
55
+ 4. Research and source context:
43
56
 
44
57
  ```bash
45
- agent-finance fundamentals CRDO
46
- agent-finance fundamentals CRDO --provider sec-edgar
47
- agent-finance analysis CRDO
48
- agent-finance options CRDO
49
- agent-finance ownership CRDO
50
- agent-finance events CRDO --provider sec-edgar
51
- agent-finance news CRDO
52
- agent-finance read-url "https://www.sec.gov/Archives/edgar/data/0001807794/000162828026014017/crdo-20260131.htm"
53
- agent-finance search "optical interconnect"
54
- agent-finance screen day_gainers
58
+ agent-finance market fundamentals CRDO
59
+ agent-finance market fundamentals CRDO --provider sec-edgar
60
+ agent-finance market analysis CRDO
61
+ agent-finance market options CRDO
62
+ agent-finance market ownership CRDO
63
+ agent-finance market events CRDO --provider sec-edgar
64
+ agent-finance market news CRDO
65
+ agent-finance market read-url "https://www.sec.gov/Archives/edgar/data/0001807794/000162828026014017/crdo-20260131.htm"
66
+ agent-finance market search "optical interconnect"
67
+ agent-finance market screen day_gainers
55
68
  ```
56
69
 
57
70
  5. Prediction-market sentiment:
58
71
 
59
72
  ```bash
60
- agent-finance polymarket search "spacex ipo" --limit 5
61
- agent-finance polymarket market MARKET_ID_OR_SLUG
73
+ agent-finance market polymarket search "spacex ipo" --limit 5
74
+ agent-finance market polymarket market MARKET_ID_OR_SLUG
62
75
  agent-finance skills get prediction-markets
63
76
  ```
64
77
 
65
78
  6. Crypto market data:
66
79
 
67
80
  ```bash
68
- agent-finance crypto snapshot BTC/USDT
69
- agent-finance crypto sentiment BTCUSDT
70
- agent-finance price BTC/USDT --asset crypto
71
- agent-finance history BTC/USDT --asset crypto --interval 1h --limit 48
72
- agent-finance crypto quote BTC/USDT
73
- agent-finance crypto book BTC/USDT --provider okx --limit 20
74
- agent-finance crypto discover --provider coingecko --kind trending
81
+ agent-finance market crypto snapshot BTC/USDT
82
+ agent-finance market crypto sentiment BTCUSDT
83
+ agent-finance market price BTC/USDT --asset crypto
84
+ agent-finance market history BTC/USDT --asset crypto --interval 1h --limit 48
85
+ agent-finance market crypto quote BTC/USDT
86
+ agent-finance market crypto book BTC/USDT --provider okx --limit 20
87
+ agent-finance market crypto discover --provider coingecko --kind trending
88
+ ```
89
+
90
+ 7. Signed Binance workflows:
91
+
92
+ ```bash
93
+ agent-finance skills get profile
94
+ agent-finance account permissions --profile default --json
95
+ agent-finance account balances --profile default --json
96
+ agent-finance account positions --profile default --json
97
+ agent-finance risk explain --profile default
98
+ agent-finance order submit INTENT_ID --profile default
99
+ agent-finance order query BTCUSDT --profile default --market spot --client-order-id CLIENT_ORDER_ID --json
100
+ agent-finance order open --profile default --market spot --symbol BTCUSDT --json
101
+ agent-finance transfer history --profile live --direction spot-to-usds-futures --size 20 --json
102
+ agent-finance state create --profile default --kind leverage --symbol BTCUSDT --leverage 2
103
+ agent-finance state create --profile default --kind position-mode --position-mode hedge
104
+ agent-finance state submit INTENT_ID --profile default
105
+ agent-finance audit export --json
75
106
  ```
76
107
 
77
- ## Rules
108
+ ## Decision Rules
78
109
 
79
- - Use `price` for the default "what is the current price?" answer.
80
- - Use `sessions` when premarket, postmarket, overnight, BOATS, provider differences, or proxy prices matter.
110
+ - Use `market price` for the default "what is the current price?" answer.
111
+ - Use `market sessions` when premarket, postmarket, overnight, BOATS, provider differences, or proxy prices matter.
81
112
  - Use both daily and minute history before judging fills, limit-order quality, stop placement, or intraday action.
82
- - Use `providers --json` when an Agent needs a machine-readable capability matrix.
113
+ - Use `market providers --json` when an Agent needs a machine-readable capability matrix.
114
+ - Use `capabilities --json` for the unified terminal surface, including account/order/transfer/futures-state safety boundaries.
83
115
  - Treat crypto as 24/7 market data. Use Binance/Coinbase/OKX/CoinGecko through capability-first crypto commands, then force providers only for cross-checking.
84
116
  - Spot is crypto spot; USD-M futures / TradFi perps are derivatives and proxy instruments.
85
117
  - Treat Polymarket as quantifiable prediction-market sentiment and event-probability evidence only; it is not an equity quote or primary-source fact.
86
- - `read-url` is a text extraction fallback, not a real browser. For dynamic, login-gated, screenshot-sensitive, or noisy pages, use an available browser tool such as agent-browser or opencli.
118
+ - `market read-url` is a text extraction fallback, not a real browser. For dynamic, login-gated, screenshot-sensitive, or noisy pages, use an available browser tool such as agent-browser or opencli.
87
119
  - JSON output preserves structured fields for downstream computation. Human output is for quick inspection.
120
+ - Use `skills get profile` before touching signed account, order, transfer, futures state, risk, or audit commands.
package/skill-data/core/references/command-map.md CHANGED
@@ -18,21 +18,21 @@ agent-finance skills get history-indicators
18
18
  ## Price and Sessions
19
19
 
20
20
  ```bash
21
- agent-finance price CRDO
22
- agent-finance price CRDO MRVL --json
23
- agent-finance sessions CRDO
24
- agent-finance sessions LITE --proxy-symbol LITEUSDT
21
+ agent-finance market price CRDO
22
+ agent-finance market price CRDO MRVL --json
23
+ agent-finance market sessions CRDO
24
+ agent-finance market sessions LITE --proxy-symbol LITEUSDT
25
25
  ```
26
26
 
27
- `price` answers the default current-price question. `sessions` compares regular/pre/post/overnight/provider/proxy sources.
27
+ `market price` answers the default current-price question. `market sessions` compares regular/pre/post/overnight/provider/proxy sources.
28
28
 
29
29
  ## History and Indicators
30
30
 
31
31
  ```bash
32
- agent-finance history CRDO --range 1mo --interval 1d
33
- agent-finance history CRDO --range 5d --interval 1m --session extended --adjustment raw --no-actions
34
- agent-finance history CRDO --range 1y --interval 1d --adjustment auto --repair
35
- agent-finance indicators CRDO MRVL --limit 120
32
+ agent-finance market history CRDO --range 1mo --interval 1d
33
+ agent-finance market history CRDO --range 5d --interval 1m --session extended --adjustment raw --no-actions
34
+ agent-finance market history CRDO --range 1y --interval 1d --adjustment auto --repair
35
+ agent-finance market indicators CRDO MRVL --limit 120
36
36
  ```
37
37
 
38
38
  Use history before making order, fill, stop-loss, take-profit, or intraday trend judgments. Indicators are summaries; they do not replace the bar path.
@@ -40,19 +40,19 @@ Use history before making order, fill, stop-loss, take-profit, or intraday trend
40
40
  ## Research Data
41
41
 
42
42
  ```bash
43
- agent-finance fundamentals CRDO
44
- agent-finance fundamentals CRDO --provider sec-edgar
45
- agent-finance fundamentals CRDO --provider robinhood
46
- agent-finance fundamentals CRDO --provider cnbc
47
- agent-finance analysis CRDO
48
- agent-finance options CRDO
49
- agent-finance options CRDO --provider robinhood --count 80
50
- agent-finance ownership CRDO
51
- agent-finance events CRDO --provider sec-edgar
52
- agent-finance news CRDO
53
- agent-finance read-url "https://www.sec.gov/Archives/edgar/data/0001807794/000162828026014017/crdo-20260131.htm"
54
- agent-finance search "optical interconnect"
55
- agent-finance screen day_gainers
43
+ agent-finance market fundamentals CRDO
44
+ agent-finance market fundamentals CRDO --provider sec-edgar
45
+ agent-finance market fundamentals CRDO --provider robinhood
46
+ agent-finance market fundamentals CRDO --provider cnbc
47
+ agent-finance market analysis CRDO
48
+ agent-finance market options CRDO
49
+ agent-finance market options CRDO --provider robinhood --count 80
50
+ agent-finance market ownership CRDO
51
+ agent-finance market events CRDO --provider sec-edgar
52
+ agent-finance market news CRDO
53
+ agent-finance market read-url "https://www.sec.gov/Archives/edgar/data/0001807794/000162828026014017/crdo-20260131.htm"
54
+ agent-finance market search "optical interconnect"
55
+ agent-finance market screen day_gainers
56
56
  ```
57
57
 
58
58
  Research reports include sources, modules, coverage gaps, highlights, and raw payloads in JSON mode.
@@ -60,33 +60,70 @@ Research reports include sources, modules, coverage gaps, highlights, and raw pa
60
60
  ## Providers and Proxy Data
61
61
 
62
62
  ```bash
63
- agent-finance providers
64
- agent-finance providers --json
65
- agent-finance crypto snapshot BTC/USDT
66
- agent-finance crypto sentiment BTCUSDT
67
- agent-finance price BTC/USDT --asset crypto
68
- agent-finance crypto quote BTC/USDT
69
- agent-finance crypto candles BTC/USDT --provider coingecko --interval 1d --limit 30
70
- agent-finance crypto discover --provider okx --kind instruments --instrument swap
63
+ agent-finance market providers
64
+ agent-finance market providers --json
65
+ agent-finance market crypto snapshot BTC/USDT
66
+ agent-finance market crypto sentiment BTCUSDT
67
+ agent-finance market price BTC/USDT --asset crypto
68
+ agent-finance market crypto quote BTC/USDT
69
+ agent-finance market crypto candles BTC/USDT --provider coingecko --interval 1d --limit 30
70
+ agent-finance market crypto discover --provider okx --kind instruments --instrument swap
71
71
  ```
72
72
 
73
- Use `providers` as the source-of-truth coverage matrix. Crypto commands are capability-first across Binance/Coinbase/OKX/CoinGecko; USD-M futures / TradFi perps are derivative/proxy prices, not legal equity or broker-fill prices.
73
+ Use `market providers` as the source-of-truth coverage matrix. Crypto commands are capability-first across Binance/Coinbase/OKX/CoinGecko; USD-M futures / TradFi perps are derivative/proxy prices, not legal equity or broker-fill prices.
74
74
 
75
75
  ## Prediction Markets
76
76
 
77
77
  ```bash
78
- agent-finance polymarket search "spacex ipo" --limit 5
79
- agent-finance polymarket search "spcex" --limit 5
80
- agent-finance polymarket market MARKET_ID_OR_SLUG --json
78
+ agent-finance market polymarket search "spacex ipo" --limit 5
79
+ agent-finance market polymarket search "spcex" --limit 5
80
+ agent-finance market polymarket market MARKET_ID_OR_SLUG --json
81
81
  agent-finance skills get prediction-markets
82
82
  ```
83
83
 
84
84
  Use Polymarket for quantifiable sentiment and event-probability signals. It does not replace SEC/IR/company releases, verified news, or equity quotes.
85
85
 
86
+ ## Signed Profile, Risk, and Audit
87
+
88
+ ```bash
89
+ agent-finance skills get profile
90
+ agent-finance profile doctor --profile default
91
+ agent-finance account permissions --profile default --json
92
+ agent-finance account balances --profile default --json
93
+ agent-finance account positions --profile default --json
94
+ agent-finance risk explain --profile default
95
+ agent-finance risk check INTENT_ID --profile default --live
96
+ agent-finance order query BTCUSDT --profile default --market spot --client-order-id CLIENT_ORDER_ID --json
97
+ agent-finance order open --profile default --market spot --symbol BTCUSDT --json
98
+ agent-finance state create --profile default --kind leverage --symbol BTCUSDT --leverage 2
99
+ agent-finance state create --profile default --kind margin-type --symbol BTCUSDT --margin-type isolated
100
+ agent-finance state create --profile default --kind position-mode --position-mode hedge
101
+ agent-finance state submit INTENT_ID --profile default
102
+ agent-finance audit tail --limit 20
103
+ agent-finance audit export --json
104
+ agent-finance transfer history --profile live --direction spot-to-usds-futures --size 20 --json
105
+ ```
106
+
107
+ Use `profile doctor` to inspect profile `[permissions]`, risk-policy consistency, Binance API key restrictions, and provider permissions before live writes. Use `risk explain` to inspect profile limits and the local audit-backed daily order notional counter before live writes.
108
+ Signed read JSON commands return a typed `SignedReadSnapshot` envelope. The typed request scope is under `request`; provider-native data is under `payload`.
109
+
110
+ | Command | `kind` | Common payload path |
111
+ | --- | --- | --- |
112
+ | `account permissions` | `api-permissions` | `payload` |
113
+ | `account balances` | `spot-balances` | `payload.balances` |
114
+ | `account positions` | `usds-futures-positions` | `payload.assets`, `payload.positions` |
115
+ | `order query` | `order-query` | `payload` |
116
+ | `order open` | `open-orders` | `payload` |
117
+ | `transfer history` | `transfer-history` | `payload.rows` |
118
+
119
+ Signed submit JSON commands return a typed `SubmitSnapshot` envelope. Branch on `intent_kind`, `mode`, and `execution.kind`; read dry-run plans or exchange-native execution details from `execution.payload`.
120
+
121
+ Order test/live submit checks locally checkable Binance exchangeInfo filters before sending the order; market-order notional is reported as not locally checked because the exchange execution price is unknown before submit. Live market orders are blocked until risk notional can be derived from fresh exchange data instead of user-supplied `valuation_price`. Dry-run remains offline and prints the exchangeInfo request for later verification.
122
+ USD-M futures leverage, margin type, and Binance futures account position mode changes use separate `state` intents and require explicit `risk.allowed_futures_state_changes` policy before live submit. Position mode policy is not in the default profile template; add an explicit `kind = "position-mode"` entry with the intended `mode`. Position mode changes every symbol; Binance UM/CM share `dualSidePosition`, and the exchange rejects the change when either side has open orders or open positions.
123
+ Transfer history reads Binance SAPI live account data and requires a reviewed live profile.
124
+
86
125
  ## Network and Browser Boundaries
87
126
 
88
127
  The CLI respects `--proxy`, `AGENT_FINANCE_PROXY`, and standard proxy environment variables. It does not hardcode a local proxy.
89
128
 
90
- Polymarket uses the official SDK by default. When `--proxy` or `--no-proxy` is explicit, it uses public REST fallback through the CLI HTTP stack so those network controls are honored.
91
-
92
- `read-url` is a text extraction fallback. For dynamic, login-gated, screenshot-sensitive, or noisy pages, open the original page with an available real browser tool such as agent-browser or opencli.
129
+ `market read-url` is a text extraction fallback. For dynamic, login-gated, screenshot-sensitive, or noisy pages, open the original page with an available real browser tool such as agent-browser or opencli.
package/skill-data/crypto/SKILL.md CHANGED
@@ -3,20 +3,20 @@ name: crypto
3
3
  description: Use capability-first crypto market data across Binance, Coinbase, OKX, and CoinGecko for spot, swap, futures, quotes, order books, trades, candles, funding, open interest, and sentiment.
4
4
  ---
5
5
 
6
- # agent-finance crypto skill
6
+ # agent-finance market crypto skill
7
7
 
8
8
  Use this when crypto markets, Binance/Coinbase/OKX/CoinGecko spot data, Binance/OKX derivatives data, funding, open interest, long/short ratios, taker flow, basis, or 24/7 crypto price discovery matter.
9
9
 
10
10
  ## Start
11
11
 
12
12
  ```bash
13
- agent-finance crypto snapshot BTC/USDT
14
- agent-finance crypto sentiment BTCUSDT
15
- agent-finance price BTC/USDT --asset crypto
16
- agent-finance history BTC/USDT --asset crypto --interval 1h --limit 48
17
- agent-finance crypto quote BTC/USDT
18
- agent-finance crypto book BTC/USDT --limit 20
19
- agent-finance crypto candles BTC/USDT --interval 1h --limit 48
13
+ agent-finance market crypto snapshot BTC/USDT
14
+ agent-finance market crypto sentiment BTCUSDT
15
+ agent-finance market price BTC/USDT --asset crypto
16
+ agent-finance market history BTC/USDT --asset crypto --interval 1h --limit 48
17
+ agent-finance market crypto quote BTC/USDT
18
+ agent-finance market crypto book BTC/USDT --limit 20
19
+ agent-finance market crypto candles BTC/USDT --interval 1h --limit 48
20
20
  ```
21
21
 
22
22
  ## Cross-Provider Evidence
@@ -24,17 +24,17 @@ agent-finance crypto candles BTC/USDT --interval 1h --limit 48
24
24
  Prefer these capability-first commands before forcing provider-specific deep endpoints:
25
25
 
26
26
  ```bash
27
- agent-finance crypto quote BTC/USDT
28
- agent-finance crypto quote BTC-USD --provider coinbase
29
- agent-finance crypto book BTC/USDT --provider okx --limit 20
30
- agent-finance crypto trades BTC/USDT --limit 20
31
- agent-finance crypto candles BTC/USDT --provider coingecko --interval 1d --limit 30
32
- agent-finance crypto funding BTCUSDT --provider auto --instrument swap --limit 8
33
- agent-finance crypto open-interest BTCUSDT --provider okx --instrument swap
34
- agent-finance crypto discover --provider coingecko --kind trending
35
- agent-finance crypto discover --provider coingecko --kind global
36
- agent-finance crypto discover --provider okx --kind instruments --instrument swap
37
- agent-finance crypto discover --provider coinbase --kind volume-summary
27
+ agent-finance market crypto quote BTC/USDT
28
+ agent-finance market crypto quote BTC-USD --provider coinbase
29
+ agent-finance market crypto book BTC/USDT --provider okx --limit 20
30
+ agent-finance market crypto trades BTC/USDT --limit 20
31
+ agent-finance market crypto candles BTC/USDT --provider coingecko --interval 1d --limit 30
32
+ agent-finance market crypto funding BTCUSDT --provider auto --instrument swap --limit 8
33
+ agent-finance market crypto open-interest BTCUSDT --provider okx --instrument swap
34
+ agent-finance market crypto discover --provider coingecko --kind trending
35
+ agent-finance market crypto discover --provider coingecko --kind global
36
+ agent-finance market crypto discover --provider okx --kind instruments --instrument swap
37
+ agent-finance market crypto discover --provider coinbase --kind volume-summary
38
38
  ```
39
39
 
40
40
  `--provider auto` only queries providers that support the requested capability and instrument. Force `--provider` when auditing a specific provider.
@@ -42,13 +42,13 @@ agent-finance crypto discover --provider coinbase --kind volume-summary
42
42
  ## Instruments
43
43
 
44
44
  ```bash
45
- agent-finance crypto quote BTC/USDT --instrument spot
46
- agent-finance crypto book BTC/USDT --instrument spot --limit 20
47
- agent-finance crypto candles BTC/USDT --instrument spot --interval 1m --limit 60
48
- agent-finance crypto funding BTCUSDT --instrument swap --limit 8
49
- agent-finance crypto open-interest BTCUSDT --instrument swap
50
- agent-finance crypto stream BTCUSDT --kind trade --messages 1
51
- agent-finance crypto stream BTCUSDT --instrument swap --kind mark-price --messages 1
45
+ agent-finance market crypto quote BTC/USDT --instrument spot
46
+ agent-finance market crypto book BTC/USDT --instrument spot --limit 20
47
+ agent-finance market crypto candles BTC/USDT --instrument spot --interval 1m --limit 60
48
+ agent-finance market crypto funding BTCUSDT --instrument swap --limit 8
49
+ agent-finance market crypto open-interest BTCUSDT --instrument swap
50
+ agent-finance market crypto stream BTCUSDT --kind trade --messages 1
51
+ agent-finance market crypto stream BTCUSDT --instrument swap --kind mark-price --messages 1
52
52
  ```
53
53
 
54
54
  ## Rules
@@ -56,13 +56,10 @@ agent-finance crypto stream BTCUSDT --instrument swap --kind mark-price --messag
56
56
  - Use capability-first crypto commands for all normal work; provider eligibility is determined by capability plus `--instrument`.
57
57
  - Binance, Coinbase, OKX, and CoinGecko are tier-1 no-key crypto providers in this CLI, but they answer different questions.
58
58
  - Binance/OKX are stronger for exchange microstructure and derivatives evidence. Coinbase is a spot exchange cross-check. CoinGecko is stronger for aggregate breadth, trending, metadata, and exchange discovery.
59
- - Binance integration uses self-maintained clients for official public REST and WebSocket paths; do not add the generated Binance SDK unless a future version proves cleaner than these local abstractions.
60
- - Spot WebSocket uses Binance's market-data-only `data-stream.binance.vision` endpoint because this CLI only needs public market data.
61
- - USD-M Futures WebSocket routes streams through Binance's current `/market/ws` and `/public/ws` paths; do not route futures streams through the legacy root `/ws` path.
62
- - Prefer `crypto snapshot` for current observable market state.
63
- - Prefer `crypto sentiment` for futures leverage, funding, open interest, long/short, taker flow, and basis.
64
- - Prefer `crypto quote/book/trades/candles/funding/open-interest/discover --json` when an Agent needs provider evidence for reasoning.
59
+ - Prefer `market crypto snapshot` for current observable market state.
60
+ - Prefer `market crypto sentiment` for futures leverage, funding, open interest, long/short, taker flow, and basis.
61
+ - Prefer `market crypto quote/book/trades/candles/funding/open-interest/discover --json` when an Agent needs provider evidence for reasoning.
65
62
  - Use `--json` for downstream computation and `--raw` when auditing provider payloads.
66
- - `BINANCE_API_KEY` is only for read-only market-data endpoints. This CLI must not read Binance secrets, sign requests, or use account/trading endpoints.
63
+ - The `market crypto` command surface is read-only market data. Signed Binance account/order/transfer/futures-state workflows live under `account`, `order`, `transfer`, `state`, `risk`, `audit`, and the `profile` skill.
67
64
  - Crypto trades 24/7; do not apply equity regular/pre/post/overnight session assumptions.
68
65
  - USD-M futures and TradFi perps are derivatives. They are useful for price discovery and sentiment, not legal equity or broker-fill prices.
package/skill-data/history-indicators/SKILL.md CHANGED
@@ -3,20 +3,20 @@ name: history-indicators
3
3
  description: Fetch OHLCV history and local indicators with agent-finance, including equity and crypto intervals, sessions, adjustment modes, repair behavior, and indicator interpretation rules.
4
4
  ---
5
5
 
6
- # agent-finance history and indicators skill
6
+ # agent-finance market history and indicators skill
7
7
 
8
8
  ## History
9
9
 
10
10
  ```bash
11
- agent-finance history LITE --provider auto --interval 1d --range 1mo --limit 30
12
- agent-finance history LITE --interval 1m --range 5d --session extended --adjustment raw --no-actions --limit 200
13
- agent-finance history LITE --interval 1d --range 1y --adjustment auto --repair --limit 252
14
- agent-finance history AAPL --provider robinhood --interval 5m --range 1d --session extended --limit 80
15
- agent-finance history BTC/USDT --asset crypto --crypto-provider auto --interval 1h --limit 48
16
- agent-finance history BTC/USDT --asset crypto --crypto-provider coinbase --interval 1h --limit 48
17
- agent-finance history BTC/USDT --asset crypto --crypto-provider okx --interval 1h --limit 48
18
- agent-finance history BTC/USDT --asset crypto --crypto-provider coingecko --interval 1d --limit 30
19
- agent-finance history BTCUSDT --asset crypto --crypto-provider binance --instrument swap --interval 1d --limit 30
11
+ agent-finance market history LITE --provider auto --interval 1d --range 1mo --limit 30
12
+ agent-finance market history LITE --interval 1m --range 5d --session extended --adjustment raw --no-actions --limit 200
13
+ agent-finance market history LITE --interval 1d --range 1y --adjustment auto --repair --limit 252
14
+ agent-finance market history AAPL --provider robinhood --interval 5m --range 1d --session extended --limit 80
15
+ agent-finance market history BTC/USDT --asset crypto --crypto-provider auto --interval 1h --limit 48
16
+ agent-finance market history BTC/USDT --asset crypto --crypto-provider coinbase --interval 1h --limit 48
17
+ agent-finance market history BTC/USDT --asset crypto --crypto-provider okx --interval 1h --limit 48
18
+ agent-finance market history BTC/USDT --asset crypto --crypto-provider coingecko --interval 1d --limit 30
19
+ agent-finance market history BTCUSDT --asset crypto --crypto-provider binance --instrument swap --interval 1d --limit 30
20
20
  ```
21
21
 
22
22
  ## Intervals
@@ -33,8 +33,8 @@ agent-finance history BTCUSDT --asset crypto --crypto-provider binance --instrum
33
33
  When unsure:
34
34
 
35
35
  ```bash
36
- agent-finance history --help
37
- agent-finance stooq sync --help
36
+ agent-finance market history --help
37
+ agent-finance market stooq sync --help
38
38
  ```
39
39
 
40
40
  ## Adjustments
@@ -47,8 +47,8 @@ agent-finance stooq sync --help
47
47
  ## Indicators
48
48
 
49
49
  ```bash
50
- agent-finance indicators LITE AAOI --provider auto --limit 120
51
- agent-finance indicators CRDO MRVL --session extended --interval 1m --range 5d --limit 200
50
+ agent-finance market indicators LITE AAOI --provider auto --limit 120
51
+ agent-finance market indicators CRDO MRVL --session extended --interval 1m --range 5d --limit 200
52
52
  ```
53
53
 
54
54
  Indicators are summaries. For fill quality, limit-order decisions, or intraday exits, inspect daily and minute bars directly.
package/skill-data/prediction-markets/SKILL.md CHANGED
@@ -10,10 +10,10 @@ Use this skill when an AI Agent needs prediction-market sentiment, event probabi
10
10
  ## Commands
11
11
 
12
12
  ```bash
13
- agent-finance polymarket search "spacex ipo" --limit 5
14
- agent-finance polymarket search "spcex" --limit 5
15
- agent-finance polymarket market MARKET_ID_OR_SLUG
16
- agent-finance polymarket market MARKET_ID_OR_SLUG --json
13
+ agent-finance market polymarket search "spacex ipo" --limit 5
14
+ agent-finance market polymarket search "spcex" --limit 5
15
+ agent-finance market polymarket market MARKET_ID_OR_SLUG
16
+ agent-finance market polymarket market MARKET_ID_OR_SLUG --json
17
17
  ```
18
18
 
19
19
  ## Search Semantics
@@ -34,8 +34,8 @@ agent-finance polymarket market MARKET_ID_OR_SLUG --json
34
34
  ## Useful Flags
35
35
 
36
36
  ```bash
37
- agent-finance polymarket search "spacex ipo" --include-closed --min-volume 1000 --json
38
- agent-finance polymarket market MARKET_ID_OR_SLUG --limit 20 --refresh
37
+ agent-finance market polymarket search "spacex ipo" --include-closed --min-volume 1000 --json
38
+ agent-finance market polymarket market MARKET_ID_OR_SLUG --limit 20 --refresh
39
39
  ```
40
40
 
41
41
  - `--include-closed`: include resolved/closed markets for historical expectation checks.
@@ -48,5 +48,4 @@ agent-finance polymarket market MARKET_ID_OR_SLUG --limit 20 --refresh
48
48
 
49
49
  - This CLI is read-only for Polymarket.
50
50
  - It does not accept private keys, derive API keys, place orders, cancel orders, or manage Polymarket positions.
51
- - Default transport uses the official SDK. Explicit `--proxy` or `--no-proxy` uses public REST fallback through the CLI HTTP stack so those network controls are honored.
52
51
  - Holder data is reported as preview rows returned by the API limit, not as a total holder count.
package/skill-data/price/SKILL.md CHANGED
@@ -3,26 +3,26 @@ name: price
3
3
  description: Fetch current price summaries, regular-market basis, premarket, postmarket, overnight sessions, crypto prices, proxy symbols, streams, and watch output with agent-finance.
4
4
  ---
5
5
 
6
- # agent-finance price skill
6
+ # agent-finance market price skill
7
7
 
8
8
  ## Default Price
9
9
 
10
- Use `price` to answer "what is it trading at now?":
10
+ Use `market price` to answer "what is it trading at now?":
11
11
 
12
12
  ```bash
13
- agent-finance price CRDO
14
- agent-finance price CRDO --json
13
+ agent-finance market price CRDO
14
+ agent-finance market price CRDO --json
15
15
  ```
16
16
 
17
17
  The default output includes current observable price, session, provider, local timestamp, UTC fields in JSON, change from regular-market previous close, and regular-market open/high/low/volume when available.
18
18
 
19
19
  ## Session Split
20
20
 
21
- Use `sessions` when the task asks about premarket, postmarket, overnight, BOATS, platform 24h prices, or provider disagreement:
21
+ Use `market sessions` when the task asks about premarket, postmarket, overnight, BOATS, platform 24h prices, or provider disagreement:
22
22
 
23
23
  ```bash
24
- agent-finance sessions CRDO
25
- agent-finance sessions LITE --proxy-symbol LITEUSDT
24
+ agent-finance market sessions CRDO
25
+ agent-finance market sessions LITE --proxy-symbol LITEUSDT
26
26
  ```
27
27
 
28
28
  ## Crypto And Proxy Context
@@ -30,15 +30,15 @@ agent-finance sessions LITE --proxy-symbol LITEUSDT
30
30
  Use the crypto market domain for actual crypto symbols:
31
31
 
32
32
  ```bash
33
- agent-finance price BTC/USDT --asset crypto
34
- agent-finance price BTCUSDT --asset crypto --instrument spot
35
- agent-finance price BTCUSDT --asset crypto --instrument swap
33
+ agent-finance market price BTC/USDT --asset crypto
34
+ agent-finance market price BTCUSDT --asset crypto --instrument spot
35
+ agent-finance market price BTCUSDT --asset crypto --instrument swap
36
36
  ```
37
37
 
38
38
  If an equity or pre-IPO name has a relevant 24/7 derivative or proxy contract, add it only as side context:
39
39
 
40
40
  ```bash
41
- agent-finance sessions SPCX --proxy-symbol SPCXUSDT
41
+ agent-finance market sessions SPCX --proxy-symbol SPCXUSDT
42
42
  ```
43
43
 
44
44
  Proxy symbols are price-discovery and sentiment signals. They are not the legal equity, pre-IPO ownership, or broker-fill price.
@@ -46,8 +46,8 @@ Proxy symbols are price-discovery and sentiment signals. They are not the legal
46
46
  ## Streaming
47
47
 
48
48
  ```bash
49
- agent-finance stream CRDO --messages 5
50
- agent-finance watch CRDO --interval-seconds 15 --iterations 4
49
+ agent-finance market stream CRDO --messages 5
50
+ agent-finance market watch CRDO --interval-seconds 15 --iterations 4
51
51
  ```
52
52
 
53
53
  Use `watch` when WebSocket streaming is blocked by the local network.
package/skill-data/profile/SKILL.md ADDED
@@ -0,0 +1,152 @@
1
+ ---
2
+ name: profile
3
+ description: Configure agent-finance trading profiles, Binance HMAC env references, risk policy, intent-first live writes, audit logs, and safe AI Agent workflows.
4
+ ---
5
+
6
+ # agent-finance profile skill
7
+
8
+ Use this skill before any `account`, `order`, `transfer`, `risk`, or `audit` command.
9
+ Also use it before USD-M futures `state` changes.
10
+
11
+ ## Model
12
+
13
+ - A profile is a TOML file in the user config directory.
14
+ - The profile stores environment variable names for Binance HMAC keys, not secrets.
15
+ - The default HMAC secret env is `BINANCE_PRIVATE_KEY`; in Binance HMAC mode this is the API Secret string, not an RSA or Ed25519 private key.
16
+ - Live writes require all of these: profile `allow_live = true`, matching `[permissions]` declarations, the relevant order/transfer/futures-state whitelist, matching Binance API key permissions, intent id, and `--live`.
17
+ - Live market orders are blocked until risk notional can be derived from fresh exchange data instead of user-supplied `valuation_price`.
18
+ - USD-M futures leverage, margin type, and Binance futures account position mode changes require explicit `risk.allowed_futures_state_changes` policy and use separate `state` intents.
19
+ - Binance position mode changes every symbol; UM/CM share `dualSidePosition`, and Binance rejects the change when either side has open orders or open positions.
20
+ - Order, cancel, transfer, and futures state writes are intent-first. Create the intent, inspect it, run `risk check`, then submit.
21
+ - Audit logging is append-only JSONL in the user data directory.
22
+
23
+ ## Profile Permissions
24
+
25
+ `[permissions]` declares what this profile is allowed to attempt before API-key probing:
26
+
27
+ ```toml
28
+ [permissions]
29
+ spot_trading = true
30
+ usds_futures = true
31
+ universal_transfer = false
32
+ ```
33
+
34
+ - `spot_trading`: required for Spot order and cancel intents.
35
+ - `usds_futures`: required for USD-M order/cancel intents and futures state changes.
36
+ - `universal_transfer`: required for Spot `<->` USD-M internal transfers.
37
+ - `profile doctor` reports both profile/risk consistency and live Binance API-key permission checks when HMAC env vars are set.
38
+ - `risk check` and submit block an intent when the matching profile permission is `false`, even if the risk whitelist would otherwise allow it.
39
+ - Profiles that omit `[permissions]` or omit individual fields parse with those permissions defaulting to `false`; this is fail-closed and `profile doctor` will report which declarations are missing for the risk policy.
40
+
41
+ ## Setup
42
+
43
+ ```bash
44
+ agent-finance profile path --profile default
45
+ agent-finance profile template --profile default
46
+ agent-finance profile doctor --profile default
47
+ agent-finance profile explain --profile default
48
+ agent-finance risk explain --profile default
49
+ agent-finance account permissions --profile default --json
50
+ agent-finance account balances --profile default --json
51
+ agent-finance account positions --profile default --json
52
+ ```
53
+
54
+ Signed read JSON output is a `SignedReadSnapshot` envelope:
55
+
56
+ - `profile`, `provider`, `environment`, `kind`
57
+ - `request`: typed read request and scope
58
+ - `payload`: raw provider response for the requested signed read
59
+
60
+ | Command | `kind` | Common payload path |
61
+ | --- | --- | --- |
62
+ | `account permissions` | `api-permissions` | `payload` |
63
+ | `account balances` | `spot-balances` | `payload.balances` |
64
+ | `account positions` | `usds-futures-positions` | `payload.assets`, `payload.positions` |
65
+ | `order query` | `order-query` | `payload` |
66
+ | `order open` | `open-orders` | `payload` |
67
+ | `transfer history` | `transfer-history` | `payload.rows` |
68
+
69
+ ## Order Flow
70
+
71
+ ```bash
72
+ agent-finance order create BTCUSDT --profile default --market spot --side buy --kind limit --quantity 0.001 --price 50000 --time-in-force gtc
73
+ agent-finance order create BTCUSDT --profile default --market spot --side buy --kind limit-maker --quantity 0.001 --price 50000
74
+ agent-finance order create BTCUSDT --profile default --market spot --side buy --kind market --quantity 0.001 --valuation-price 50000
75
+ agent-finance risk check INTENT_ID --profile default
76
+ agent-finance order submit INTENT_ID --profile default
77
+ agent-finance order submit INTENT_ID --profile default --test
78
+ agent-finance order submit INTENT_ID --profile default --live
79
+ agent-finance order query BTCUSDT --profile default --market spot --client-order-id CLIENT_ORDER_ID --json
80
+ agent-finance order open --profile default --market spot --symbol BTCUSDT --json
81
+ ```
82
+
83
+ Signed submit JSON output is a `SubmitSnapshot` envelope:
84
+
85
+ - `profile`, `provider`, `environment`, `intent_id`, `intent_kind`, `mode`, `risk`
86
+ - `execution.kind`: `plan`, `order-submit`, `cancel`, `transfer`, or `futures-state`
87
+ - `execution.payload`: dry-run request plan, exchange rule check, or raw provider execution payload
88
+
89
+ ## Cancel Flow
90
+
91
+ `order cancel` creates a cancel intent; it does not cancel an exchange order until the intent is checked and submitted.
92
+
93
+ ```bash
94
+ agent-finance order cancel BTCUSDT --profile default --market spot --client-order-id CLIENT_ORDER_ID
95
+ agent-finance risk check CANCEL_INTENT_ID --profile default
96
+ agent-finance order submit CANCEL_INTENT_ID --profile default
97
+ agent-finance order submit CANCEL_INTENT_ID --profile default --live
98
+ ```
99
+
100
+ ## Futures State Flow
101
+
102
+ Add Binance futures account position mode policy manually before using `--kind position-mode`; it is not included in the default profile template:
103
+
104
+ ```toml
105
+ [[risk.allowed_futures_state_changes]]
106
+ kind = "position-mode"
107
+ mode = "hedge"
108
+ ```
109
+
110
+ ```bash
111
+ agent-finance state create --profile default --kind leverage --symbol BTCUSDT --leverage 2
112
+ agent-finance state create --profile default --kind margin-type --symbol BTCUSDT --margin-type isolated
113
+ agent-finance state create --profile default --kind position-mode --position-mode hedge
114
+ agent-finance risk check INTENT_ID --profile default --live
115
+ agent-finance state submit INTENT_ID --profile default
116
+ agent-finance state submit INTENT_ID --profile default --live
117
+ ```
118
+
119
+ ## Transfer Flow
120
+
121
+ ```bash
122
+ agent-finance transfer create USDT --profile default --direction spot-to-usds-futures --amount 10
123
+ agent-finance risk check INTENT_ID --profile default
124
+ agent-finance transfer submit INTENT_ID --profile default
125
+ agent-finance transfer submit INTENT_ID --profile default --live
126
+ agent-finance transfer history --profile live --direction spot-to-usds-futures --size 20 --json
127
+ ```
128
+
129
+ ## Audit Flow
130
+
131
+ ```bash
132
+ agent-finance audit tail --limit 20
133
+ agent-finance audit export --json
134
+ ```
135
+
136
+ ## Guardrails
137
+
138
+ - Never put API secrets in TOML, Markdown, command history, audit logs, or prompts.
139
+ - Use Binance testnet profiles first.
140
+ - For live profiles, keep whitelist and notional limits small.
141
+ - `profile doctor` first checks that `[permissions]` covers the risk policy, then reads Binance API restrictions when HMAC env vars are set and reports specific permission checks for spot trading, USD-M futures, and universal transfer.
142
+ - Missing `[permissions]` fields default to `false`; add explicit declarations instead of assuming older profiles are live-write capable.
143
+ - Live submit checks the required Binance API permissions before claiming the intent, so a permission failure does not consume the intent.
144
+ - `max_daily_order_notional_usdt` is enforced from the local append-only audit log for `risk check --live` and live order submit. Matching live-submit events with missing notional data fail closed.
145
+ - `order submit` without flags is an offline dry-run; `--test` calls an exchange test endpoint where available but does not consume the intent; only `--live` consumes the intent.
146
+ - `order submit --test` and `order submit --live` fetch Binance `exchangeInfo` and block orders that violate locally checkable symbol status, price tick, lot size, or notional filters. Dry-run is offline and prints the `exchangeInfo` request that will be checked later.
147
+ - Limit orders use `--price` as the exchange price. Spot `limit-maker` orders map to Binance `LIMIT_MAKER`, do not accept `--time-in-force`, and rely on the exchange to reject orders that would immediately take liquidity. Market orders use `--valuation-price` for risk notional checks and never send an exchange `price` parameter; exchange notional for market orders is reported as not locally checked because it depends on execution price.
148
+ - Live universal transfers require explicit `[[risk.allowed_transfers]]` entries with direction, asset, and max amount.
149
+ - Live futures state changes require explicit `[[risk.allowed_futures_state_changes]]` entries. Order submit does not change leverage, margin type, or position mode implicitly.
150
+ - Review `risk check` findings before live position-mode submit; the CLI warns that Binance applies it account-wide across every symbol and that UM/CM share the setting.
151
+ - Transfer history reads Binance SAPI live account data and requires a reviewed live profile.
152
+ - Do not use this CLI for withdrawals, margin, COIN-M, options, earn, or external transfers.
package/skill-data/providers/SKILL.md CHANGED
@@ -3,35 +3,34 @@ name: providers
3
3
  description: Understand agent-finance provider capabilities across Yahoo, SEC EDGAR, CNBC, Robinhood, Stooq, Binance, Coinbase, OKX, CoinGecko, Polymarket, and fallback URL readers.
4
4
  ---
5
5
 
6
- # agent-finance providers skill
6
+ # agent-finance market providers skill
7
7
 
8
8
  ## Capability Matrix
9
9
 
10
10
  Always inspect provider coverage instead of guessing from provider names:
11
11
 
12
12
  ```bash
13
- agent-finance providers
14
- agent-finance providers --json
13
+ agent-finance market providers
14
+ agent-finance market providers --json
15
15
  ```
16
16
 
17
17
  ## Provider Rules
18
18
 
19
- - Quotes: use `price SYMBOL` first. Only force a provider when cross-checking.
20
- - Session split: use `sessions SYMBOL`.
21
- - History: use `history --provider auto|yahoo|stooq|robinhood` for equities; use `history --asset crypto --crypto-provider auto|binance|coinbase|okx|coingecko` for crypto.
22
- - Research: `fundamentals/events --provider auto` combines useful no-key sources when available.
19
+ - Quotes: use `market price SYMBOL` first. Only force a provider when cross-checking.
20
+ - Session split: use `market sessions SYMBOL`.
21
+ - History: use `market history --provider auto|yahoo|stooq|robinhood` for equities; use `market history --asset crypto --crypto-provider auto|binance|coinbase|okx|coingecko` for crypto.
22
+ - Research: `market fundamentals/events --provider auto` combines useful no-key sources when available.
23
23
  - SEC EDGAR is official for filings and XBRL facts, not market quotes, options, analyst estimates, or news aggregation.
24
24
  - Robinhood and CNBC are partial no-key sources; use them as cross-checks, not replacements for official filings or primary disclosures.
25
25
  - Stooq live can provide no-key daily/weekly/monthly history; intraday bulk data requires explicit imported ZIP cache.
26
- - Crypto: use capability-first commands such as `crypto quote/book/trades/candles/funding/open-interest/discover`, then force `--provider binance|coinbase|okx|coingecko` only when cross-checking or auditing.
26
+ - Crypto: use capability-first commands such as `market crypto quote/book/trades/candles/funding/open-interest/discover`, then force `--provider binance|coinbase|okx|coingecko` only when cross-checking or auditing.
27
27
  - Binance Spot and USD-M Futures are tier-1 crypto market-data providers. Use `agent-finance skills get crypto`.
28
- - Binance uses local clients against official public REST/WebSocket paths, not the generated Binance SDK.
29
28
  - Binance USD-M futures / TradFi perps are derivative instruments and proxy price-discovery sources, not legal equity.
30
29
  - Coinbase is a spot exchange cross-check for products, tickers, stats, books, trades, candles, and volume summary.
31
30
  - OKX is a spot/derivatives exchange cross-check for instruments, tickers, books, trades, candles, funding, mark price, and open interest.
32
31
  - CoinGecko is an aggregate crypto source for simple price, coin metadata, markets, tickers, OHLC, market charts, trending, global, exchanges, and derivatives discovery.
33
- - Polymarket is a prediction-market sentiment source. Use `polymarket search` and `polymarket market` for implied probability, orderbook, liquidity, OI, holder preview rows, and probability history; do not use it as an equity quote or primary-source fact.
32
+ - Polymarket is a prediction-market sentiment source. Use `market polymarket search` and `market polymarket market` for implied probability, orderbook, liquidity, OI, holder preview rows, and probability history; do not use it as an equity quote or primary-source fact.
34
33
 
35
34
  ## Browser Boundary
36
35
 
37
- The CLI uses HTTP requests with browser-like TLS behavior where possible, but it is not a full browser. Dynamic, login-gated, screenshot-sensitive, or noisy pages require a real browser tool. Polymarket uses the official SDK by default; explicit `--proxy` or `--no-proxy` uses public REST fallback through the CLI HTTP stack.
36
+ The CLI can read many public HTTP sources, but it is not a full browser. Dynamic, login-gated, screenshot-sensitive, or noisy pages require a real browser tool.
package/skill-data/research-data/SKILL.md CHANGED
@@ -8,19 +8,19 @@ description: Fetch no-key Yahoo, SEC EDGAR, Robinhood, and CNBC research data, i
8
8
  ## Commands
9
9
 
10
10
  ```bash
11
- agent-finance fundamentals CRDO
12
- agent-finance fundamentals CRDO --provider sec-edgar
13
- agent-finance fundamentals CRDO --provider robinhood
14
- agent-finance fundamentals CRDO --provider cnbc
15
- agent-finance analysis CRDO
16
- agent-finance options CRDO
17
- agent-finance options CRDO --provider robinhood --count 80
18
- agent-finance ownership CRDO
19
- agent-finance events CRDO --provider sec-edgar
20
- agent-finance news CRDO
21
- agent-finance read-url "https://www.sec.gov/Archives/edgar/data/0001807794/000162828026014017/crdo-20260131.htm"
22
- agent-finance search "optical interconnect"
23
- agent-finance screen most_actives
11
+ agent-finance market fundamentals CRDO
12
+ agent-finance market fundamentals CRDO --provider sec-edgar
13
+ agent-finance market fundamentals CRDO --provider robinhood
14
+ agent-finance market fundamentals CRDO --provider cnbc
15
+ agent-finance market analysis CRDO
16
+ agent-finance market options CRDO
17
+ agent-finance market options CRDO --provider robinhood --count 80
18
+ agent-finance market ownership CRDO
19
+ agent-finance market events CRDO --provider sec-edgar
20
+ agent-finance market news CRDO
21
+ agent-finance market read-url "https://www.sec.gov/Archives/edgar/data/0001807794/000162828026014017/crdo-20260131.htm"
22
+ agent-finance market search "optical interconnect"
23
+ agent-finance market screen most_actives
24
24
  ```
25
25
 
26
26
  ## Output Rules
@@ -30,7 +30,7 @@ agent-finance screen most_actives
30
30
  - `--raw` prints raw payloads in human mode.
31
31
  - `--refresh` skips cache.
32
32
  - `--cache-ttl-seconds <N>` changes non-price cache TTL.
33
- - `read-url --provider auto` tries direct/Jina/Defuddle readers and reports fallback errors.
33
+ - `market read-url --provider auto` tries direct/Jina/Defuddle readers and reports fallback errors.
34
34
 
35
35
  ## Research Rules
36
36