Feature/fundamentals

AUTHORS.rst

@@ -17,3 +17,4 @@ Contributors
 * Nima Yazdanmehr
 * Michael MacCormack
 * David Minnen
+* Tobias Kaesser <[email protected]>

HISTORY.rst

@@ -5,6 +5,7 @@ History
 0.14.0 (2020-12-XX - Unreleased)
 --------------------------------
 * Feature (Name #Number)
+* Feature: Added 3 new methods for fundamentals-endpoint: definitions, daily and statements
 * Development: Run tests in Github Actions instead of Travis.org
 * [/news] Fix bug in get_news() when sources list is empty (#566)
 

README.rst

@@ -106,6 +106,25 @@ Now you can use ``TiingoClient`` to make your API calls. (Other parameters are a
                               startDate='2017-01-01',
                               endDate='2017-08-31')
 
+  # Get definitions for fields available in the fundamentals-api, ticker is
+  # optional
+  definitions = get_fundamentals_definitions('GOOGL')
+
+  # Get fundamentals which require daily-updated (like marketCap). A start-
+  # and end-date can be passed. If omited, will get all available data.
+  fundamentals_daily = CLIENT.get_fundamentals_daily('GOOGL',
+                                          startDate='2020-01-01',
+                                          endDate='2020-12-31')
+
+  # Get fundamentals based on quarterly statements. Accepts time-range like
+  # daily-fundamentals. asReported can be set to get the data exactly like
+  # it was reported to SEC. Set to False if you want to get data containing
+  # corrections
+  fundamentals_stmnts = CLIENT.get_fundamentals_statements('GOOGL',
+                                                           startDate='2020-01-01',
+                                                           endDate='2020-12-31',
+                                                           asReported=True)
+
 
 To receive results in ``pandas`` format, use the ``get_dataframe()`` method:
 

tests/fixtures/fundamentals_daily.yaml

@@ -0,0 +1,40 @@
+interactions:
+- request:
+    body: null
+    headers:
+      Accept:
+      - '*/*'
+      Accept-Encoding:
+      - gzip, deflate
+      Authorization:
+      - Token 0000000000000000000000000000000000000000
+      Connection:
+      - keep-alive
+      Content-Type:
+      - application/json
+      User-Agent:
+      - tiingo-python-client 0.13.0
+    method: GET
+    uri: https://api.tiingo.com/tiingo/fundamentals/GOOGL/daily?startDate=2020-1-1&endDate=2020-4-1&format=json
+  response:
+    body:
+      string: '[{"date":"2019-12-31T00:00:00.000Z","marketCap":923760472316.1099853516,"enterpriseVal":920030472316.1099853516,"peRatio":27.0147236789,"pbRatio":4.5857391821,"trailingPEG1Y":1.3434349073},{"date":"2020-01-02T00:00:00.000Z","marketCap":943961417697.3199462891,"enterpriseVal":940231417697.3199462891,"peRatio":27.6054860831,"pbRatio":4.686020878,"trailingPEG1Y":1.372813362},{"date":"2020-01-03T00:00:00.000Z","marketCap":939023255562.4799804688,"enterpriseVal":935293255562.4799804688,"peRatio":27.4610730133,"pbRatio":4.6615068137,"trailingPEG1Y":1.365631739},{"date":"2020-01-06T00:00:00.000Z","marketCap":964052013086.6899414062,"enterpriseVal":960322013086.6899414062,"peRatio":28.1930213796,"pbRatio":4.7857547735,"trailingPEG1Y":1.4020313335},{"date":"2020-01-07T00:00:00.000Z","marketCap":962189856974.3900146484,"enterpriseVal":958459856974.3900146484,"peRatio":28.1385639371,"pbRatio":4.7765106431,"trailingPEG1Y":1.3993231796},{"date":"2020-01-08T00:00:00.000Z","marketCap":969038453342.9599609375,"enterpriseVal":965308453342.9599609375,"peRatio":28.338846309,"pbRatio":4.8105085004,"trailingPEG1Y":1.4092831678},{"date":"2020-01-09T00:00:00.000Z","marketCap":979211343215.7099609375,"enterpriseVal":975481343215.7099609375,"peRatio":28.6363453005,"pbRatio":4.8610088423,"trailingPEG1Y":1.4240777122},{"date":"2020-01-10T00:00:00.000Z","marketCap":985535777123.0400390625,"enterpriseVal":981805777123.0400390625,"peRatio":28.8212989109,"pbRatio":4.8924046481,"trailingPEG1Y":1.4332754053},{"date":"2020-01-13T00:00:00.000Z","marketCap":993170617183.4699707031,"enterpriseVal":989440617183.4699707031,"peRatio":29.0445744252,"pbRatio":4.9303055827,"trailingPEG1Y":1.4443788363},{"date":"2020-01-14T00:00:00.000Z","marketCap":986659967664.9100341797,"enterpriseVal":982929967664.9100341797,"peRatio":28.8541750706,"pbRatio":4.8979853639,"trailingPEG1Y":1.4349103278},{"date":"2020-01-15T00:00:00.000Z","marketCap":992598176600.8000488281,"enterpriseVal":988868176600.8000488281,"peRatio":29.027833804,"pbRatio":4.9274638685,"trailingPEG1Y":1.4435463297},{"date":"2020-01-16T00:00:00.000Z","marketCap":1000157151041.8399658203,"enterpriseVal":996427151041.8399658203,"peRatio":29.2488906817,"pbRatio":4.9649881904,"trailingPEG1Y":1.4545394285},{"date":"2020-01-17T00:00:00.000Z","marketCap":1020406374544.4799804688,"enterpriseVal":1016676374544.4799804688,"peRatio":29.8410649455,"pbRatio":5.0655095489,"trailingPEG1Y":1.4839880946},{"date":"2020-01-21T00:00:00.000Z","marketCap":1022289221280.25,"enterpriseVal":1018559221280.25,"peRatio":29.8961274708,"pbRatio":5.0748563918,"trailingPEG1Y":1.4867263391},{"date":"2020-01-22T00:00:00.000Z","marketCap":1023613421182.3299560547,"enterpriseVal":1019883421182.3299560547,"peRatio":29.9348527632,"pbRatio":5.0814299956,"trailingPEG1Y":1.4886521374},{"date":"2020-01-23T00:00:00.000Z","marketCap":1023972058655.8100585938,"enterpriseVal":1020242058655.8100585938,"peRatio":29.9453408633,"pbRatio":5.0832103467,"trailingPEG1Y":1.4891737078},{"date":"2020-01-24T00:00:00.000Z","marketCap":1011199047100.3299560547,"enterpriseVal":1007469047100.3299560547,"peRatio":29.5718031464,"pbRatio":5.0198024598,"trailingPEG1Y":1.4705977781},{"date":"2020-01-27T00:00:00.000Z","marketCap":987446211356.7700195312,"enterpriseVal":983716211356.7700195312,"peRatio":28.877168213,"pbRatio":4.9018884411,"trailingPEG1Y":1.4360537706},{"date":"2020-01-28T00:00:00.000Z","marketCap":1000391644774.5,"enterpriseVal":996661644774.5,"peRatio":29.2557482856,"pbRatio":4.966152266,"trailingPEG1Y":1.4548804553},{"date":"2020-01-29T00:00:00.000Z","marketCap":1004667706958.3000488281,"enterpriseVal":1000937706958.3000488281,"peRatio":29.3807987092,"pbRatio":4.9873795284,"trailingPEG1Y":1.461099179},{"date":"2020-01-30T00:00:00.000Z","marketCap":1002977972708.25,"enterpriseVal":999247972708.25,"peRatio":29.3313836224,"pbRatio":4.978991336,"trailingPEG1Y":1.4586417801},{"date":"2020-01-31T00:00:00.000Z","marketCap":988170383178.2199707031,"enterpriseVal":984440383178.2199707031,"peRatio":28.8983461073,"pbRatio":4.9054833807,"trailingPEG1Y":1.4371069416},{"date":"2020-02-03T00:00:00.000Z","marketCap":1022530611887.4000244141,"enterpriseVal":1018800611887.4000244141,"peRatio":29.9031867689,"pbRatio":5.076054705,"trailingPEG1Y":1.4870773961},{"date":"2020-02-04T00:00:00.000Z","marketCap":993410187346.9000244141,"enterpriseVal":989680187346.9000244141,"peRatio":29.1530859217,"pbRatio":4.9487253684,"trailingPEG1Y":1.4497750837},{"date":"2020-02-05T00:00:00.000Z","marketCap":993850050444.5,"enterpriseVal":990120050444.5,"peRatio":29.1659943526,"pbRatio":4.9509165697,"trailingPEG1Y":1.4504170165},{"date":"2020-02-06T00:00:00.000Z","marketCap":1014413650257.3000488281,"enterpriseVal":1010683650257.3000488281,"peRatio":29.7694634933,"pbRatio":5.0533552293,"trailingPEG1Y":1.4804273737},{"date":"2020-02-07T00:00:00.000Z","marketCap":1016571728579.9000244141,"enterpriseVal":1012841728579.9000244141,"peRatio":29.832795482,"pbRatio":5.0641058106,"trailingPEG1Y":1.4835768564},{"date":"2020-02-10T00:00:00.000Z","marketCap":1036881032539.4000244141,"enterpriseVal":1033151032539.4000244141,"peRatio":30.4288019363,"pbRatio":5.165277682,"trailingPEG1Y":1.5132160963},{"date":"2020-02-11T00:00:00.000Z","marketCap":1037843233065.4000244141,"enterpriseVal":1034113233065.4000244141,"peRatio":30.4570391287,"pbRatio":5.1700709347,"trailingPEG1Y":1.5146203242},{"date":"2020-02-12T00:00:00.000Z","marketCap":1043733274856.6999511719,"enterpriseVal":1040003274856.6999511719,"peRatio":30.6298910851,"pbRatio":5.1994124893,"trailingPEG1Y":1.5232162053},{"date":"2020-02-13T00:00:00.000Z","marketCap":1040131895745.0999755859,"enterpriseVal":1036401895745.0999755859,"peRatio":30.5242033078,"pbRatio":5.1814720289,"trailingPEG1Y":1.5179603807},{"date":"2020-02-14T00:00:00.000Z","marketCap":1043802003465.6999511719,"enterpriseVal":1040072003465.6999511719,"peRatio":30.6319080274,"pbRatio":5.1997548645,"trailingPEG1Y":1.5233165073},{"date":"2020-02-18T00:00:00.000Z","marketCap":1044289976589.5999755859,"enterpriseVal":1040559976589.5999755859,"peRatio":30.6462283179,"pbRatio":5.2021857284,"trailingPEG1Y":1.5240286515},{"date":"2020-02-19T00:00:00.000Z","marketCap":1048021940058.3000488281,"enterpriseVal":1044291940058.3000488281,"peRatio":30.7557482856,"pbRatio":5.2207767018,"trailingPEG1Y":1.5294750499},{"date":"2020-02-20T00:00:00.000Z","marketCap":1042606125669.0999755859,"enterpriseVal":1038876125669.0999755859,"peRatio":30.5968132311,"pbRatio":5.1937975361,"trailingPEG1Y":1.5215712526},{"date":"2020-02-21T00:00:00.000Z","marketCap":1019561423071.4000244141,"enterpriseVal":1015831423071.4000244141,"peRatio":29.9205324728,"pbRatio":5.0789991317,"trailingPEG1Y":1.4879399932},{"date":"2020-02-24T00:00:00.000Z","marketCap":975850027747.4000244141,"enterpriseVal":972120027747.4000244141,"peRatio":28.6377571601,"pbRatio":4.861248505,"trailingPEG1Y":1.4241479236},{"date":"2020-02-25T00:00:00.000Z","marketCap":952798452288.8000488281,"enterpriseVal":949068452288.8000488281,"peRatio":27.9612747075,"pbRatio":4.7464158631,"trailingPEG1Y":1.3905066341},{"date":"2020-02-26T00:00:00.000Z","marketCap":955650689562.3000488281,"enterpriseVal":951920689562.3000488281,"peRatio":28.0449778136,"pbRatio":4.7606244339,"trailingPEG1Y":1.3946691669},{"date":"2020-02-27T00:00:00.000Z","marketCap":903746844045.5,"enterpriseVal":900016844045.5,"peRatio":26.521782977,"pbRatio":4.5020626834,"trailingPEG1Y":1.3189210994},{"date":"2020-02-28T00:00:00.000Z","marketCap":920447896032.5,"enterpriseVal":916717896032.5,"peRatio":27.0118999597,"pbRatio":4.5852598568,"trailingPEG1Y":1.3432944845},{"date":"2020-03-02T00:00:00.000Z","marketCap":952798452288.8000488281,"enterpriseVal":949068452288.8000488281,"peRatio":27.9612747075,"pbRatio":4.7464158631,"trailingPEG1Y":1.3905066341},{"date":"2020-03-03T00:00:00.000Z","marketCap":919396348314.8000488281,"enterpriseVal":915666348314.8000488281,"peRatio":26.9810407422,"pbRatio":4.5800215162,"trailingPEG1Y":1.3417598639},{"date":"2020-03-04T00:00:00.000Z","marketCap":949554461944.0,"enterpriseVal":945824461944.0,"peRatio":27.8660750303,"pbRatio":4.7302557537,"trailingPEG1Y":1.3857723799},{"date":"2020-03-05T00:00:00.000Z","marketCap":903616259688.4000244141,"enterpriseVal":899886259688.4000244141,"peRatio":26.5179507866,"pbRatio":4.5014121705,"trailingPEG1Y":1.3187305256},{"date":"2020-03-06T00:00:00.000Z","marketCap":890544078256.5999755859,"enterpriseVal":886814078256.5999755859,"peRatio":26.1343283582,"pbRatio":4.4362924076,"trailingPEG1Y":1.2996530859},{"date":"2020-03-09T00:00:00.000Z","marketCap":835595555361.0999755859,"enterpriseVal":831865555361.0999755859,"peRatio":24.521782977,"pbRatio":4.1625634357,"trailingPEG1Y":1.2194616399},{"date":"2020-03-10T00:00:00.000Z","marketCap":876406603385.3000488281,"enterpriseVal":872676603385.3000488281,"peRatio":25.7194433239,"pbRatio":4.3658658291,"trailingPEG1Y":1.2790209653},{"date":"2020-03-11T00:00:00.000Z","marketCap":832234726381.0,"enterpriseVal":828504726381.0,"peRatio":24.4231544978,"pbRatio":4.1458212885,"trailingPEG1Y":1.2145568723},{"date":"2020-03-12T00:00:00.000Z","marketCap":763952853339.5,"enterpriseVal":760222853339.5,"peRatio":22.4193223074,"pbRatio":3.805671528,"trailingPEG1Y":1.1149068391},{"date":"2020-03-13T00:00:00.000Z","marketCap":834550880504.3000488281,"enterpriseVal":830820880504.3000488281,"peRatio":24.4911254538,"pbRatio":4.1573593327,"trailingPEG1Y":1.2179370496},{"date":"2020-03-16T00:00:00.000Z","marketCap":737457974570.0,"enterpriseVal":733727974570.0,"peRatio":21.6417910448,"pbRatio":3.6736858886,"trailingPEG1Y":1.0762404195},{"date":"2020-03-17T00:00:00.000Z","marketCap":768427085785.4000244141,"enterpriseVal":764697085785.4000244141,"peRatio":22.5506252521,"pbRatio":3.8279601534,"trailingPEG1Y":1.121436499},{"date":"2020-03-18T00:00:00.000Z","marketCap":749959708547.0999755859,"enterpriseVal":746229708547.0999755859,"peRatio":22.008672852,"pbRatio":3.7359639374,"trailingPEG1Y":1.0944853526},{"date":"2020-03-19T00:00:00.000Z","marketCap":764035327670.3000488281,"enterpriseVal":760305327670.3000488281,"peRatio":22.4217426382,"pbRatio":3.8060823782,"trailingPEG1Y":1.1150272015},{"date":"2020-03-20T00:00:00.000Z","marketCap":734165874198.9000244141,"enterpriseVal":730435874198.9000244141,"peRatio":21.5451795079,"pbRatio":3.6572861166,"trailingPEG1Y":1.0714359539},{"date":"2020-03-23T00:00:00.000Z","marketCap":724488886051.6999511719,"enterpriseVal":720758886051.6999511719,"peRatio":21.2611940299,"pbRatio":3.6090796885,"trailingPEG1Y":1.0573134328},{"date":"2020-03-24T00:00:00.000Z","marketCap":776640154560.9000244141,"enterpriseVal":772910154560.9000244141,"peRatio":22.7916498588,"pbRatio":3.8688739898,"trailingPEG1Y":1.1334225876},{"date":"2020-03-25T00:00:00.000Z","marketCap":757128102465.8000488281,"enterpriseVal":753398102465.8000488281,"peRatio":22.2190399355,"pbRatio":3.7716736707,"trailingPEG1Y":1.1049468508},{"date":"2020-03-26T00:00:00.000Z","marketCap":799258739782.8000488281,"enterpriseVal":795528739782.8000488281,"peRatio":23.4554255748,"pbRatio":3.9815496679,"trailingPEG1Y":1.1664319745},{"date":"2020-03-27T00:00:00.000Z","marketCap":763066254283.4000244141,"enterpriseVal":759336254283.4000244141,"peRatio":22.3933037515,"pbRatio":3.8012548879,"trailingPEG1Y":1.1136129433},{"date":"2020-03-30T00:00:00.000Z","marketCap":787842917827.9000244141,"enterpriseVal":784112917827.9000244141,"peRatio":23.1204114562,"pbRatio":3.9246811472,"trailingPEG1Y":1.149771813},{"date":"2020-03-31T00:00:00.000Z","marketCap":798592072275.5,"enterpriseVal":794440072275.5,"peRatio":23.2576060849,"pbRatio":3.921221612,"trailingPEG1Y":5.8633649024},{"date":"2020-04-01T00:00:00.000Z","marketCap":757457999789.0,"enterpriseVal":753305999789.0,"peRatio":22.0596477182,"pbRatio":3.7192463863,"trailingPEG1Y":5.5613532932}]'
+    headers:
+      allow:
+      - GET, HEAD, OPTIONS
+      content-length:
+      - '11840'
+      content-type:
+      - application/json
+      date:
+      - Sat, 06 Feb 2021 16:23:38 GMT
+      server:
+      - nginx/1.14.0 (Ubuntu)
+      vary:
+      - Accept, Cookie, Origin
+      x-frame-options:
+      - SAMEORIGIN
+    status:
+      code: 200
+      message: OK
+version: 1