annotate README.md @ 4:ccffaf75d240

refactor code
author Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
date Tue, 16 Nov 2021 17:45:28 +0100
parents e5f3f855e6f9
children 5063639df439
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
4
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
1 # fucking-black-scholes model
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
2
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
3 I'm a finance student trying to stop procrastinating and start studying my derivatives lectures. So, in order to
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
4 understand the Black-Scholes model, I built this simple command line tool. Which is far more interesting than memorizing
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
5 stupid stuff from the professor's slides.
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
6
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
7 ## Installation
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
8
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
9 ### Using PIP
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
10
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
11 ```bash
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
12 pip install fucking-black-scholes
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
13 ```
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
14
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
15 ### Manual
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
16
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
17 ```bash
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
18 git clone https://github.com/denniscm190/fucking-black-scholes.git
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
19 cd fucking-black-scholes
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
20 python setup.py install
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
21 ```
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
22
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
23 ## Usage
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
24
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
25 ```bash
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
26 fbs --help
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
27 ```
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
28
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
29 ### Examples
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
30
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
31 Price a European call option with the following data:
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
32 - Spot price = $20
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
33 - Exercise price = $21
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
34 - Risk free rate = 5%
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
35 - Standard deviation = 25%
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
36 - Time to expiration = 6 months
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
37
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
38 #### Command
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
39 ```bash
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
40 fbs --spot-price=20.00 --exercise-price=21.00 --risk-free-rate=0.05 --std=0.25 --expiration=0.5
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
41 ```
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
42
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
43 #### Output
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
44
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
45 ```bash
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
46 ---------------------------------------------
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
47 European call option price: 1.197698084193286
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
48 ---------------------------------------------
ccffaf75d240 refactor code
Dennis Concepcion Martin <dennisconcepcionmartin@gmail.com>
parents: 0
diff changeset
49 ```