git404hub

what is price-attribution fr?

kkxatm007/price-attribution — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · researcherComplexity · 3/5Setup · moderate

tl;dr

A tool that turns a stock's price history into phase-by-phase charts with computed, not guessed, returns tied to real events.

vibe map

mindmap
  root((price-attribution))
    What it does
      Splits stock history into phases
      Computes real returns
      Charts events and catalysts
    Tech stack
      Python
      Plotly
      yfinance
      akshare
    Use cases
      Explain a stock price move
      Build shareable price charts
      Verify claimed returns
    Audience
      Investors
      Analysts
      AI agent engineers
    Setup
      Clone repo
      Run install script
      pip install requirements

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Break down why a stock's price moved by computing real returns for each phase instead of guessing.

VIBE 2

Generate an interactive chart showing earnings, ratings, and financing events on a price history.

VIBE 3

Create a shareable, high resolution price attribution image for social media.

VIBE 4

Check whether a claimed stock return story actually matches the computed numbers.

what's the stack?

PythonPlotlyyfinanceakshare

how it stacks up fr

kkxatm007/price-attribution0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity3/52/54/5
Audienceresearchergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires cloning the repo, running an install script, and installing Python dependencies before generating a chart.

The README shown here does not state a license for this project.

in plain english

Price-attribution is a tool that helps answer the question of why a stock's price moved the way it did, by breaking its price history into phases and tying each phase to real, computed numbers rather than guesses. The core problem it addresses is that people often explain stock moves with hand-typed percentages that turn out to be wrong once actually calculated, or by cherry-picking only the good quarters while ignoring the bad ones that better explain a drop. You give the tool a JSON file describing a stock, a date range, and a set of phases and events you care about, such as earnings reports, analyst rating changes, or financing actions. From that single spec file, the tool produces either an interactive chart you can explore in a web browser, or a high resolution image ready to share on social media. Crucially, the percentage return shown for each phase is calculated directly from real price data, not typed in by hand, so the numbers cannot drift from reality or be adjusted to fit a story. The project is designed to work well with AI coding assistants like Claude Code, but it can also be used as plain command line Python scripts without any AI agent involved. It supports stock markets in China, the United States, Japan, Hong Kong, Taiwan, and South Korea, pulling price data through existing finance data libraries. A notable design choice is what the author calls a playbook: a set of strict rules meant to prevent common mistakes, like crediting the wrong date for a stock move or mixing up a company's fiscal year with the calendar year. These rules are meant to keep an AI assistant honest by forcing it to rely on code that computes numbers rather than letting it guess or make things up. Getting started involves cloning the repository, running an install script, and installing Python dependencies. From there, someone can either ask an AI agent in plain language to build a chart for a specific stock, or write and run a spec file manually using the included Python scripts. The README does not state a license for this project.

prompts (copy fr)

prompt 1
Decompose this stock's price history since IPO into phases with computed returns.
prompt 2
Make a shareable price attribution chart for a stock from 2022 to now.
prompt 3
Explain how this tool avoids crediting the wrong date for a stock's price move.
prompt 4
Help me write a spec.json file to chart a specific stock's phases and events.

Frequently asked questions

what is price-attribution fr?

A tool that turns a stock's price history into phase-by-phase charts with computed, not guessed, returns tied to real events.

What language is price-attribution written in?

Mainly Python. The stack also includes Python, Plotly, yfinance.

What license does price-attribution use?

The README shown here does not state a license for this project.

How hard is price-attribution to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is price-attribution for?

Mainly researcher.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.