agent-finance-cli-linux-arm64 0.3.0 → 0.3.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.
- package/README.md +2 -2
- package/bin/agent-finance +0 -0
- package/package.json +5 -5
- package/skill-data/core/SKILL.md +20 -18
- package/skill-data/core/references/command-map.md +0 -2
- package/skill-data/crypto/SKILL.md +1 -4
- package/skill-data/prediction-markets/SKILL.md +1 -2
- package/skill-data/profile/SKILL.md +1 -66
- package/skill-data/providers/SKILL.md +1 -2
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
|
|
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.3.
|
|
4
|
-
"description": "Prebuilt linux/arm64 binary for agent-finance
|
|
3
|
+
"version": "0.3.2",
|
|
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
|
|
8
|
+
"url": "git+https://github.com/M4n5ter/agent-finance.git"
|
|
9
9
|
},
|
|
10
|
-
"homepage": "https://github.com/M4n5ter/agent-finance
|
|
10
|
+
"homepage": "https://github.com/M4n5ter/agent-finance#readme",
|
|
11
11
|
"bugs": {
|
|
12
|
-
"url": "https://github.com/M4n5ter/agent-finance
|
|
12
|
+
"url": "https://github.com/M4n5ter/agent-finance/issues"
|
|
13
13
|
},
|
|
14
14
|
"os": [
|
|
15
15
|
"linux"
|
package/skill-data/core/SKILL.md
CHANGED
|
@@ -5,20 +5,31 @@ description: Entry guide for agent-finance market price, sessions, crypto, histo
|
|
|
5
5
|
|
|
6
6
|
# agent-finance core skill
|
|
7
7
|
|
|
8
|
-
This
|
|
8
|
+
This is the runtime entry guide for using `agent-finance`.
|
|
9
9
|
|
|
10
|
-
## Start
|
|
10
|
+
## Start
|
|
11
11
|
|
|
12
12
|
```bash
|
|
13
13
|
agent-finance skills list
|
|
14
|
-
agent-finance skills get core --full
|
|
15
14
|
agent-finance market providers
|
|
16
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
|
|
17
24
|
agent-finance skills get crypto
|
|
25
|
+
agent-finance skills get prediction-markets
|
|
26
|
+
agent-finance skills get providers
|
|
18
27
|
agent-finance skills get profile
|
|
19
28
|
```
|
|
20
29
|
|
|
21
|
-
|
|
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
|
|
22
33
|
|
|
23
34
|
1. Current observable price:
|
|
24
35
|
|
|
@@ -41,7 +52,7 @@ agent-finance market history LITE --interval 1d --range 1mo --adjustment auto --
|
|
|
41
52
|
agent-finance market history LITE --interval 1m --range 5d --session extended --adjustment raw --no-actions --limit 120
|
|
42
53
|
```
|
|
43
54
|
|
|
44
|
-
4. Research
|
|
55
|
+
4. Research and source context:
|
|
45
56
|
|
|
46
57
|
```bash
|
|
47
58
|
agent-finance market fundamentals CRDO
|
|
@@ -76,7 +87,7 @@ agent-finance market crypto book BTC/USDT --provider okx --limit 20
|
|
|
76
87
|
agent-finance market crypto discover --provider coingecko --kind trending
|
|
77
88
|
```
|
|
78
89
|
|
|
79
|
-
7. Signed
|
|
90
|
+
7. Signed Binance workflows:
|
|
80
91
|
|
|
81
92
|
```bash
|
|
82
93
|
agent-finance skills get profile
|
|
@@ -94,25 +105,16 @@ agent-finance state submit INTENT_ID --profile default
|
|
|
94
105
|
agent-finance audit export --json
|
|
95
106
|
```
|
|
96
107
|
|
|
97
|
-
## Rules
|
|
108
|
+
## Decision Rules
|
|
98
109
|
|
|
99
110
|
- Use `market price` for the default "what is the current price?" answer.
|
|
100
111
|
- Use `market sessions` when premarket, postmarket, overnight, BOATS, provider differences, or proxy prices matter.
|
|
101
112
|
- Use both daily and minute history before judging fills, limit-order quality, stop placement, or intraday action.
|
|
102
|
-
- Use `market providers --json`
|
|
113
|
+
- Use `market providers --json` for a machine-readable capability matrix.
|
|
103
114
|
- Use `capabilities --json` for the unified terminal surface, including account/order/transfer/futures-state safety boundaries.
|
|
104
|
-
- Use `skills get profile` before touching signed account, order, transfer, futures state, risk, or audit commands.
|
|
105
|
-
- Signed read commands return a typed `SignedReadSnapshot` envelope with `profile`, `provider`, `environment`, `kind`, typed `request` scope, and raw provider data under `payload`.
|
|
106
|
-
- Signed read snapshot kinds are command discriminators: `account permissions` -> `api-permissions`, `account balances` -> `spot-balances`, `account positions` -> `usds-futures-positions`, `order query` -> `order-query`, `order open` -> `open-orders`, `transfer history` -> `transfer-history`.
|
|
107
|
-
- Signed submit commands return a typed `SubmitSnapshot` envelope with `profile`, `provider`, `environment`, `intent_id`, `intent_kind`, `mode`, `risk`, `execution.kind`, and execution data under `execution.payload`.
|
|
108
|
-
- Run `profile doctor` before live writes; it checks `[permissions]` against the risk policy, reports Binance API permission checks when HMAC env vars are set, and live submit rechecks exchange permissions before claiming the intent.
|
|
109
|
-
- Signed order test/live submit checks locally checkable Binance exchangeInfo filters before sending an order; dry-run remains offline.
|
|
110
|
-
- Live market orders are blocked until risk notional can be derived from fresh exchange data instead of user-supplied `valuation_price`.
|
|
111
|
-
- USD-M futures leverage, margin type, and Binance futures account position mode changes use separate `state` intents; order submit never changes account state implicitly.
|
|
112
|
-
- 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.
|
|
113
|
-
- Position mode policy is not in the default profile template; add an explicit `[[risk.allowed_futures_state_changes]]` entry with `kind = "position-mode"` and the intended `mode` before creating that intent.
|
|
114
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.
|
|
115
116
|
- Spot is crypto spot; USD-M futures / TradFi perps are derivatives and proxy instruments.
|
|
116
117
|
- Treat Polymarket as quantifiable prediction-market sentiment and event-probability evidence only; it is not an equity quote or primary-source fact.
|
|
117
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.
|
|
118
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.
|
|
@@ -126,6 +126,4 @@ Transfer history reads Binance SAPI live account data and requires a reviewed li
|
|
|
126
126
|
|
|
127
127
|
The CLI respects `--proxy`, `AGENT_FINANCE_PROXY`, and standard proxy environment variables. It does not hardcode a local proxy.
|
|
128
128
|
|
|
129
|
-
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.
|
|
130
|
-
|
|
131
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.
|
|
@@ -56,12 +56,9 @@ agent-finance market crypto stream BTCUSDT --instrument swap --kind mark-price -
|
|
|
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
59
|
- Prefer `market crypto snapshot` for current observable market state.
|
|
63
60
|
- Prefer `market crypto sentiment` for futures leverage, funding, open interest, long/short, taker flow, and basis.
|
|
64
|
-
- Prefer `market crypto quote/book/trades/candles/funding/open-interest/discover --json`
|
|
61
|
+
- Prefer `market crypto quote/book/trades/candles/funding/open-interest/discover --json` for provider evidence in downstream reasoning.
|
|
65
62
|
- Use `--json` for downstream computation and `--raw` when auditing provider payloads.
|
|
66
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.
|
|
@@ -5,7 +5,7 @@ description: Use Polymarket prediction-market data as quantifiable sentiment and
|
|
|
5
5
|
|
|
6
6
|
# agent-finance prediction-markets skill
|
|
7
7
|
|
|
8
|
-
Use this skill
|
|
8
|
+
Use this skill for prediction-market sentiment, event probabilities, or "what capital is pricing in" for a public event.
|
|
9
9
|
|
|
10
10
|
## Commands
|
|
11
11
|
|
|
@@ -48,5 +48,4 @@ agent-finance market 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.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: profile
|
|
3
|
-
description: Configure agent-finance trading profiles, Binance HMAC env references, risk policy, intent-first live writes, audit logs, and
|
|
3
|
+
description: Configure agent-finance trading profiles, Binance HMAC env references, risk policy, intent-first live writes, audit logs, and guarded signed workflows.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# agent-finance profile skill
|
|
@@ -133,71 +133,6 @@ agent-finance audit tail --limit 20
|
|
|
133
133
|
agent-finance audit export --json
|
|
134
134
|
```
|
|
135
135
|
|
|
136
|
-
## Gated Smoke Tests
|
|
137
|
-
|
|
138
|
-
These checks are for maintainers and AI Agents validating signed Binance workflows.
|
|
139
|
-
They require exported `BINANCE_API_KEY` and `BINANCE_PRIVATE_KEY`; the test profiles store only env var names.
|
|
140
|
-
|
|
141
|
-
Live read-only signed smoke, no orders or transfers:
|
|
142
|
-
|
|
143
|
-
```bash
|
|
144
|
-
AGENT_FINANCE_LIVE_BINANCE_SIGNED=1 cargo test --test binance_live binance_live_signed_read_only_surface_is_usable -- --ignored --exact --nocapture
|
|
145
|
-
```
|
|
146
|
-
|
|
147
|
-
Testnet signed order-test smoke, uses Binance test endpoints and does not place a live order:
|
|
148
|
-
|
|
149
|
-
```bash
|
|
150
|
-
AGENT_FINANCE_TESTNET_BINANCE_SIGNED=1 cargo test --test binance_live binance_testnet_signed_order_test_surface_is_usable -- --ignored --exact --nocapture
|
|
151
|
-
```
|
|
152
|
-
|
|
153
|
-
Testnet order-flow smoke places a Binance testnet spot `LIMIT_MAKER` order, checks open orders and order query, then cancels it.
|
|
154
|
-
It uses the Binance testnet environment and skips live SAPI permission probing; it does not touch live Binance funds, but it still requires testnet credentials, explicit ACK, a deliberately post-only order, and enough testnet balance.
|
|
155
|
-
If the testnet price would take liquidity, Binance should reject the `LIMIT_MAKER` submit and the smoke fails before open/query/cancel assertions:
|
|
156
|
-
|
|
157
|
-
```bash
|
|
158
|
-
AGENT_FINANCE_TESTNET_BINANCE_ORDER_FLOW=1 \
|
|
159
|
-
AGENT_FINANCE_TESTNET_BINANCE_ORDER_FLOW_ACK=I_UNDERSTAND_THIS_PLACES_A_TESTNET_ORDER \
|
|
160
|
-
AGENT_FINANCE_TESTNET_BINANCE_ORDER_SYMBOL=BTCUSDT \
|
|
161
|
-
AGENT_FINANCE_TESTNET_BINANCE_ORDER_SIDE=buy \
|
|
162
|
-
AGENT_FINANCE_TESTNET_BINANCE_ORDER_QUANTITY=0.0004 \
|
|
163
|
-
AGENT_FINANCE_TESTNET_BINANCE_ORDER_PRICE=30000 \
|
|
164
|
-
AGENT_FINANCE_TESTNET_BINANCE_ORDER_MAX_NOTIONAL_USDT=15 \
|
|
165
|
-
cargo test --test binance_live_write binance_testnet_order_open_query_cancel_flow_is_usable -- --ignored --exact --nocapture
|
|
166
|
-
```
|
|
167
|
-
|
|
168
|
-
Live place-and-cancel smoke places a real Binance spot `LIMIT_MAKER` post-only order and then cancels it.
|
|
169
|
-
The test also reads the live Binance order book and fails before submit unless buy price is below best bid or sell price is above best ask.
|
|
170
|
-
Use only with a deliberately non-marketable tiny order that still satisfies Binance min-notional filters; do not fix min-notional failures by making the price marketable.
|
|
171
|
-
Prefer a liquid low-notional symbol such as `DOGEUSDT` when the account only has a few USDT. Compute the smoke price from the live book and keep buy orders at least 3% below best bid, or sell orders at least 3% above best ask. After the smoke, query open orders and balances to confirm no order or locked balance remains.
|
|
172
|
-
Binance cancel responses may identify the original order with `origClientOrderId`; `clientOrderId` can refer to the cancel request itself.
|
|
173
|
-
Set `AGENT_FINANCE_LIVE_BINANCE_SMOKE_DATA_HOME` to a persistent local directory so audit events and daily live notional limits survive between smoke runs.
|
|
174
|
-
|
|
175
|
-
```bash
|
|
176
|
-
AGENT_FINANCE_LIVE_BINANCE_PLACE_AND_CANCEL_ORDER=1 \
|
|
177
|
-
AGENT_FINANCE_LIVE_BINANCE_WRITE_ACK=I_UNDERSTAND_THIS_PLACES_A_LIVE_ORDER \
|
|
178
|
-
AGENT_FINANCE_LIVE_BINANCE_SMOKE_DATA_HOME=$HOME/.local/state/agent-finance-live-smoke \
|
|
179
|
-
AGENT_FINANCE_LIVE_BINANCE_ORDER_SYMBOL=DOGEUSDT \
|
|
180
|
-
AGENT_FINANCE_LIVE_BINANCE_ORDER_MARKET=spot \
|
|
181
|
-
AGENT_FINANCE_LIVE_BINANCE_ORDER_SIDE=buy \
|
|
182
|
-
AGENT_FINANCE_LIVE_BINANCE_ORDER_QUANTITY=15 \
|
|
183
|
-
AGENT_FINANCE_LIVE_BINANCE_ORDER_PRICE=0.07638 \
|
|
184
|
-
AGENT_FINANCE_LIVE_BINANCE_ORDER_MAX_NOTIONAL_USDT=5 \
|
|
185
|
-
cargo test --test binance_live_write binance_live_order_cancel_smoke_is_usable -- --ignored --exact --nocapture
|
|
186
|
-
```
|
|
187
|
-
|
|
188
|
-
Live transfer smoke moves real funds between Spot and USD-M. Run it only with a tiny amount and an explicit direction:
|
|
189
|
-
|
|
190
|
-
```bash
|
|
191
|
-
AGENT_FINANCE_LIVE_BINANCE_TRANSFERS=1 \
|
|
192
|
-
AGENT_FINANCE_LIVE_BINANCE_TRANSFER_ACK=I_UNDERSTAND_THIS_MOVES_FUNDS \
|
|
193
|
-
AGENT_FINANCE_LIVE_BINANCE_SMOKE_DATA_HOME=$HOME/.local/state/agent-finance-live-smoke \
|
|
194
|
-
AGENT_FINANCE_LIVE_BINANCE_TRANSFER_ASSET=USDT \
|
|
195
|
-
AGENT_FINANCE_LIVE_BINANCE_TRANSFER_DIRECTION=spot-to-usds-futures \
|
|
196
|
-
AGENT_FINANCE_LIVE_BINANCE_TRANSFER_AMOUNT=0.1 \
|
|
197
|
-
AGENT_FINANCE_LIVE_BINANCE_TRANSFER_MAX_AMOUNT=0.1 \
|
|
198
|
-
cargo test --test binance_live_write binance_live_transfer_smoke_is_usable -- --ignored --exact --nocapture
|
|
199
|
-
```
|
|
200
|
-
|
|
201
136
|
## Guardrails
|
|
202
137
|
|
|
203
138
|
- Never put API secrets in TOML, Markdown, command history, audit logs, or prompts.
|
|
@@ -25,7 +25,6 @@ agent-finance market providers --json
|
|
|
25
25
|
- Stooq live can provide no-key daily/weekly/monthly history; intraday bulk data requires explicit imported ZIP cache.
|
|
26
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.
|
|
@@ -34,4 +33,4 @@ agent-finance market providers --json
|
|
|
34
33
|
|
|
35
34
|
## Browser Boundary
|
|
36
35
|
|
|
37
|
-
The CLI
|
|
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.
|