Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add instructions/aostock/financial-data/claude-mdgit clone --depth 1 https://github.com/aostock/financial-dataWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00495 | $0.00495 |
| Opus 5 | $0.00247 | $0.00247 |
| Sonnet 5 | $0.00099 | $0.00099 |
| Haiku 4.5 | $0.00049 | $0.00049 |
Grade A, and why
financial-data CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 56 lines — stays where its author put it; the contents beside it link to each section on GitHub.
CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
Project Overview
This is a FastAPI-based financial data service that provides stock market information through RESTful APIs. The service uses Yahoo Finance (yfinance) as the primary data source to retrieve stock information, prices, news, financial statements, and other related data.
Code Architecture
- Main Application:
main.py- Contains all the API endpoints and FastAPI application setup - API Layer:
src/api/- Contains the business logic for fetching and processing financial data - Models:
src/models/- Pydantic models that define the structure of API responses - Common Utilities:
src/common/- Utility functions for caching, data conversion, and FastAPI response handling - Data Source: Uses Yahoo Finance (yfinance) library to fetch real-time financial data
Common Development Commands
Running the Application
source .venv/bin/activate
fastapi dev main.py
Dependencies
Dependencies are managed using uv (as indicated by pyproject.toml and uv.lock):
- Python version: >=3.12
- Main dependencies: fastapi, yfinance, financetoolkit, dotenv
API Structure
The API provides endpoints for:
- Ticker information (
/api/v1/ticker/info) - Stock prices (
/api/v1/ticker/prices) - News (
/api/v1/ticker/news) - Financial statements (income statement, balance sheet, cash flow)
- Insider transactions and holdings
- Financial metrics and calculations
- Ticker lookup/search functionality
Key Components
- Response Handling: All API responses follow a consistent format using
BaseResponsemodel with code, data, and message fields - Data Conversion: Utilities to convert between camelCase and snake_case naming conventions
- Caching: Built-in caching mechanism to improve performance and reduce API calls
- Error Handling: Centralized exception handling for consistent error responses
- Data Models: Comprehensive Pydantic models for all financial data types
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 3d ago First seen · 56 lines · 495 tokens per session scan A ac65a0b33eae
financial-data CLAUDE.md is an instructions file published in the GitHub repository aostock/financial-data (2 stars, last pushed 1y ago), licensed Apache-2.0. It adds 495 tokens to every session, about $0.0025 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other instructions, from other repositories
razorpay-mcp-server AGENTS.md
Instructions for razorpay/razorpay-mcp-server, covering agent instructions, project overview, key commands, contributing and code style.
lunchmoney-mcp CLAUDE.md
Instructions for akutishevsky/lunchmoney-mcp, covering claude.md, project overview, commands, architecture and tool implementation pattern.
secedgar-mcp-server AGENTS.md
Instructions for cyanheads/secedgar-mcp-server, covering agent protocol, core rules, what's next?, mcp surface and tools.
counterpoise-ledger CLAUDE.md
Instructions for jeffjjohnston/counterpoise-ledger, covering claude.md, project overview, development commands, essential commands and testing.
deckforge CLAUDE.md
Instructions for Whatsonyourmind/deckforge, covering deckforge, tech stack, project structure, key commands and local development.
optionsahoy-mcp AGENTS.md
Instructions for AlvisoOculus/optionsahoy-mcp, covering agents.md, what this repo is, what an agent should do with this server, how an agent connects and required-input discipline.