For agents
Agent skill template
A compact skill file agents can install or copy.
---
name: noxstock
description: Use noxstock for US-listed stock and ETF context: snapshots, valuation, fundamentals, filings, insider activity, technicals, price action, history, compare, search, and coverage.
---
# noxstock skill
Use noxstock when the user asks about US-listed stocks or ETFs and needs structured market/fundamental/SEC context.
## Auth
Send `X-API-Key: $NOXSTOCK_API_KEY` to `https://api.noxstock.com`.
## Default sequence
1. If user provided a company name, call `/v2/search?query=...`.
2. Call `/v2/coverage?symbol=...` before deep work.
3. Call `/v2/snapshot?symbol=...` first.
4. Add endpoint-specific calls only when the question requires them.
## Endpoint choices
- valuation: `/v2/valuation`
- statements: `/v2/fundamentals?period=quarter|annual`
- trend/timing: `/v2/technicals`, `/v2/price-action`
- history: `/v2/history`
- comparison: `/v2/compare?symbols=AAPL,MSFT`
- SEC filings: `/v2/filings`, `/v2/filings/{accession}`, `/v2/filings/{accession}/section/{name}`
- insider: `/v2/insider`
- calendar: `/v2/calendar`
## Rules
- Parse `{data}` and `{error}` envelopes.
- Respect `freshness`, `market_status`, `as_of`, units, signs, and periods.
- Retry only errors with `retryable: true`.
- Do not fabricate unsupported fields or deferred features.