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

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 (10) hide show
  1. package/bin/agent-finance +0 -0
  2. package/package.json +2 -1
  3. package/skill-data/core/SKILL.md +87 -0
  4. package/skill-data/core/references/command-map.md +92 -0
  5. package/skill-data/crypto/SKILL.md +68 -0
  6. package/skill-data/history-indicators/SKILL.md +54 -0
  7. package/skill-data/prediction-markets/SKILL.md +52 -0
  8. package/skill-data/price/SKILL.md +53 -0
  9. package/skill-data/providers/SKILL.md +37 -0
  10. package/skill-data/research-data/SKILL.md +39 -0
package/bin/agent-finance CHANGED
Binary file
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agent-finance-cli-linux-arm64",
3
- "version": "0.2.1",
3
+ "version": "0.2.2",
4
4
  "description": "Prebuilt linux/arm64 binary for agent-finance-cli.",
5
5
  "license": "MIT OR Apache-2.0",
6
6
  "repository": {
@@ -22,6 +22,7 @@
22
22
  },
23
23
  "files": [
24
24
  "bin/",
25
+ "skill-data/",
25
26
  "README.md",
26
27
  "LICENSE-MIT",
27
28
  "LICENSE-APACHE"
package/skill-data/core/SKILL.md ADDED
@@ -0,0 +1,87 @@
1
+ ---
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.
4
+ ---
5
+
6
+ # agent-finance core skill
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.
9
+
10
+ ## Start Here
11
+
12
+ ```bash
13
+ agent-finance skills list
14
+ agent-finance skills get core --full
15
+ agent-finance providers
16
+ agent-finance skills get crypto
17
+ ```
18
+
19
+ ## Default Workflow
20
+
21
+ 1. Current observable price:
22
+
23
+ ```bash
24
+ agent-finance price CRDO
25
+ agent-finance price CRDO --json
26
+ ```
27
+
28
+ 2. Precise session/provider split:
29
+
30
+ ```bash
31
+ agent-finance sessions CRDO
32
+ agent-finance sessions LITE --proxy-symbol LITEUSDT
33
+ ```
34
+
35
+ 3. History before a trading or order-quality conclusion:
36
+
37
+ ```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
40
+ ```
41
+
42
+ 4. Research data:
43
+
44
+ ```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
55
+ ```
56
+
57
+ 5. Prediction-market sentiment:
58
+
59
+ ```bash
60
+ agent-finance polymarket search "spacex ipo" --limit 5
61
+ agent-finance polymarket market MARKET_ID_OR_SLUG
62
+ agent-finance skills get prediction-markets
63
+ ```
64
+
65
+ 6. Crypto market data:
66
+
67
+ ```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
75
+ ```
76
+
77
+ ## Rules
78
+
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.
81
+ - 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.
83
+ - 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
+ - Spot is crypto spot; USD-M futures / TradFi perps are derivatives and proxy instruments.
85
+ - 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.
87
+ - JSON output preserves structured fields for downstream computation. Human output is for quick inspection.
package/skill-data/core/references/command-map.md ADDED
@@ -0,0 +1,92 @@
1
+ # agent-finance full core skill
2
+
3
+ Read this when you need the full command map for `agent-finance`.
4
+
5
+ ## Command Map
6
+
7
+ ```bash
8
+ agent-finance skills list
9
+ agent-finance skills get core
10
+ agent-finance skills get price
11
+ agent-finance skills get research-data
12
+ agent-finance skills get providers
13
+ agent-finance skills get crypto
14
+ agent-finance skills get prediction-markets
15
+ agent-finance skills get history-indicators
16
+ ```
17
+
18
+ ## Price and Sessions
19
+
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
25
+ ```
26
+
27
+ `price` answers the default current-price question. `sessions` compares regular/pre/post/overnight/provider/proxy sources.
28
+
29
+ ## History and Indicators
30
+
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
36
+ ```
37
+
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.
39
+
40
+ ## Research Data
41
+
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
56
+ ```
57
+
58
+ Research reports include sources, modules, coverage gaps, highlights, and raw payloads in JSON mode.
59
+
60
+ ## Providers and Proxy Data
61
+
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
71
+ ```
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.
74
+
75
+ ## Prediction Markets
76
+
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
81
+ agent-finance skills get prediction-markets
82
+ ```
83
+
84
+ Use Polymarket for quantifiable sentiment and event-probability signals. It does not replace SEC/IR/company releases, verified news, or equity quotes.
85
+
86
+ ## Network and Browser Boundaries
87
+
88
+ The CLI respects `--proxy`, `AGENT_FINANCE_PROXY`, and standard proxy environment variables. It does not hardcode a local proxy.
89
+
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.
package/skill-data/crypto/SKILL.md ADDED
@@ -0,0 +1,68 @@
1
+ ---
2
+ name: crypto
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
+ ---
5
+
6
+ # agent-finance crypto skill
7
+
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
+
10
+ ## Start
11
+
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
20
+ ```
21
+
22
+ ## Cross-Provider Evidence
23
+
24
+ Prefer these capability-first commands before forcing provider-specific deep endpoints:
25
+
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
38
+ ```
39
+
40
+ `--provider auto` only queries providers that support the requested capability and instrument. Force `--provider` when auditing a specific provider.
41
+
42
+ ## Instruments
43
+
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
52
+ ```
53
+
54
+ ## Rules
55
+
56
+ - Use capability-first crypto commands for all normal work; provider eligibility is determined by capability plus `--instrument`.
57
+ - Binance, Coinbase, OKX, and CoinGecko are tier-1 no-key crypto providers in this CLI, but they answer different questions.
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.
65
+ - 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.
67
+ - Crypto trades 24/7; do not apply equity regular/pre/post/overnight session assumptions.
68
+ - 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 ADDED
@@ -0,0 +1,54 @@
1
+ ---
2
+ name: history-indicators
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
+ ---
5
+
6
+ # agent-finance history and indicators skill
7
+
8
+ ## History
9
+
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
20
+ ```
21
+
22
+ ## Intervals
23
+
24
+ - Yahoo / Yahoo extended: `1m`, `2m`, `5m`, `15m`, `30m`, `60m`, `90m`, `1h`, `1d`, `5d`, `1wk`, `1mo`, `3mo`.
25
+ - Robinhood: `5m`, `10m`, `1h`, `1d`, `1w`.
26
+ - Stooq live: `1d`, `1w`, `1mo`.
27
+ - Stooq bulk cache: `5m`, `1h` after explicit import.
28
+ - Binance spot / USD-M futures: `1m`, `3m`, `5m`, `15m`, `30m`, `1h`, `2h`, `4h`, `6h`, `8h`, `12h`, `1d`, `3d`, `1w`, `1M`.
29
+ - Coinbase: `1m`, `5m`, `15m`, `1h`, `6h`, `1d`.
30
+ - OKX: `1m`, `3m`, `5m`, `15m`, `30m`, `1h`, `2h`, `4h`, `6h`, `12h`, `1d`, `2d`, `3d`.
31
+ - CoinGecko: common intraday and daily requests are mapped to supported OHLC day windows.
32
+
33
+ When unsure:
34
+
35
+ ```bash
36
+ agent-finance history --help
37
+ agent-finance stooq sync --help
38
+ ```
39
+
40
+ ## Adjustments
41
+
42
+ - `--adjustment auto`: adjust OHLC and close using adjusted close.
43
+ - `--adjustment back`: adjust OHLC but keep raw close.
44
+ - `--adjustment raw`: keep raw OHLC and expose adjusted close separately.
45
+ - `--repair`: repair obvious 100x Yahoo price errors and mark repaired bars.
46
+
47
+ ## Indicators
48
+
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
52
+ ```
53
+
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 ADDED
@@ -0,0 +1,52 @@
1
+ ---
2
+ name: prediction-markets
3
+ description: Use Polymarket prediction-market data as quantifiable sentiment and event-probability evidence, including market search, market details, liquidity, orderbook, holder previews, and probability history.
4
+ ---
5
+
6
+ # agent-finance prediction-markets skill
7
+
8
+ Use this skill when an AI Agent needs prediction-market sentiment, event probabilities, or "what capital is pricing in" for a public event.
9
+
10
+ ## Commands
11
+
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
17
+ ```
18
+
19
+ ## Search Semantics
20
+
21
+ - Treat Polymarket search as public relevance search. Do not describe it as guaranteed fuzzy search.
22
+ - Use multiple query fallbacks for important topics:
23
+ - `spacex`, `space x`, `starship`, `ipo`
24
+ - `nvidia`, `nvda`, product names, regulatory events
25
+ - The CLI locally filters and sorts by active/closed state, volume, liquidity, and market signal strength. Still inspect source URLs and raw JSON for important decisions.
26
+
27
+ ## Interpretation Rules
28
+
29
+ - Polymarket prices are implied probabilities backed by user capital.
30
+ - They are useful as quantifiable sentiment and event-probability evidence.
31
+ - They are not facts, confirmed insider information, legal equity prices, broker-fill prices, or official company disclosures.
32
+ - For investment research, pair this signal with primary sources: SEC filings, IR pages, company releases, earnings calls, and verifiable news.
33
+
34
+ ## Useful Flags
35
+
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
39
+ ```
40
+
41
+ - `--include-closed`: include resolved/closed markets for historical expectation checks.
42
+ - `--min-volume`: ignore thin markets.
43
+ - `--refresh`: bypass local cache.
44
+ - `--cache-ttl-seconds`: tune freshness for repeated agent workflows.
45
+ - `--json`: preserve full structured payloads for downstream reasoning.
46
+
47
+ ## Boundaries
48
+
49
+ - This CLI is read-only for Polymarket.
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
+ - Holder data is reported as preview rows returned by the API limit, not as a total holder count.
package/skill-data/price/SKILL.md ADDED
@@ -0,0 +1,53 @@
1
+ ---
2
+ name: price
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
+ ---
5
+
6
+ # agent-finance price skill
7
+
8
+ ## Default Price
9
+
10
+ Use `price` to answer "what is it trading at now?":
11
+
12
+ ```bash
13
+ agent-finance price CRDO
14
+ agent-finance price CRDO --json
15
+ ```
16
+
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
+
19
+ ## Session Split
20
+
21
+ Use `sessions` when the task asks about premarket, postmarket, overnight, BOATS, platform 24h prices, or provider disagreement:
22
+
23
+ ```bash
24
+ agent-finance sessions CRDO
25
+ agent-finance sessions LITE --proxy-symbol LITEUSDT
26
+ ```
27
+
28
+ ## Crypto And Proxy Context
29
+
30
+ Use the crypto market domain for actual crypto symbols:
31
+
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
36
+ ```
37
+
38
+ If an equity or pre-IPO name has a relevant 24/7 derivative or proxy contract, add it only as side context:
39
+
40
+ ```bash
41
+ agent-finance sessions SPCX --proxy-symbol SPCXUSDT
42
+ ```
43
+
44
+ Proxy symbols are price-discovery and sentiment signals. They are not the legal equity, pre-IPO ownership, or broker-fill price.
45
+
46
+ ## Streaming
47
+
48
+ ```bash
49
+ agent-finance stream CRDO --messages 5
50
+ agent-finance watch CRDO --interval-seconds 15 --iterations 4
51
+ ```
52
+
53
+ Use `watch` when WebSocket streaming is blocked by the local network.
package/skill-data/providers/SKILL.md ADDED
@@ -0,0 +1,37 @@
1
+ ---
2
+ name: providers
3
+ description: Understand agent-finance provider capabilities across Yahoo, SEC EDGAR, CNBC, Robinhood, Stooq, Binance, Coinbase, OKX, CoinGecko, Polymarket, and fallback URL readers.
4
+ ---
5
+
6
+ # agent-finance providers skill
7
+
8
+ ## Capability Matrix
9
+
10
+ Always inspect provider coverage instead of guessing from provider names:
11
+
12
+ ```bash
13
+ agent-finance providers
14
+ agent-finance providers --json
15
+ ```
16
+
17
+ ## Provider Rules
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.
23
+ - SEC EDGAR is official for filings and XBRL facts, not market quotes, options, analyst estimates, or news aggregation.
24
+ - Robinhood and CNBC are partial no-key sources; use them as cross-checks, not replacements for official filings or primary disclosures.
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.
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
+ - Binance USD-M futures / TradFi perps are derivative instruments and proxy price-discovery sources, not legal equity.
30
+ - Coinbase is a spot exchange cross-check for products, tickers, stats, books, trades, candles, and volume summary.
31
+ - OKX is a spot/derivatives exchange cross-check for instruments, tickers, books, trades, candles, funding, mark price, and open interest.
32
+ - 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.
34
+
35
+ ## Browser Boundary
36
+
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.
package/skill-data/research-data/SKILL.md ADDED
@@ -0,0 +1,39 @@
1
+ ---
2
+ name: research-data
3
+ description: Fetch no-key Yahoo, SEC EDGAR, Robinhood, and CNBC research data, including fundamentals, analyst data, options, ownership, events, news, search, screeners, and URL text extraction.
4
+ ---
5
+
6
+ # agent-finance research data skill
7
+
8
+ ## Commands
9
+
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
24
+ ```
25
+
26
+ ## Output Rules
27
+
28
+ - Human mode prints a compact table.
29
+ - `--json` preserves sources, modules, coverage gaps, highlights, and raw payloads.
30
+ - `--raw` prints raw payloads in human mode.
31
+ - `--refresh` skips cache.
32
+ - `--cache-ttl-seconds <N>` changes non-price cache TTL.
33
+ - `read-url --provider auto` tries direct/Jina/Defuddle readers and reports fallback errors.
34
+
35
+ ## Research Rules
36
+
37
+ - Treat social media, search snippets, and extracted web text as leads until confirmed by primary sources.
38
+ - Use SEC/company filings for official facts when available.
39
+ - Use a real browser for dynamic, login-gated, table-layout-sensitive, or extraction-suspicious pages.