Stock Market Intelligence

Market data API for AI agents. Equities, fixed income, crypto, and macro. Bitcoin Lightning micropayments.

Security Scan

The skill's files, instructions, and required environment variables are consistent with a market-data API client and do not request unrelated credentials or system access.

Purpose & Capability

Name/description (market data, alerts, Lightning payments) match the included README, SKILL.md and two helper scripts. Required binaries (curl, jq, python3) and the single env var AGENTHC_API_KEY are proportionate and expected for a CLI/API client.

Instruction Scope

SKILL.md and scripts only instruct network calls to https://api.traderhc.com (register, data endpoints, alerts). They do not read unrelated system files, other env vars, or modify system configuration. Setup prints the API key and suggests the user add it to shell config but does not itself write to system files.

Install Mechanism

No install spec; code is instruction-only plus small shell scripts included in the bundle. No remote arbitrary code downloads or archive extraction are requested.

Credentials

Only AGENTHC_API_KEY is required and declared as the primary credential; that matches the behavior (register endpoint issues an API key, subsequent requests use it). No unrelated secrets or multiple credentials are requested.

Persistence & Privilege

always is false and the skill does not attempt to persist or alter other skills or global agent settings. Setup suggests a manual export into shell config but does not perform automatic persistent changes.

Assessment

This skill appears to be a straightforward client for api.traderhc.com: it will contact that external service to register an API key and to fetch market data and alerts. Before installing, verify you trust the domain and its privacy/terms (api.traderhc.com). Note the setup flow prints an API key that you can export into your environment — the script does not automatically persist it but recommends you add it to your shell config if you choose; do not paste that key into places you don't control. Alerts can require webhooks to your agent endpoint (ensure you only provide callback URLs you control). The Lightning (L402) flow may require paying invoices for premium endpoints — be prepared for on-chain micropayments if you use premium features. If you are uncertain, run the scripts in an isolated environment or inspect the POST responses from /api/v1/register before exporting the key.

Market data API for AI agents and developers. Covers equities, fixed income, crypto, and macro. Real-time alerts via webhook and Discord. Bitcoin Lightning micropayments. Built by @traderhc.

Setup

For AI Agents

export AGENTHC_API_KEY=$(curl -s -X POST "https://api.traderhc.com/api/v1/register" \
  -H "Content-Type: application/json" \
  -d '{"name": "MyAgent"}' | jq -r '.api_key')

Free, no KYC, no credit card. Query any free endpoint:

curl -s "https://api.traderhc.com/api/v1/data/overview" \
  -H "X-API-Key: $AGENTHC_API_KEY" | jq '.data'

Interactive Setup

bash scripts/setup.sh

Non-Interactive (CI/scripts)

export AGENTHC_API_KEY=$(bash scripts/setup.sh --auto)

What's Available

Tier	Coverage	Cost
Free	Market overview, educational content	$0
Premium	Equities, fixed income, macro, crypto, volatility	~$50/mo
Institutional	Full platform access with advanced analytics	~$500/mo

See api.traderhc.com/docs for the full endpoint catalog.

Agent-Optimized Format

Use format=agent for actionable signals:

curl -s "https://api.traderhc.com/api/v1/data/overview?format=agent" \
  -H "X-API-Key: $AGENTHC_API_KEY" | jq '.signals'

Compact Format

Use format=compact for reduced token usage:

curl -s "https://api.traderhc.com/api/v1/data/overview?format=compact" \
  -H "X-API-Key: $AGENTHC_API_KEY" | jq '.'

Batch Queries (Premium+)

Query multiple endpoints in one request:

curl -s -X POST "https://api.traderhc.com/api/v1/data/batch" \
  -H "X-API-Key: $AGENTHC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"endpoints": ["overview", "fixed_income", "macro"]}' | jq '.'

Alerts

Subscribe to real-time market alerts via webhook or Discord:

# List available alert types
curl -s "https://api.traderhc.com/api/v1/alerts" \
  -H "X-API-Key: $AGENTHC_API_KEY" | jq '.alerts'

# Subscribe via webhook
curl -s -X POST "https://api.traderhc.com/api/v1/alerts/subscribe" \
  -H "X-API-Key: $AGENTHC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type": "market_events", "callback_url": "https://your-agent.com/webhook"}' | jq '.'

Lightning Payment (L402)

For per-request payment without registration:

1. Request a premium endpoint without auth
2. Receive 402 response with Lightning invoice
3. Pay the invoice (any Lightning wallet)
4. Re-request with Authorization: L402 <macaroon>:<preimage>

Pricing

Tier	Rate	Cost
Free	10/min, 100/day	$0
Premium	60/min, 5,000/day	~$50/mo (50K sats)
Institutional	120/min, 50,000/day	~$500/mo (500K sats)

Payment via Bitcoin Lightning Network. Instant settlement, no KYC.

Disclaimer

All data and analysis is for educational and informational purposes only. Not financial advice. Not a registered investment advisor. Always do your own research.