agent-finance

The saved excerpt is a snapshot from review. The external source remains the complete and most current version.

---
name: agent-finance
description: Use agent-finance for evidence-driven financial research that needs current quotes, regular/pre/post/overnight session splits, crypto market data, OHLCV history, indicators, prediction-market sentiment, provider capability discovery, no-key research payloads, URL text extraction, polling, or WebSocket streams.
---

# agent-finance

`agent-finance` is a finance and market-data CLI for evidence-driven market work.

## Install Or Update

The npm package name is `agent-finance-cli`; the installed command is `agent-finance`.
Do not install an npm package named `agent-finance`; it is not this project.

The skill may be installed before the CLI binary is present. Verify the command first:

```bash
agent-finance --version
```

If the command is missing or stale, install or update the npm package:

```bash
npm install -g agent-finance-cli@latest
agent-finance --version
```

Refresh this discovery skill from the repository when updating the CLI:

```bash
npx skills add https://github.com/M4n5ter/agent-finance
```

## Runtime Guidance

This file is a discovery entry point. Before data collection, load the runtime guide from the installed CLI:

```bash
agent-finance skills get core
agent-finance skills get core --full
agent-finance skills list
```

## Task Skills

Load a narrower skill for the task:

```bash
agent-finance skills get price
agent-finance skills get history-indicators
agent-finance skills get crypto
agent-finance skills get research-data
agent-finance skills get providers
agent-finance skills get prediction-markets
agent-finance skills get profile
agent-finance skills get tui
```

## Operating Rules

- Use `market price` for the default current observable price.
- Use `market sessions` when regular, premarket, postmarket, overnight, provider differences, or proxy prices matter.
- Inspect daily and minute history before trading, order-quality, stop-loss, or take-profit conclusions.
- Use `--json` when another agent or script will consume the output.
- Load `skills get providers` before provider health, endpoint discovery, or Binance public fallback diagnostics.
- Use `agent-finance tui` for a live selected-symbol chart, capability-driven market context, open orders, portfolio holdings, Diagnostics, and staged trade preparation.
- Load `skills get tui` before relying on TUI chart controls, account/profile overlays, Diagnostics, or the Trade Drawer; use `tui --dump-state --json` instead of parsing screen text.
- Treat crypto and prediction-market data as market evidence, not primary company facts.
- Load `skills get profile` before signed account, order, transfer, futures state, risk, or audit workflows.
- Use a real browser tool for login-gated, dynamic, screenshot-sensitive, X/Reddit, brokerage, or extraction-suspicious pages.