├── .github ├── FUNDING.yml └── workflows │ ├── python-package.yml │ └── python-publish.yml ├── .gitignore ├── LICENSE ├── README.md ├── edgar ├── archives.py ├── client.py ├── companies.py ├── current_events.py ├── datasets.py ├── enums.py ├── filings.py ├── issuers.py ├── mutual_funds.py ├── ownership_filings.py ├── parser.py ├── parser │ └── xbrl.py ├── parsing │ ├── __init__.py │ ├── country_code.html │ ├── dropdown_html.html │ ├── parse_country.py │ └── state_codes.html ├── series.py ├── session.py ├── submissions.py ├── utilis.py ├── variable_insurance_products.py └── xbrl.py ├── requirements.txt ├── resources ├── data-sources-fasb.md ├── data-sources-other.md ├── data-sources-sec.md ├── data │ ├── sec_xbrl_scrape_content.csv │ └── sec_xbrl_scrape_values.csv ├── docs │ ├── SEC Scraping Documentation.docx │ ├── notes-sec-scraping.md │ └── notes-why-xbrl.md ├── label_tags.xlsx ├── sec-text-search-examples.md ├── sec_xbrl_parsing.py └── technical-guides │ ├── edgar-technical-guides.zip │ ├── edgar-xbrl-guide.pdf │ ├── gaap-xbrl-guide.pdf │ ├── technical-guides-form-13 │ ├── EDGAR Form 13F Stylesheets.zip │ ├── EDGAR Form 13F XML Samples.zip │ ├── EDGAR Form 13F XML Schema Files.zip │ └── EDGAR Form 13F XML Technical Specification.pdf │ └── technical-guides-ifrs │ ├── FRC-2019-Taxonomy-Report-IFRS-mapping.xlsx │ └── IFRST_2019-03-27 │ ├── META-INF │ ├── catalog.xml │ └── taxonomyPackage.xml │ ├── basic_ifrs_entry_point_2019-03-27.xsd │ ├── combined_entry_point_2019-03-27.xsd │ ├── depr_entry_point_2019-03-27.xsd │ ├── deprecated │ ├── depr-doc_full_ifrs-en_2019-03-27.xml │ ├── depr-doc_ifrs_for_smes-en_2019-03-27.xml │ ├── depr-doc_mc-en_2019-03-27.xml │ ├── depr-lab_full_ifrs-en_2019-03-27.xml │ ├── depr-lab_ifrs-en_2019-03-27.xml │ ├── depr-lab_ifrs_for_smes-en_2019-03-27.xml │ ├── depr-lab_mc-en_2019-03-27.xml │ ├── full_ifrs-depr_2019-03-27.xsd │ ├── ifrs-depr_2019-03-27.xsd │ ├── ifrs_for_smes-depr_2019-03-27.xsd │ └── mc-depr_2019-03-27.xsd │ ├── full_ifrs │ ├── dimensions │ │ ├── dim_full_ifrs_2019-03-27_role-901000.xml │ │ ├── dim_full_ifrs_2019-03-27_role-901100.xml │ │ ├── dim_full_ifrs_2019-03-27_role-901500.xml │ │ ├── dim_full_ifrs_2019-03-27_role-903000.xml │ │ ├── dim_full_ifrs_2019-03-27_role-904000.xml │ │ ├── dim_full_ifrs_2019-03-27_role-913000.xml │ │ ├── dim_full_ifrs_2019-03-27_role-990000.xml │ │ ├── gla_full_ifrs-dim_2019-03-27-en.xml │ │ ├── gre_full_ifrs-dim_2019-03-27.xml │ │ ├── pre_full_ifrs_2019-03-27_role-901000.xml │ │ ├── pre_full_ifrs_2019-03-27_role-901100.xml │ │ ├── pre_full_ifrs_2019-03-27_role-901500.xml │ │ ├── pre_full_ifrs_2019-03-27_role-903000.xml │ │ ├── pre_full_ifrs_2019-03-27_role-904000.xml │ │ ├── pre_full_ifrs_2019-03-27_role-913000.xml │ │ ├── pre_full_ifrs_2019-03-27_role-990000.xml │ │ └── rol_full_ifrs-dim_2019-03-27.xsd │ ├── full_ifrs-cor_2019-03-27.xsd │ ├── labels │ │ ├── doc_full_ifrs-en_2019-03-27.xml │ │ ├── in_full_ifrs-en_2019-03-27.xml │ │ └── lab_full_ifrs-en_2019-03-27.xml │ └── linkbases │ │ ├── ias_1 │ │ ├── cal_ias_1_2019-03-27_role-210000.xml │ │ ├── cal_ias_1_2019-03-27_role-220000.xml │ │ ├── cal_ias_1_2019-03-27_role-310000.xml │ │ ├── cal_ias_1_2019-03-27_role-320000.xml │ │ ├── cal_ias_1_2019-03-27_role-410000.xml │ │ ├── cal_ias_1_2019-03-27_role-420000.xml │ │ ├── cal_ias_1_2019-03-27_role-610000.xml │ │ ├── cal_ias_1_2019-03-27_role-800100.xml │ │ ├── cal_ias_1_2019-03-27_role-800200.xml │ │ ├── cal_ias_1_2019-03-27_role-861200.xml │ │ ├── cal_ias_1_2019-03-27_role-880000.xml │ │ ├── def_ias_1_2019-03-27_role-310000.xml │ │ ├── def_ias_1_2019-03-27_role-320000.xml │ │ ├── def_ias_1_2019-03-27_role-610000.xml │ │ ├── def_ias_1_2019-03-27_role-810000.xml │ │ ├── def_ias_1_2019-03-27_role-861000.xml │ │ ├── def_ias_1_2019-03-27_role-861200.xml │ │ ├── gla_ias_1_2019-03-27-en.xml │ │ ├── gre_ias_1_2019-03-27.xml │ │ ├── pre_ias_1_2019-03-27_role-110000.xml │ │ ├── pre_ias_1_2019-03-27_role-210000.xml │ │ ├── pre_ias_1_2019-03-27_role-220000.xml │ │ ├── pre_ias_1_2019-03-27_role-310000.xml │ │ ├── pre_ias_1_2019-03-27_role-320000.xml │ │ ├── pre_ias_1_2019-03-27_role-410000.xml │ │ ├── pre_ias_1_2019-03-27_role-420000.xml │ │ ├── pre_ias_1_2019-03-27_role-610000.xml │ │ ├── pre_ias_1_2019-03-27_role-800100.xml │ │ ├── pre_ias_1_2019-03-27_role-800200.xml │ │ ├── pre_ias_1_2019-03-27_role-800400.xml │ │ ├── pre_ias_1_2019-03-27_role-800500.xml │ │ ├── pre_ias_1_2019-03-27_role-800600.xml │ │ ├── pre_ias_1_2019-03-27_role-810000.xml │ │ ├── pre_ias_1_2019-03-27_role-861000.xml │ │ ├── pre_ias_1_2019-03-27_role-861200.xml │ │ ├── pre_ias_1_2019-03-27_role-880000.xml │ │ ├── ref_ias_1_2019-03-27.xml │ │ └── rol_ias_1_2019-03-27.xsd │ │ ├── ias_10 │ │ ├── def_ias_10_2019-03-27_role-815000.xml │ │ ├── gla_ias_10_2019-03-27-en.xml │ │ ├── gre_ias_10_2019-03-27.xml │ │ ├── pre_ias_10_2019-03-27_role-815000.xml │ │ ├── ref_ias_10_2019-03-27.xml │ │ └── rol_ias_10_2019-03-27.xsd │ │ ├── ias_12 │ │ ├── cal_ias_12_2019-03-27_role-835110.xml │ │ ├── def_ias_12_2019-03-27_role-835110.xml │ │ ├── gla_ias_12_2019-03-27-en.xml │ │ ├── gre_ias_12_2019-03-27.xml │ │ ├── pre_ias_12_2019-03-27_role-835110.xml │ │ ├── ref_ias_12_2019-03-27.xml │ │ └── rol_ias_12_2019-03-27.xsd │ │ ├── ias_16 │ │ ├── cal_ias_16_2019-03-27_role-822100.xml │ │ ├── def_ias_16_2019-03-27_role-822100.xml │ │ ├── gla_ias_16_2019-03-27-en.xml │ │ ├── gre_ias_16_2019-03-27.xml │ │ ├── pre_ias_16_2019-03-27_role-822100.xml │ │ ├── ref_ias_16_2019-03-27.xml │ │ └── rol_ias_16_2019-03-27.xsd │ │ ├── ias_19 │ │ ├── cal_ias_19_2019-03-27_role-834480.xml │ │ ├── def_ias_19_2019-03-27_role-834480.xml │ │ ├── gla_ias_19_2019-03-27-en.xml │ │ ├── gre_ias_19_2019-03-27.xml │ │ ├── pre_ias_19_2019-03-27_role-834480.xml │ │ ├── ref_ias_19_2019-03-27.xml │ │ └── rol_ias_19_2019-03-27.xsd │ │ ├── ias_2 │ │ ├── gla_ias_2_2019-03-27-en.xml │ │ ├── gre_ias_2_2019-03-27.xml │ │ ├── pre_ias_2_2019-03-27_role-826380.xml │ │ ├── ref_ias_2_2019-03-27.xml │ │ └── rol_ias_2_2019-03-27.xsd │ │ ├── ias_20 │ │ ├── gla_ias_20_2019-03-27-en.xml │ │ ├── gre_ias_20_2019-03-27.xml │ │ ├── pre_ias_20_2019-03-27_role-831400.xml │ │ ├── ref_ias_20_2019-03-27.xml │ │ └── rol_ias_20_2019-03-27.xsd │ │ ├── ias_21 │ │ ├── gla_ias_21_2019-03-27-en.xml │ │ ├── gre_ias_21_2019-03-27.xml │ │ ├── pre_ias_21_2019-03-27_role-842000.xml │ │ ├── ref_ias_21_2019-03-27.xml │ │ └── rol_ias_21_2019-03-27.xsd │ │ ├── ias_23 │ │ ├── cal_ias_23_2019-03-27_role-836200.xml │ │ ├── gla_ias_23_2019-03-27-en.xml │ │ ├── gre_ias_23_2019-03-27.xml │ │ ├── pre_ias_23_2019-03-27_role-836200.xml │ │ ├── ref_ias_23_2019-03-27.xml │ │ └── rol_ias_23_2019-03-27.xsd │ │ ├── ias_24 │ │ ├── def_ias_24_2019-03-27_role-818000.xml │ │ ├── gla_ias_24_2019-03-27-en.xml │ │ ├── gre_ias_24_2019-03-27.xml │ │ ├── pre_ias_24_2019-03-27_role-818000.xml │ │ ├── ref_ias_24_2019-03-27.xml │ │ └── rol_ias_24_2019-03-27.xsd │ │ ├── ias_26 │ │ ├── cal_ias_26_2019-03-27_role-710000.xml │ │ ├── gla_ias_26_2019-03-27-en.xml │ │ ├── gre_ias_26_2019-03-27.xml │ │ ├── pre_ias_26_2019-03-27_role-710000.xml │ │ ├── ref_ias_26_2019-03-27.xml │ │ └── rol_ias_26_2019-03-27.xsd │ │ ├── ias_27 │ │ ├── def_ias_27_2019-03-27_role-825480.xml │ │ ├── gla_ias_27_2019-03-27-en.xml │ │ ├── gre_ias_27_2019-03-27.xml │ │ ├── pre_ias_27_2019-03-27_role-825480.xml │ │ ├── ref_ias_27_2019-03-27.xml │ │ └── rol_ias_27_2019-03-27.xsd │ │ ├── ias_29 │ │ ├── gla_ias_29_2019-03-27-en.xml │ │ ├── gre_ias_29_2019-03-27.xml │ │ ├── pre_ias_29_2019-03-27_role-816000.xml │ │ ├── ref_ias_29_2019-03-27.xml │ │ └── rol_ias_29_2019-03-27.xsd │ │ ├── ias_33 │ │ ├── cal_ias_33_2019-03-27_role-838000.xml │ │ ├── gla_ias_33_2019-03-27-en.xml │ │ ├── gre_ias_33_2019-03-27.xml │ │ ├── pre_ias_33_2019-03-27_role-838000.xml │ │ ├── ref_ias_33_2019-03-27.xml │ │ └── rol_ias_33_2019-03-27.xsd │ │ ├── ias_34 │ │ ├── gla_ias_34_2019-03-27-en.xml │ │ ├── gre_ias_34_2019-03-27.xml │ │ ├── pre_ias_34_2019-03-27_role-813000.xml │ │ ├── ref_ias_34_2019-03-27.xml │ │ └── rol_ias_34_2019-03-27.xsd │ │ ├── ias_36 │ │ ├── def_ias_36_2019-03-27_role-832410.xml │ │ ├── gla_ias_36_2019-03-27-en.xml │ │ ├── gre_ias_36_2019-03-27.xml │ │ ├── pre_ias_36_2019-03-27_role-832410.xml │ │ ├── ref_ias_36_2019-03-27.xml │ │ └── rol_ias_36_2019-03-27.xsd │ │ ├── ias_37 │ │ ├── cal_ias_37_2019-03-27_role-827570.xml │ │ ├── def_ias_37_2019-03-27_role-827570.xml │ │ ├── gla_ias_37_2019-03-27-en.xml │ │ ├── gre_ias_37_2019-03-27.xml │ │ ├── pre_ias_37_2019-03-27_role-827570.xml │ │ ├── ref_ias_37_2019-03-27.xml │ │ └── rol_ias_37_2019-03-27.xsd │ │ ├── ias_38 │ │ ├── cal_ias_38_2019-03-27_role-823180.xml │ │ ├── def_ias_38_2019-03-27_role-823180.xml │ │ ├── gla_ias_38_2019-03-27-en.xml │ │ ├── gre_ias_38_2019-03-27.xml │ │ ├── pre_ias_38_2019-03-27_role-823180.xml │ │ ├── ref_ias_38_2019-03-27.xml │ │ └── rol_ias_38_2019-03-27.xsd │ │ ├── ias_40 │ │ ├── cal_ias_40_2019-03-27_role-825100.xml │ │ ├── def_ias_40_2019-03-27_role-825100.xml │ │ ├── gla_ias_40_2019-03-27-en.xml │ │ ├── gre_ias_40_2019-03-27.xml │ │ ├── pre_ias_40_2019-03-27_role-825100.xml │ │ ├── ref_ias_40_2019-03-27.xml │ │ └── rol_ias_40_2019-03-27.xsd │ │ ├── ias_41 │ │ ├── cal_ias_41_2019-03-27_role-824180.xml │ │ ├── def_ias_41_2019-03-27_role-824180.xml │ │ ├── gla_ias_41_2019-03-27-en.xml │ │ ├── gre_ias_41_2019-03-27.xml │ │ ├── pre_ias_41_2019-03-27_role-824180.xml │ │ ├── ref_ias_41_2019-03-27.xml │ │ └── rol_ias_41_2019-03-27.xsd │ │ ├── ias_7 │ │ ├── cal_ias_7_2019-03-27_role-510000.xml │ │ ├── cal_ias_7_2019-03-27_role-520000.xml │ │ ├── cal_ias_7_2019-03-27_role-851100.xml │ │ ├── def_ias_7_2019-03-27_role-851100.xml │ │ ├── gla_ias_7_2019-03-27-en.xml │ │ ├── gre_ias_7_2019-03-27.xml │ │ ├── pre_ias_7_2019-03-27_role-510000.xml │ │ ├── pre_ias_7_2019-03-27_role-520000.xml │ │ ├── pre_ias_7_2019-03-27_role-800300.xml │ │ ├── pre_ias_7_2019-03-27_role-851100.xml │ │ ├── ref_ias_7_2019-03-27.xml │ │ └── rol_ias_7_2019-03-27.xsd │ │ ├── ias_8 │ │ ├── def_ias_8_2019-03-27_role-811000.xml │ │ ├── gla_ias_8_2019-03-27-en.xml │ │ ├── gre_ias_8_2019-03-27.xml │ │ ├── pre_ias_8_2019-03-27_role-811000.xml │ │ ├── ref_ias_8_2019-03-27.xml │ │ └── rol_ias_8_2019-03-27.xsd │ │ ├── ifric_2 │ │ ├── gla_ifric_2_2019-03-27-en.xml │ │ ├── gre_ifric_2_2019-03-27.xml │ │ ├── pre_ifric_2_2019-03-27_role-868500.xml │ │ ├── ref_ifric_2_2019-03-27.xml │ │ └── rol_ifric_2_2019-03-27.xsd │ │ ├── ifric_5 │ │ ├── gla_ifric_5_2019-03-27-en.xml │ │ ├── gre_ifric_5_2019-03-27.xml │ │ ├── pre_ifric_5_2019-03-27_role-868200.xml │ │ ├── ref_ifric_5_2019-03-27.xml │ │ └── rol_ifric_5_2019-03-27.xsd │ │ ├── ifrs_1 │ │ ├── def_ifrs_1_2019-03-27_role-819100.xml │ │ ├── gla_ifrs_1_2019-03-27-en.xml │ │ ├── gre_ifrs_1_2019-03-27.xml │ │ ├── pre_ifrs_1_2019-03-27_role-819100.xml │ │ ├── ref_ifrs_1_2019-03-27.xml │ │ └── rol_ifrs_1_2019-03-27.xsd │ │ ├── ifrs_12 │ │ ├── def_ifrs_12_2019-03-27_role-825700.xml │ │ ├── gla_ifrs_12_2019-03-27-en.xml │ │ ├── gre_ifrs_12_2019-03-27.xml │ │ ├── pre_ifrs_12_2019-03-27_role-825700.xml │ │ ├── ref_ifrs_12_2019-03-27.xml │ │ └── rol_ifrs_12_2019-03-27.xsd │ │ ├── ifrs_13 │ │ ├── cal_ifrs_13_2019-03-27_role-823000.xml │ │ ├── def_ifrs_13_2019-03-27_role-823000.xml │ │ ├── gla_ifrs_13_2019-03-27-en.xml │ │ ├── gre_ifrs_13_2019-03-27.xml │ │ ├── pre_ifrs_13_2019-03-27_role-823000.xml │ │ ├── ref_ifrs_13_2019-03-27.xml │ │ └── rol_ifrs_13_2019-03-27.xsd │ │ ├── ifrs_14 │ │ ├── cal_ifrs_14_2019-03-27_role-824500.xml │ │ ├── def_ifrs_14_2019-03-27_role-824500.xml │ │ ├── gla_ifrs_14_2019-03-27-en.xml │ │ ├── gre_ifrs_14_2019-03-27.xml │ │ ├── pre_ifrs_14_2019-03-27_role-824500.xml │ │ ├── ref_ifrs_14_2019-03-27.xml │ │ └── rol_ifrs_14_2019-03-27.xsd │ │ ├── ifrs_15 │ │ ├── cal_ifrs_15_2019-03-27_role-831150.xml │ │ ├── def_ifrs_15_2019-03-27_role-831150.xml │ │ ├── gla_ifrs_15_2019-03-27-en.xml │ │ ├── gre_ifrs_15_2019-03-27.xml │ │ ├── pre_ifrs_15_2019-03-27_role-831150.xml │ │ ├── ref_ifrs_15_2019-03-27.xml │ │ └── rol_ifrs_15_2019-03-27.xsd │ │ ├── ifrs_16 │ │ ├── cal_ifrs_16_2019-03-27_role-832610.xml │ │ ├── def_ifrs_16_2019-03-27_role-832610.xml │ │ ├── gla_ifrs_16_2019-03-27-en.xml │ │ ├── gre_ifrs_16_2019-03-27.xml │ │ ├── pre_ifrs_16_2019-03-27_role-832610.xml │ │ ├── ref_ifrs_16_2019-03-27.xml │ │ └── rol_ifrs_16_2019-03-27.xsd │ │ ├── ifrs_17 │ │ ├── cal_ifrs_17_2019-03-27_role-836600.xml │ │ ├── def_ifrs_17_2019-03-27_role-836600.xml │ │ ├── gla_ifrs_17_2019-03-27-en.xml │ │ ├── gre_ifrs_17_2019-03-27.xml │ │ ├── pre_ifrs_17_2019-03-27_role-836600.xml │ │ ├── ref_ifrs_17_2019-03-27.xml │ │ └── rol_ifrs_17_2019-03-27.xsd │ │ ├── ifrs_2 │ │ ├── cal_ifrs_2_2019-03-27_role-834120.xml │ │ ├── def_ifrs_2_2019-03-27_role-834120.xml │ │ ├── gla_ifrs_2_2019-03-27-en.xml │ │ ├── gre_ifrs_2_2019-03-27.xml │ │ ├── pre_ifrs_2_2019-03-27_role-834120.xml │ │ ├── ref_ifrs_2_2019-03-27.xml │ │ └── rol_ifrs_2_2019-03-27.xsd │ │ ├── ifrs_3 │ │ ├── cal_ifrs_3_2019-03-27_role-817000.xml │ │ ├── def_ifrs_3_2019-03-27_role-817000.xml │ │ ├── gla_ifrs_3_2019-03-27-en.xml │ │ ├── gre_ifrs_3_2019-03-27.xml │ │ ├── pre_ifrs_3_2019-03-27_role-817000.xml │ │ ├── ref_ifrs_3_2019-03-27.xml │ │ └── rol_ifrs_3_2019-03-27.xsd │ │ ├── ifrs_4 │ │ ├── cal_ifrs_4_2019-03-27_role-836500.xml │ │ ├── def_ifrs_4_2019-03-27_role-836500.xml │ │ ├── gla_ifrs_4_2019-03-27-en.xml │ │ ├── gre_ifrs_4_2019-03-27.xml │ │ ├── pre_ifrs_4_2019-03-27_role-836500.xml │ │ ├── ref_ifrs_4_2019-03-27.xml │ │ └── rol_ifrs_4_2019-03-27.xsd │ │ ├── ifrs_5 │ │ ├── cal_ifrs_5_2019-03-27_role-825900.xml │ │ ├── def_ifrs_5_2019-03-27_role-825900.xml │ │ ├── gla_ifrs_5_2019-03-27-en.xml │ │ ├── gre_ifrs_5_2019-03-27.xml │ │ ├── pre_ifrs_5_2019-03-27_role-825900.xml │ │ ├── ref_ifrs_5_2019-03-27.xml │ │ └── rol_ifrs_5_2019-03-27.xsd │ │ ├── ifrs_6 │ │ ├── gla_ifrs_6_2019-03-27-en.xml │ │ ├── gre_ifrs_6_2019-03-27.xml │ │ ├── pre_ifrs_6_2019-03-27_role-822200.xml │ │ ├── ref_ifrs_6_2019-03-27.xml │ │ └── rol_ifrs_6_2019-03-27.xsd │ │ ├── ifrs_7 │ │ ├── cal_ifrs_7_2019-03-27_role-822390.xml │ │ ├── def_ifrs_7_2019-03-27_role-822390.xml │ │ ├── gla_ifrs_7_2019-03-27-en.xml │ │ ├── gre_ifrs_7_2019-03-27.xml │ │ ├── pre_ifrs_7_2019-03-27_role-822390.xml │ │ ├── ref_ifrs_7_2019-03-27.xml │ │ └── rol_ifrs_7_2019-03-27.xsd │ │ ├── ifrs_8 │ │ ├── def_ifrs_8_2019-03-27_role-871100.xml │ │ ├── gla_ifrs_8_2019-03-27-en.xml │ │ ├── gre_ifrs_8_2019-03-27.xml │ │ ├── pre_ifrs_8_2019-03-27_role-871100.xml │ │ ├── ref_ifrs_8_2019-03-27.xml │ │ └── rol_ifrs_8_2019-03-27.xsd │ │ └── sic_29 │ │ ├── def_sic_29_2019-03-27_role-832900.xml │ │ ├── gla_sic_29_2019-03-27-en.xml │ │ ├── gre_sic_29_2019-03-27.xml │ │ ├── pre_sic_29_2019-03-27_role-832900.xml │ │ ├── ref_sic_29_2019-03-27.xml │ │ └── rol_sic_29_2019-03-27.xsd │ ├── full_ifrs_entry_point_2019-03-27.xsd │ ├── full_ifrs_mc_entry_point_2019-03-27.xsd │ ├── ifrs_for_smes │ ├── dimensions │ │ ├── dim_ifrs_for_smes_2019-03-27_role-901000.xml │ │ ├── dim_ifrs_for_smes_2019-03-27_role-901500.xml │ │ ├── dim_ifrs_for_smes_2019-03-27_role-913000.xml │ │ ├── dim_ifrs_for_smes_2019-03-27_role-990000.xml │ │ ├── gla_ifrs_for_smes-dim_2019-03-27-en.xml │ │ ├── gre_ifrs_for_smes-dim_2019-03-27.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-901000.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-901500.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-913000.xml │ │ └── rol_ifrs_for_smes-dim_2019-03-27.xsd │ ├── ifrs_for_smes-cor_2019-03-27.xsd │ ├── labels │ │ ├── doc_ifrs_for_smes-en_2019-03-27.xml │ │ └── lab_ifrs_for_smes-en_2019-03-27.xml │ └── linkbases │ │ ├── cal_ifrs_for_smes_2019-03-27_role-210000.xml │ │ ├── cal_ifrs_for_smes_2019-03-27_role-220000.xml │ │ ├── cal_ifrs_for_smes_2019-03-27_role-310000.xml │ │ ├── cal_ifrs_for_smes_2019-03-27_role-320000.xml │ │ ├── cal_ifrs_for_smes_2019-03-27_role-410000.xml │ │ ├── cal_ifrs_for_smes_2019-03-27_role-420000.xml │ │ ├── cal_ifrs_for_smes_2019-03-27_role-510000.xml │ │ ├── cal_ifrs_for_smes_2019-03-27_role-520000.xml │ │ ├── cal_ifrs_for_smes_2019-03-27_role-610000.xml │ │ ├── cal_ifrs_for_smes_2019-03-27_role-800100.xml │ │ ├── cal_ifrs_for_smes_2019-03-27_role-800200.xml │ │ ├── cal_ifrs_for_smes_2019-03-27_role-817000.xml │ │ ├── cal_ifrs_for_smes_2019-03-27_role-822100.xml │ │ ├── cal_ifrs_for_smes_2019-03-27_role-823180.xml │ │ ├── cal_ifrs_for_smes_2019-03-27_role-824180.xml │ │ ├── cal_ifrs_for_smes_2019-03-27_role-825100.xml │ │ ├── cal_ifrs_for_smes_2019-03-27_role-827570.xml │ │ ├── cal_ifrs_for_smes_2019-03-27_role-832600.xml │ │ ├── cal_ifrs_for_smes_2019-03-27_role-834480.xml │ │ ├── cal_ifrs_for_smes_2019-03-27_role-835110.xml │ │ ├── cal_ifrs_for_smes_2019-03-27_role-851100.xml │ │ ├── def_ifrs_for_smes_2019-03-27_role-610000.xml │ │ ├── def_ifrs_for_smes_2019-03-27_role-810000.xml │ │ ├── def_ifrs_for_smes_2019-03-27_role-811000.xml │ │ ├── def_ifrs_for_smes_2019-03-27_role-815000.xml │ │ ├── def_ifrs_for_smes_2019-03-27_role-817000.xml │ │ ├── def_ifrs_for_smes_2019-03-27_role-818000.xml │ │ ├── def_ifrs_for_smes_2019-03-27_role-819100.xml │ │ ├── def_ifrs_for_smes_2019-03-27_role-822100.xml │ │ ├── def_ifrs_for_smes_2019-03-27_role-822390.xml │ │ ├── def_ifrs_for_smes_2019-03-27_role-823180.xml │ │ ├── def_ifrs_for_smes_2019-03-27_role-824180.xml │ │ ├── def_ifrs_for_smes_2019-03-27_role-827570.xml │ │ ├── def_ifrs_for_smes_2019-03-27_role-832410.xml │ │ ├── def_ifrs_for_smes_2019-03-27_role-832600.xml │ │ ├── def_ifrs_for_smes_2019-03-27_role-834120.xml │ │ ├── def_ifrs_for_smes_2019-03-27_role-834480.xml │ │ ├── def_ifrs_for_smes_2019-03-27_role-835110.xml │ │ ├── def_ifrs_for_smes_2019-03-27_role-861200.xml │ │ ├── gla_ifrs_for_smes_2019-03-27-en.xml │ │ ├── gre_ifrs_for_smes_2019-03-27.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-110000.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-210000.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-220000.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-310000.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-320000.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-410000.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-420000.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-510000.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-520000.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-610000.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-650000.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-800100.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-800200.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-810000.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-811000.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-815000.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-816000.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-817000.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-818000.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-819100.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-822100.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-822390.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-823180.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-824180.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-825100.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-825480.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-825500.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-825600.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-825900.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-826380.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-827570.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-831110.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-831400.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-831710.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-832410.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-832600.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-834120.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-834480.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-835110.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-842000.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-851100.xml │ │ ├── pre_ifrs_for_smes_2019-03-27_role-861200.xml │ │ ├── ref_ifrs_for_smes_2019-03-27.xml │ │ └── rol_ifrs_for_smes_2019-03-27.xsd │ ├── ifrs_for_smes_entry_point_2019-03-27.xsd │ ├── mc │ ├── labels │ │ ├── doc_mc-en_2019-03-27.xml │ │ └── lab_mc-en_2019-03-27.xml │ ├── linkbases │ │ ├── gla_mc_2019-03-27-en.xml │ │ ├── gre_mc_2019-03-27.xml │ │ ├── pre_mc_2019-03-27_role-105000.xml │ │ ├── ref_mc_2019-03-27.xml │ │ └── rol_mc_2019-03-27.xsd │ └── mc-cor_2019-03-27.xsd │ └── mc_entry_point_2019-03-27.xsd ├── samples ├── responses │ ├── xbrl_company_concepts.jsonc │ ├── xbrl_company_facts.jsonc │ └── xbrl_frames.jsonc ├── use_api_submissions.py ├── use_api_xbrl.py ├── use_archive_service.py ├── use_client.py ├── use_company_service.py ├── use_current_events_service.py ├── use_dataset_service.py ├── use_filings_service.py ├── use_issuers_service.py ├── use_mutual_funds_service.py ├── use_ownership_filings_service.py ├── use_series_service.py └── use_variable_insurance_products.py ├── setup.py └── tests └── test_edgar_client.py /.github/FUNDING.yml: -------------------------------------------------------------------------------- 1 | # These are supported funding model platforms 2 | 3 | github: [areed1192] 4 | patreon: sigmacoding 5 | -------------------------------------------------------------------------------- /.github/workflows/python-package.yml: -------------------------------------------------------------------------------- 1 | # This workflow will install Python dependencies, run tests and lint with a variety of Python versions 2 | # For more information see: https://help.github.com/actions/language-and-framework-guides/using-python-with-github-actions 3 | 4 | name: Python package 5 | 6 | on: 7 | push: 8 | branches: [master] 9 | pull_request: 10 | branches: [master] 11 | 12 | jobs: 13 | build: 14 | runs-on: ubuntu-latest 15 | strategy: 16 | matrix: 17 | python-version: [3.7, 3.8, 3.9] 18 | 19 | steps: 20 | - uses: actions/checkout@v2 21 | - name: Set up Python ${{ matrix.python-version }} 22 | uses: actions/setup-python@v2 23 | with: 24 | python-version: ${{ matrix.python-version }} 25 | 26 | - name: Install Dependencies from requirements.txt File. 27 | run: | 28 | python -m pip install --upgrade pip 29 | pip install flake8 pytest 30 | if [ -f requirements.txt ]; then pip install -r requirements.txt; fi 31 | 32 | - name: Lint with flake8 33 | run: | 34 | # stop the build if there are Python syntax errors or undefined names 35 | flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics 36 | 37 | # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide 38 | flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics 39 | 40 | - name: Test with Unittest. 41 | run: | 42 | # If we have a testing folder, then run with unittest. 43 | if [ -f tests/test_clients.py ]; then python -m unittest tests/test_client.py; fi 44 | -------------------------------------------------------------------------------- /.github/workflows/python-publish.yml: -------------------------------------------------------------------------------- 1 | # This workflow will upload a Python Package using Twine when a release is created 2 | # For more information see: https://help.github.com/en/actions/language-and-framework-guides/using-python-with-github-actions#publishing-to-package-registries 3 | 4 | name: Upload Python Package 5 | 6 | on: 7 | release: 8 | types: [created] 9 | 10 | jobs: 11 | deploy: 12 | runs-on: ubuntu-latest 13 | 14 | steps: 15 | - uses: actions/checkout@v2 16 | - name: Set up Python 17 | uses: actions/setup-python@v2 18 | with: 19 | python-version: "3.7" 20 | - name: Install dependencies 21 | run: | 22 | python -m pip install --upgrade pip 23 | pip install setuptools wheel twine 24 | - name: Publish to TestPyPI 25 | env: 26 | TWINE_USERNAME: "__token__" 27 | TWINE_PASSWORD: ${{ secrets.test_pypi_token }} 28 | run: | 29 | python setup.py sdist bdist_wheel 30 | twine upload --repository testpypi --verbose dist/* 31 | - name: Publish to PyPI 32 | env: 33 | TWINE_USERNAME: "__token__" 34 | TWINE_PASSWORD: ${{ secrets.pypi_token }} 35 | run: | 36 | python setup.py sdist bdist_wheel 37 | twine upload --verbose dist/* 38 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | # Byte-compiled / optimized / DLL files 2 | __pycache__/ 3 | *.py[cod] 4 | *$py.class 5 | 6 | Lessons - SEC/ 7 | 8 | # C extensions 9 | *.so 10 | 11 | # Distribution / packaging 12 | .Python 13 | build/ 14 | develop-eggs/ 15 | dist/ 16 | downloads/ 17 | eggs/ 18 | .eggs/ 19 | lib/ 20 | lib64/ 21 | parts/ 22 | sdist/ 23 | var/ 24 | wheels/ 25 | pip-wheel-metadata/ 26 | share/python-wheels/ 27 | *.egg-info/ 28 | .installed.cfg 29 | *.egg 30 | MANIFEST 31 | 32 | 33 | # PyInstaller 34 | # Usually these files are written by a python script from a template 35 | # before PyInstaller builds the exe, so as to inject date/other infos into it. 36 | *.manifest 37 | *.spec 38 | 39 | # Installer logs 40 | pip-log.txt 41 | pip-delete-this-directory.txt 42 | 43 | # Unit test / coverage reports 44 | htmlcov/ 45 | .tox/ 46 | .nox/ 47 | .coverage 48 | .coverage.* 49 | .cache 50 | nosetests.xml 51 | coverage.xml 52 | *.cover 53 | *.py,cover 54 | .hypothesis/ 55 | .pytest_cache/ 56 | 57 | # Translations 58 | *.mo 59 | *.pot 60 | 61 | # Django stuff: 62 | *.log 63 | local_settings.py 64 | db.sqlite3 65 | db.sqlite3-journal 66 | 67 | # Flask stuff: 68 | instance/ 69 | .webassets-cache 70 | 71 | # Scrapy stuff: 72 | .scrapy 73 | 74 | # Sphinx documentation 75 | docs/_build/ 76 | 77 | # PyBuilder 78 | target/ 79 | 80 | # Jupyter Notebook 81 | .ipynb_checkpoints 82 | 83 | # IPython 84 | profile_default/ 85 | ipython_config.py 86 | 87 | # pyenv 88 | .python-version 89 | 90 | # pipenv 91 | # According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control. 92 | # However, in case of collaboration, if having platform-specific dependencies or dependencies 93 | # having no cross-platform support, pipenv may install dependencies that don't work, or not 94 | # install all needed dependencies. 95 | #Pipfile.lock 96 | 97 | # PEP 582; used by e.g. github.com/David-OConnor/pyflow 98 | __pypackages__/ 99 | 100 | # Celery stuff 101 | celerybeat-schedule 102 | celerybeat.pid 103 | 104 | # SageMath parsed files 105 | *.sage.py 106 | 107 | # Environments 108 | .env 109 | .venv 110 | env/ 111 | venv/ 112 | ENV/ 113 | env.bak/ 114 | venv.bak/ 115 | 116 | # Spyder project settings 117 | .spyderproject 118 | .spyproject 119 | 120 | # Rope project settings 121 | .ropeproject 122 | 123 | # mkdocs documentation 124 | /site 125 | 126 | # mypy 127 | .mypy_cache/ 128 | .dmypy.json 129 | dmypy.json 130 | 131 | # Pyre type checker 132 | .pyre/ 133 | .vscode/ 134 | .pypirc 135 | configs/ 136 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2020 Alex Reed 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /edgar/datasets.py: -------------------------------------------------------------------------------- 1 | from edgar.session import EdgarSession 2 | from edgar.parser import EdgarParser 3 | 4 | 5 | class Datasets(): 6 | 7 | """ 8 | ## Overview: 9 | ---- 10 | The SEC offers free datasets for individuals and companies to use 11 | in their own research. The `Datasets` client helps users query these 12 | datasets. 13 | """ 14 | 15 | def __init__(self, session: EdgarSession) -> None: 16 | """Initializes the `Datasets` object. 17 | 18 | ### Parameters 19 | ---- 20 | session : `EdgarSession` 21 | An initialized session of the `EdgarSession`. 22 | 23 | ### Usage 24 | ---- 25 | >>> edgar_client = EdgarClient() 26 | >>> datasets_services = edgar_client.Datasets() 27 | """ 28 | 29 | # Set the session. 30 | self.edgar_session: EdgarSession = session 31 | self.edgar_parser: EdgarParser = EdgarParser() 32 | 33 | def __repr__(self) -> str: 34 | """String representation of the `EdgarClient.Datasets` object.""" 35 | 36 | # define the string representation 37 | str_representation = '' 38 | 39 | return str_representation 40 | 41 | def get_sec_datasets(self) -> dict: 42 | """Grabs all the Public datasets provided by the SEC. 43 | 44 | ### Returns: 45 | ---- 46 | dict: 47 | A collection of `Dataset` resources. 48 | 49 | ### Usage: 50 | ---- 51 | >>> edgar_client = EdgarClient() 52 | >>> datasets_services = edgar_client.Datasets() 53 | >>> datasets_services.get_sec_datasets() 54 | """ 55 | 56 | # Make the request. 57 | response = self.edgar_session.make_request( 58 | method='get', 59 | endpoint='/data.json' 60 | ) 61 | 62 | return response 63 | 64 | def get_edgar_taxonomies(self) -> dict: 65 | """Grabs all the Public taxonomies datasets provided by the SEC. 66 | 67 | ### Returns: 68 | ---- 69 | dict: 70 | A collection of `Dataset` taxonomy resources. 71 | 72 | ### Usage: 73 | ---- 74 | >>> edgar_client = EdgarClient() 75 | >>> datasets_services = edgar_client.Datasets() 76 | >>> datasets_services.get_sec_datasets() 77 | """ 78 | 79 | # Make the request. 80 | response = self.edgar_session.make_request( 81 | method='get', 82 | endpoint='/info/edgar/edgartaxonomies.xml' 83 | ) 84 | 85 | response = self.edgar_parser.parse_loc_elements( 86 | response_text=response 87 | ) 88 | 89 | return response 90 | -------------------------------------------------------------------------------- /edgar/parser/xbrl.py: -------------------------------------------------------------------------------- 1 | from bs4 import BeautifulSoup 2 | 3 | import csv 4 | import pprint 5 | import pathlib 6 | import collections 7 | import xml.etree.ElementTree as ET 8 | from typing import Union 9 | 10 | 11 | class XbrlFiling(): 12 | 13 | def __init__(self) -> None: 14 | 15 | self.file_path = None 16 | self.url = None 17 | 18 | def from_url(self, url: str) -> None: 19 | pass 20 | 21 | def from_file(self, file_path: Union[str, pathlib.Path]) -> None: 22 | pass 23 | -------------------------------------------------------------------------------- /edgar/parsing/__init__.py: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/areed1192/python-sec/b2a0652522d4df689dda3358c10458e347e74747/edgar/parsing/__init__.py -------------------------------------------------------------------------------- /edgar/parsing/parse_country.py: -------------------------------------------------------------------------------- 1 | import xml.etree.ElementTree as ET 2 | import json 3 | 4 | # with open("edgar/parsing/country_code.html", "r") as code: 5 | 6 | # # Parse the text. 7 | # root = ET.fromstring(code.read()) 8 | 9 | # options = root.findall(path='./option') 10 | 11 | # country_codes = {option.text.replace(" ", "_"): option.attrib.get('value', None) for option in options if option.text} 12 | 13 | # # for option in options: 14 | # # print(option.text) 15 | # # print(option.attrib.get('value', None)) 16 | 17 | # print(country_codes) 18 | 19 | # with open("edgar/country_codes.jsonc", mode='w+') as country_code_file: 20 | # json.dump(obj=country_codes, fp=country_code_file, indent=4) 21 | 22 | with open("edgar/parsing/state_codes.html", "r") as code: 23 | 24 | # Parse the text. 25 | root = ET.fromstring(code.read()) 26 | 27 | options = root.findall(path='./option') 28 | 29 | country_codes = {option.text.replace(" ", "_"): option.attrib.get('value', None) for option in options} 30 | 31 | # for option in options: 32 | # print(option.text) 33 | # print(option.attrib.get('value', None)) 34 | 35 | print(country_codes) 36 | 37 | with open("edgar/state_codes.jsonc", mode='w+') as country_code_file: 38 | json.dump(obj=country_codes, fp=country_code_file, indent=4) -------------------------------------------------------------------------------- /edgar/parsing/state_codes.html: -------------------------------------------------------------------------------- 1 | 66 | -------------------------------------------------------------------------------- /edgar/submissions.py: -------------------------------------------------------------------------------- 1 | from edgar.session import EdgarSession 2 | from edgar.utilis import EdgarUtilities 3 | 4 | 5 | class Submissions(): 6 | 7 | """ 8 | ## Overview: 9 | ---- 10 | Allows a user to query each entity’s current filing 11 | history using the SEC Restful API. 12 | """ 13 | 14 | def __init__(self, session: EdgarSession) -> None: 15 | """Initializes the `Submissions` object. 16 | 17 | ### Parameters 18 | ---- 19 | session : `EdgarSession` 20 | An initialized session of the `EdgarSession`. 21 | 22 | ### Usage 23 | ---- 24 | >>> edgar_client = EdgarClient() 25 | >>> submissions_service = edgar_client.submissions() 26 | """ 27 | 28 | # Set the session. 29 | self.edgar_session: EdgarSession = session 30 | self.edgar_utilities: EdgarUtilities = EdgarUtilities() 31 | 32 | def __repr__(self) -> str: 33 | """String representation of the `EdgarClient.Submissions` object.""" 34 | 35 | # define the string representation 36 | str_representation = '' 37 | 38 | return str_representation 39 | 40 | def get_submissions(self, cik: str) -> dict: 41 | """Returns all the ownership filings for a given CIK number. 42 | 43 | ### Arguments: 44 | ---- 45 | cik : str 46 | The CIK number you want to query. 47 | 48 | ### Returns: 49 | ---- 50 | dict : 51 | A collection of `Submission` resource objects. 52 | 53 | ### Usage: 54 | ---- 55 | >>> edgar_client = EdgarClient() 56 | >>> submissions_service = edgar_client.submissions() 57 | >>> submissions_service.get_submissions( 58 | cik='1326801' 59 | ) 60 | """ 61 | 62 | if len(cik) < 10: 63 | num_of_zeros = 10 - len(cik) 64 | cik = num_of_zeros*"0" + cik 65 | 66 | # Grab the Data. 67 | response = self.edgar_session.make_request( 68 | method='get', 69 | endpoint=f'/submissions/CIK{cik}.json', 70 | use_api=True 71 | ) 72 | 73 | return response 74 | -------------------------------------------------------------------------------- /requirements.txt: -------------------------------------------------------------------------------- 1 | requests>=2.25.1 2 | urllib3>=1.26.5 3 | beautifulsoup4>=4.9.1 4 | -------------------------------------------------------------------------------- /resources/data-sources-fasb.md: -------------------------------------------------------------------------------- 1 | # DATA DIRECTORIES - FASB 2 | 3 | **US GAAP Taxonomy Directory:** 4 | 5 | 6 | -------------------------------------------------------------------------------- /resources/data-sources-other.md: -------------------------------------------------------------------------------- 1 | # DATA DIRECTORIES - ALL OTHERS 2 | 3 | **NASDAQ - Symbols Directory:** 4 | 5 | 6 | 7 | **Federal Register:** 8 | 9 | 10 | 11 | **The Options Clearing Corporation:** 12 | 13 | 14 | 15 | **The Chicago Board Options Exchange:** 16 | 17 | 18 | 19 | **Federal Reserver API:** 20 | 21 | 22 | 23 | **One Chicago RSS Feed:** 24 | 25 | 26 | 27 | **NASDAQ Trader RSS Feed:** 28 | 29 | 30 | 31 | **OCC RSS Feed:** 32 | 33 | 34 | 35 | 36 | -------------------------------------------------------------------------------- /resources/data-sources-sec.md: -------------------------------------------------------------------------------- 1 | # DATA DIRECTORIES - SEC 2 | 3 | **Currency Directory:** 4 | 5 | 6 | 7 | **Country Directory:** 8 | 9 | 10 | 11 | **Document Entity Information Directory:** 12 | 13 | 14 | 15 | **Market Exchange Directory:** 16 | 17 | 18 | 19 | **Investment Directory:** 20 | 21 | 22 | 23 | **North America Industry Classification Directory:** 24 | 25 | 26 | 27 | **Standard Industry Classification Directory:** 28 | 29 | 30 | 31 | **State Provience Directory:** 32 | 33 | 34 | 35 | **CIK (Central Index Key) Lookup Text File:** 36 | 37 | 38 | 39 | **Company Tickers & CIK Mapping JSON File:** 40 | 41 | 42 | 43 | **Company Tickers & CIK Mapping Text File:** 44 | 45 | 46 | 47 | **SEC Data Catalog Directory:** 48 | 49 | 50 | -------------------------------------------------------------------------------- /resources/data/sec_xbrl_scrape_values.csv: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/areed1192/python-sec/b2a0652522d4df689dda3358c10458e347e74747/resources/data/sec_xbrl_scrape_values.csv -------------------------------------------------------------------------------- /resources/docs/SEC Scraping Documentation.docx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/areed1192/python-sec/b2a0652522d4df689dda3358c10458e347e74747/resources/docs/SEC Scraping Documentation.docx -------------------------------------------------------------------------------- /resources/label_tags.xlsx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/areed1192/python-sec/b2a0652522d4df689dda3358c10458e347e74747/resources/label_tags.xlsx -------------------------------------------------------------------------------- /resources/technical-guides/edgar-technical-guides.zip: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/areed1192/python-sec/b2a0652522d4df689dda3358c10458e347e74747/resources/technical-guides/edgar-technical-guides.zip -------------------------------------------------------------------------------- /resources/technical-guides/edgar-xbrl-guide.pdf: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/areed1192/python-sec/b2a0652522d4df689dda3358c10458e347e74747/resources/technical-guides/edgar-xbrl-guide.pdf -------------------------------------------------------------------------------- /resources/technical-guides/gaap-xbrl-guide.pdf: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/areed1192/python-sec/b2a0652522d4df689dda3358c10458e347e74747/resources/technical-guides/gaap-xbrl-guide.pdf -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-form-13/EDGAR Form 13F Stylesheets.zip: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/areed1192/python-sec/b2a0652522d4df689dda3358c10458e347e74747/resources/technical-guides/technical-guides-form-13/EDGAR Form 13F Stylesheets.zip -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-form-13/EDGAR Form 13F XML Samples.zip: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/areed1192/python-sec/b2a0652522d4df689dda3358c10458e347e74747/resources/technical-guides/technical-guides-form-13/EDGAR Form 13F XML Samples.zip -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-form-13/EDGAR Form 13F XML Schema Files.zip: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/areed1192/python-sec/b2a0652522d4df689dda3358c10458e347e74747/resources/technical-guides/technical-guides-form-13/EDGAR Form 13F XML Schema Files.zip -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-form-13/EDGAR Form 13F XML Technical Specification.pdf: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/areed1192/python-sec/b2a0652522d4df689dda3358c10458e347e74747/resources/technical-guides/technical-guides-form-13/EDGAR Form 13F XML Technical Specification.pdf -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/FRC-2019-Taxonomy-Report-IFRS-mapping.xlsx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/areed1192/python-sec/b2a0652522d4df689dda3358c10458e347e74747/resources/technical-guides/technical-guides-ifrs/FRC-2019-Taxonomy-Report-IFRS-mapping.xlsx -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/META-INF/catalog.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/deprecated/depr-doc_mc-en_2019-03-27.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/deprecated/depr-lab_mc-en_2019-03-27.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/deprecated/mc-depr_2019-03-27.xsd: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/dimensions/dim_full_ifrs_2019-03-27_role-901500.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/dimensions/dim_full_ifrs_2019-03-27_role-913000.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/dimensions/pre_full_ifrs_2019-03-27_role-901100.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/dimensions/pre_full_ifrs_2019-03-27_role-901500.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/dimensions/pre_full_ifrs_2019-03-27_role-903000.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/dimensions/pre_full_ifrs_2019-03-27_role-913000.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_1/cal_ias_1_2019-03-27_role-861200.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_10/gla_ias_10_2019-03-27-en.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | [815000] Notes - Events after reporting period 15 | 16 | 17 | 18 | 19 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_10/gre_ias_10_2019-03-27.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | IAS 16 | 10 17 | 2019-01-01 18 | 19 | 20 | 21 | 22 | 23 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_10/rol_ias_10_2019-03-27.xsd: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | [815000] Notes - Events after reporting period 14 | link:calculationLink 15 | link:definitionLink 16 | link:presentationLink 17 | 18 | 19 | 20 | 21 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_12/rol_ias_12_2019-03-27.xsd: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | [835110] Notes - Income taxes 14 | link:calculationLink 15 | link:definitionLink 16 | link:presentationLink 17 | 18 | 19 | [835110a] Notes - Income taxes 20 | link:calculationLink 21 | link:definitionLink 22 | link:presentationLink 23 | 24 | 25 | [835110b] Notes - Income taxes 26 | link:calculationLink 27 | link:definitionLink 28 | link:presentationLink 29 | 30 | 31 | 32 | 33 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_16/gla_ias_16_2019-03-27-en.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | [822100] Notes - Property, plant and equipment 15 | 16 | 17 | 18 | 19 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_16/gre_ias_16_2019-03-27.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | IAS 16 | 16 17 | 2019-01-01 18 | 19 | 20 | 21 | 22 | 23 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_16/rol_ias_16_2019-03-27.xsd: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | [822100] Notes - Property, plant and equipment 14 | link:calculationLink 15 | link:definitionLink 16 | link:presentationLink 17 | 18 | 19 | 20 | 21 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_2/gla_ias_2_2019-03-27-en.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | [826380] Notes - Inventories 15 | 16 | 17 | 18 | 19 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_2/gre_ias_2_2019-03-27.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | IAS 16 | 2 17 | 2019-01-01 18 | 19 | 20 | 21 | 22 | 23 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_2/rol_ias_2_2019-03-27.xsd: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | [826380] Notes - Inventories 14 | link:calculationLink 15 | link:definitionLink 16 | link:presentationLink 17 | 18 | 19 | 20 | 21 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_20/gla_ias_20_2019-03-27-en.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | [831400] Notes - Government grants 15 | 16 | 17 | 18 | 19 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_20/gre_ias_20_2019-03-27.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | IAS 16 | 20 17 | 2019-01-01 18 | 19 | 20 | 21 | 22 | 23 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_20/rol_ias_20_2019-03-27.xsd: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | [831400] Notes - Government grants 14 | link:calculationLink 15 | link:definitionLink 16 | link:presentationLink 17 | 18 | 19 | 20 | 21 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_21/gla_ias_21_2019-03-27-en.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | [842000] Notes - Effects of changes in foreign exchange rates 15 | 16 | 17 | 18 | 19 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_21/gre_ias_21_2019-03-27.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | IAS 16 | 21 17 | 2019-01-01 18 | 19 | 20 | 21 | 22 | 23 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_21/rol_ias_21_2019-03-27.xsd: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | [842000] Notes - Effects of changes in foreign exchange rates 14 | link:calculationLink 15 | link:definitionLink 16 | link:presentationLink 17 | 18 | 19 | 20 | 21 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_23/gla_ias_23_2019-03-27-en.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | [836200] Notes - Borrowing costs 15 | 16 | 17 | 18 | 19 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_23/gre_ias_23_2019-03-27.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | IAS 16 | 23 17 | 2019-01-01 18 | 19 | 20 | 21 | 22 | 23 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_23/rol_ias_23_2019-03-27.xsd: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | [836200] Notes - Borrowing costs 14 | link:calculationLink 15 | link:definitionLink 16 | link:presentationLink 17 | 18 | 19 | 20 | 21 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_24/rol_ias_24_2019-03-27.xsd: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | [818000] Notes - Related party 14 | link:calculationLink 15 | link:definitionLink 16 | link:presentationLink 17 | 18 | 19 | [818000a] Notes - Related party 20 | link:calculationLink 21 | link:definitionLink 22 | link:presentationLink 23 | 24 | 25 | 26 | 27 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_26/gla_ias_26_2019-03-27-en.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | [710000] Statement of changes in net assets available for benefits 15 | 16 | 17 | 18 | 19 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_26/gre_ias_26_2019-03-27.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | IAS 16 | 26 17 | 2019-01-01 18 | 19 | 20 | 21 | 22 | 23 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_26/rol_ias_26_2019-03-27.xsd: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | [710000] Statement of changes in net assets available for benefits 14 | link:calculationLink 15 | link:definitionLink 16 | link:presentationLink 17 | 18 | 19 | 20 | 21 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_27/rol_ias_27_2019-03-27.xsd: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | [825480] Notes - Separate financial statements 14 | link:calculationLink 15 | link:definitionLink 16 | link:presentationLink 17 | 18 | 19 | [825480a] Notes - Separate financial statements 20 | link:calculationLink 21 | link:definitionLink 22 | link:presentationLink 23 | 24 | 25 | [825480c] Notes - Separate financial statements 26 | link:calculationLink 27 | link:definitionLink 28 | link:presentationLink 29 | 30 | 31 | 32 | 33 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_29/gla_ias_29_2019-03-27-en.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | [816000] Notes - Hyperinflationary reporting 15 | 16 | 17 | 18 | 19 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_29/gre_ias_29_2019-03-27.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | IAS 16 | 29 17 | 2019-01-01 18 | 19 | 20 | 21 | 22 | 23 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_29/rol_ias_29_2019-03-27.xsd: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | [816000] Notes - Hyperinflationary reporting 14 | link:calculationLink 15 | link:definitionLink 16 | link:presentationLink 17 | 18 | 19 | 20 | 21 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_33/gla_ias_33_2019-03-27-en.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | [838000] Notes - Earnings per share 15 | 16 | 17 | 18 | 19 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_33/gre_ias_33_2019-03-27.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | IAS 16 | 33 17 | 2019-01-01 18 | 19 | 20 | 21 | 22 | 23 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_33/rol_ias_33_2019-03-27.xsd: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | [838000] Notes - Earnings per share 14 | link:calculationLink 15 | link:definitionLink 16 | link:presentationLink 17 | 18 | 19 | 20 | 21 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_34/gla_ias_34_2019-03-27-en.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | [813000] Notes - Interim financial reporting 15 | 16 | 17 | 18 | 19 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_34/gre_ias_34_2019-03-27.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | IAS 16 | 34 17 | 2019-01-01 18 | 19 | 20 | 21 | 22 | 23 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_34/rol_ias_34_2019-03-27.xsd: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | [813000] Notes - Interim financial reporting 14 | link:calculationLink 15 | link:definitionLink 16 | link:presentationLink 17 | 18 | 19 | 20 | 21 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_37/rol_ias_37_2019-03-27.xsd: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | [827570] Notes - Other provisions, contingent liabilities and contingent assets 14 | link:calculationLink 15 | link:definitionLink 16 | link:presentationLink 17 | 18 | 19 | [827570a] Notes - Other provisions, contingent liabilities and contingent assets 20 | link:calculationLink 21 | link:definitionLink 22 | link:presentationLink 23 | 24 | 25 | [827570b] Notes - Other provisions, contingent liabilities and contingent assets 26 | link:calculationLink 27 | link:definitionLink 28 | link:presentationLink 29 | 30 | 31 | 32 | 33 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_40/gla_ias_40_2019-03-27-en.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | [825100] Notes - Investment property 15 | 16 | 17 | 18 | 19 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_40/gre_ias_40_2019-03-27.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | IAS 16 | 40 17 | 2019-01-01 18 | 19 | 20 | 21 | 22 | 23 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_40/rol_ias_40_2019-03-27.xsd: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | [825100] Notes - Investment property 14 | link:calculationLink 15 | link:definitionLink 16 | link:presentationLink 17 | 18 | 19 | 20 | 21 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ias_41/rol_ias_41_2019-03-27.xsd: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | [824180] Notes - Agriculture 14 | link:calculationLink 15 | link:definitionLink 16 | link:presentationLink 17 | 18 | 19 | [824180a] Notes - Agriculture 20 | link:calculationLink 21 | link:definitionLink 22 | link:presentationLink 23 | 24 | 25 | [824180b] Notes - Agriculture 26 | link:calculationLink 27 | link:definitionLink 28 | link:presentationLink 29 | 30 | 31 | 32 | 33 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ifric_2/gla_ifric_2_2019-03-27-en.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | [868500] Notes - Members' shares in co-operative entities and similar instruments 15 | 16 | 17 | 18 | 19 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ifric_2/gre_ifric_2_2019-03-27.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | IFRIC 16 | 2 17 | 2019-01-01 18 | 19 | 20 | 21 | 22 | 23 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ifric_2/pre_ifric_2_2019-03-27_role-868500.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ifric_2/ref_ifric_2_2019-03-27.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | IFRIC 5 | 2 6 | 2019-01-01 7 | Disclosure 8 | http://eifrs.ifrs.org/eifrs/xifrs-link?type=IFRIC&num=2&code=ifrs-tx-2019-en-r&doctype=Standard&dita_xref=IFRIC02_g13-13_TI 9 | 2019-03-27 10 | 11 | 12 | 13 | 14 | IFRIC 15 | 2 16 | 2019-01-01 17 | 13 18 | http://eifrs.ifrs.org/eifrs/xifrs-link?type=IFRIC&num=2&code=ifrs-tx-2019-en-r&anchor=para_13&doctype=Standard 19 | 2019-03-27 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ifric_2/rol_ifric_2_2019-03-27.xsd: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | [868500] Notes - Members' shares in co-operative entities and similar instruments 14 | link:calculationLink 15 | link:definitionLink 16 | link:presentationLink 17 | 18 | 19 | 20 | 21 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ifric_5/gla_ifric_5_2019-03-27-en.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | [868200] Notes - Rights to interests arising from decommissioning, restoration and environmental rehabilitation funds 15 | 16 | 17 | 18 | 19 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ifric_5/gre_ifric_5_2019-03-27.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | IFRIC 16 | 5 17 | 2019-01-01 18 | 19 | 20 | 21 | 22 | 23 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ifric_5/pre_ifric_5_2019-03-27_role-868200.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ifric_5/ref_ifric_5_2019-03-27.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | IFRIC 5 | 5 6 | 2019-01-01 7 | Consensus 8 | http://eifrs.ifrs.org/eifrs/xifrs-link?type=IFRIC&num=5&code=ifrs-tx-2019-en-r&doctype=Standard&dita_xref=IFRIC05_g7-13_TI 9 | 2019-03-27 10 | 11 | 12 | 13 | 14 | IFRIC 15 | 5 16 | 2019-01-01 17 | 11 18 | http://eifrs.ifrs.org/eifrs/xifrs-link?type=IFRIC&num=5&code=ifrs-tx-2019-en-r&anchor=para_11&doctype=Standard 19 | 2019-03-27 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ifric_5/rol_ifric_5_2019-03-27.xsd: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | [868200] Notes - Rights to interests arising from decommissioning, restoration and environmental rehabilitation funds 14 | link:calculationLink 15 | link:definitionLink 16 | link:presentationLink 17 | 18 | 19 | 20 | 21 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ifrs_14/rol_ifrs_14_2019-03-27.xsd: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | [824500] Regulatory deferral accounts 14 | link:calculationLink 15 | link:definitionLink 16 | link:presentationLink 17 | 18 | 19 | [824500a] Regulatory deferral accounts 20 | link:calculationLink 21 | link:definitionLink 22 | link:presentationLink 23 | 24 | 25 | 26 | 27 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ifrs_16/rol_ifrs_16_2019-03-27.xsd: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | [832610] Notes - Leases 14 | link:calculationLink 15 | link:definitionLink 16 | link:presentationLink 17 | 18 | 19 | [832610a] Notes - Leases 20 | link:calculationLink 21 | link:definitionLink 22 | link:presentationLink 23 | 24 | 25 | [832610b] Notes - Leases 26 | link:calculationLink 27 | link:definitionLink 28 | link:presentationLink 29 | 30 | 31 | 32 | 33 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ifrs_2/cal_ifrs_2_2019-03-27_role-834120.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ifrs_5/gla_ifrs_5_2019-03-27-en.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | [825900] Notes - Non-current asset held for sale and discontinued operations 15 | 16 | 17 | 18 | 19 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ifrs_5/gre_ifrs_5_2019-03-27.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | IFRS 16 | 5 17 | 2019-01-01 18 | 19 | 20 | 21 | 22 | 23 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ifrs_5/rol_ifrs_5_2019-03-27.xsd: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | [825900] Notes - Non-current asset held for sale and discontinued operations 14 | link:calculationLink 15 | link:definitionLink 16 | link:presentationLink 17 | 18 | 19 | 20 | 21 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ifrs_6/gla_ifrs_6_2019-03-27-en.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | [822200] Notes - Exploration for and evaluation of mineral resources 15 | 16 | 17 | 18 | 19 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ifrs_6/gre_ifrs_6_2019-03-27.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | IFRS 16 | 6 17 | 2019-01-01 18 | 19 | 20 | 21 | 22 | 23 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/ifrs_6/rol_ifrs_6_2019-03-27.xsd: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | [822200] Notes - Exploration for and evaluation of mineral resources 14 | link:calculationLink 15 | link:definitionLink 16 | link:presentationLink 17 | 18 | 19 | 20 | 21 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/sic_29/gla_sic_29_2019-03-27-en.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | [832900] Notes - Service concession arrangements 15 | 16 | 17 | 18 | 19 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/sic_29/gre_sic_29_2019-03-27.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | SIC 16 | 29 17 | 2019-01-01 18 | 19 | 20 | 21 | 22 | 23 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/full_ifrs/linkbases/sic_29/rol_sic_29_2019-03-27.xsd: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | [832900] Notes - Service concession arrangements 14 | link:calculationLink 15 | link:definitionLink 16 | link:presentationLink 17 | 18 | 19 | 20 | 21 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/ifrs_for_smes/dimensions/dim_ifrs_for_smes_2019-03-27_role-901500.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/ifrs_for_smes/dimensions/pre_ifrs_for_smes_2019-03-27_role-901500.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/ifrs_for_smes/dimensions/pre_ifrs_for_smes_2019-03-27_role-913000.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/ifrs_for_smes/linkbases/cal_ifrs_for_smes_2019-03-27_role-832600.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/ifrs_for_smes/linkbases/pre_ifrs_for_smes_2019-03-27_role-831110.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/mc/linkbases/gla_mc_2019-03-27-en.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | [105000] Management commentary 15 | 16 | 17 | 18 | 19 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/mc/linkbases/gre_mc_2019-03-27.xml: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | Practice statement 16 | Management commentary 17 | 2019-01-01 18 | 19 | 20 | 21 | 22 | 23 | -------------------------------------------------------------------------------- /resources/technical-guides/technical-guides-ifrs/IFRST_2019-03-27/mc/linkbases/rol_mc_2019-03-27.xsd: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | [105000] Management commentary 14 | link:calculationLink 15 | link:definitionLink 16 | link:presentationLink 17 | 18 | 19 | 20 | 21 | -------------------------------------------------------------------------------- /samples/use_api_submissions.py: -------------------------------------------------------------------------------- 1 | from pprint import pprint 2 | from edgar.client import EdgarClient 3 | 4 | # Initialize the Edgar Client 5 | edgar_client = EdgarClient() 6 | 7 | # Initialize the `Submissions` Services. 8 | submissions_services = edgar_client.submissions() 9 | 10 | # Grab all the submissions. 11 | pprint( 12 | submissions_services.get_submissions(cik='1326801') 13 | ) 14 | -------------------------------------------------------------------------------- /samples/use_api_xbrl.py: -------------------------------------------------------------------------------- 1 | from pprint import pprint 2 | from edgar.client import EdgarClient 3 | 4 | # Initialize the Edgar Client 5 | edgar_client = EdgarClient() 6 | 7 | # Initialize the `Xbrl` Services. 8 | xbrl_services = edgar_client.xbrl() 9 | 10 | # Grab the company facts for Virtusa Corp. 11 | pprint( 12 | xbrl_services.company_facts( 13 | cik='0001326801' 14 | ) 15 | ) 16 | 17 | # Grab the Current Accounts Payable for Virtusa Corp. 18 | pprint( 19 | xbrl_services.company_concepts( 20 | cik='1207074', 21 | concept='AccountsPayableCurrent' 22 | ) 23 | ) 24 | 25 | # Grab Aggregated data using the Frames endpoint. 26 | pprint( 27 | xbrl_services.frames( 28 | concept='AccountsPayableCurrent', 29 | unit_of_measure='USD', 30 | period='CY2019Q1I' 31 | ) 32 | ) 33 | -------------------------------------------------------------------------------- /samples/use_archive_service.py: -------------------------------------------------------------------------------- 1 | from pprint import pprint 2 | from edgar.client import EdgarClient 3 | 4 | # Initialize the Edgar Client 5 | edgar_client = EdgarClient() 6 | 7 | # Initialize the Archives Services. 8 | archive_services = edgar_client.archives() 9 | 10 | # Grab the Company Directories for CIK `1326801` also known as Facebook. 11 | pprint(archive_services.get_company_directories(cik='1326801')[:2]) 12 | 13 | # Grab a specific Company Directory for CIK `1326801` also known as Facebook. 14 | pprint( 15 | archive_services.get_company_directory( 16 | cik='1326801', 17 | filing_id='000095010321003805' 18 | ) 19 | ) 20 | 21 | # Grab a specific Company Directory for CIK `1326801` also known as Facebook. 22 | pprint(archive_services.get_feed(year=1996, quarter='qtr4')) 23 | 24 | # Grab the old loads for the year 1996 of Qtr 4. 25 | pprint(archive_services.get_old_loads(year=1996, quarter='qtr4')) 26 | 27 | # Grab all the Virtual Private Reference Rooms. 28 | pprint(archive_services.get_virtual_private_reference_rooms()) 29 | 30 | # Grab a specific Virtual Private Reference Room. 31 | pprint(archive_services.get_virtual_private_reference_room(film_number='1403')) 32 | 33 | # Grab all the Daily Indexes. 34 | pprint(archive_services.get_daily_indexes()) 35 | 36 | # Grab the Daily Indexes for QTR4 of 2002. 37 | pprint(archive_services.get_daily_index(year=2002, quarter='qtr4')) 38 | 39 | # Grab all the Full Indexes. 40 | pprint(archive_services.get_full_indexes()) 41 | 42 | # Grab the Full Indexes for QTR4 of 2002. 43 | pprint(archive_services.get_full_index(year=2002)) -------------------------------------------------------------------------------- /samples/use_client.py: -------------------------------------------------------------------------------- 1 | import pprint 2 | from datetime import date 3 | from edgar.client import EdgarClient 4 | from edgar.enums import FilingTypeCodes 5 | 6 | # Initalize the client. 7 | edgar_client = EdgarClient() 8 | -------------------------------------------------------------------------------- /samples/use_company_service.py: -------------------------------------------------------------------------------- 1 | from pprint import pprint 2 | from edgar.client import EdgarClient 3 | from edgar.enums import StateCodes 4 | from edgar.enums import CountryCodes 5 | from edgar.enums import StandardIndustrialClassificationCodes 6 | 7 | # Initialize the Edgar Client 8 | edgar_client = EdgarClient() 9 | 10 | # Initialize the Company Services. 11 | company_services = edgar_client.companies() 12 | 13 | # Grab all the companies that are based in Texas. 14 | pprint(company_services.get_companies_by_state(state_code='TX')) 15 | 16 | # Alternatively, if you didn't know the 2 letter code you coude pass through an Enum. 17 | pprint( 18 | company_services.get_companies_by_state( 19 | state_code=StateCodes.West_Virginia 20 | ) 21 | ) 22 | 23 | # Grab all the companies that are based in Australia, same logic here with the Enums. 24 | pprint( 25 | company_services.get_companies_by_country( 26 | country_code=CountryCodes.AUSTRALIA 27 | ) 28 | ) 29 | 30 | # Grab all the companies that are Oil & Gas Services Companies, same logic here with the Enums. 31 | pprint( 32 | company_services.get_companies_by_sic( 33 | sic_code=StandardIndustrialClassificationCodes.OIL_AND_GAS_FIELD_SERVICES_NEC 34 | ) 35 | ) 36 | 37 | # Return a company by the file number. 38 | pprint( 39 | company_services.get_company_by_file_number(file_number='021-230507') 40 | ) 41 | 42 | # Return a company by their CIK Number. 43 | pprint( 44 | company_services.get_company_by_cik(cik='1628533') 45 | ) 46 | 47 | # Search a company using their name. 48 | pprint( 49 | company_services.get_companies_by_name(name='Microsoft') 50 | ) 51 | 52 | 53 | pprint( 54 | company_services.query( 55 | company_name='Superior Well Services, INC', 56 | sic_code=StandardIndustrialClassificationCodes.OIL_AND_GAS_FIELD_SERVICES_NEC 57 | ) 58 | ) 59 | -------------------------------------------------------------------------------- /samples/use_current_events_service.py: -------------------------------------------------------------------------------- 1 | from pprint import pprint 2 | from edgar.client import EdgarClient 3 | 4 | # Initialize the Edgar Client 5 | edgar_client = EdgarClient() 6 | 7 | # Initialize the Current Events Services. 8 | current_events_services = edgar_client.current_events() 9 | 10 | # Grab all the companies that are based in Texas. 11 | pprint(current_events_services.get_current_event_filings(days_prior=0, form='10-k-annual')) 12 | -------------------------------------------------------------------------------- /samples/use_dataset_service.py: -------------------------------------------------------------------------------- 1 | from pprint import pprint 2 | from edgar.client import EdgarClient 3 | 4 | # Initialize the Edgar Client 5 | edgar_client = EdgarClient() 6 | 7 | # Initialize the `Datasets` Services. 8 | datasets_service = edgar_client.datasets() 9 | 10 | # Grab all the SEC Datasets. 11 | pprint( 12 | datasets_service.get_sec_datasets() 13 | ) 14 | 15 | # Grab all the Edgar Taxonomies used in SEC filings.. 16 | pprint( 17 | datasets_service.get_edgar_taxonomies() 18 | ) 19 | -------------------------------------------------------------------------------- /samples/use_filings_service.py: -------------------------------------------------------------------------------- 1 | from pprint import pprint 2 | from edgar.client import EdgarClient 3 | from edgar.enums import FilingTypeCodes 4 | 5 | # Initialize the Edgar Client 6 | edgar_client = EdgarClient() 7 | 8 | # Initialize the `Filings` Services. 9 | filings_service = edgar_client.filings() 10 | 11 | # Grab some filings for Facebook. 12 | pprint( 13 | filings_service.get_filings_by_cik(cik='1326801') 14 | ) 15 | 16 | # Grab the 10-Ks for Facebook, 17 | pprint( 18 | filings_service.get_filings_by_type( 19 | cik='1326801', 20 | filing_type=FilingTypeCodes.FILING_10K 21 | ) 22 | ) 23 | 24 | # Grab some filings for Facebook using the advance query. 25 | pprint( 26 | filings_service.query( 27 | cik='1326801', 28 | filing_type='10-k' 29 | ) 30 | ) 31 | -------------------------------------------------------------------------------- /samples/use_issuers_service.py: -------------------------------------------------------------------------------- 1 | from pprint import pprint 2 | from edgar.client import EdgarClient 3 | from edgar.enums import StateCodes 4 | from edgar.enums import CountryCodes 5 | from edgar.enums import StandardIndustrialClassificationCodes 6 | 7 | # Initialize the Edgar Client 8 | edgar_client = EdgarClient() 9 | 10 | # Initialize the Issuers Services. 11 | issuers_service = edgar_client.issuers() 12 | 13 | # Grab all the companies that are based in Texas. 14 | pprint(issuers_service.get_issuers_by_cik(cik='0001084869')) 15 | -------------------------------------------------------------------------------- /samples/use_mutual_funds_service.py: -------------------------------------------------------------------------------- 1 | from pprint import pprint 2 | from edgar.client import EdgarClient 3 | 4 | # Initialize the Edgar Client 5 | edgar_client = EdgarClient() 6 | 7 | # Initialize the `MutualFunds` Services. 8 | mutual_funds_services = edgar_client.mutual_funds() 9 | 10 | # Grab all the mutual fund filings for a specific CIK.. 11 | pprint( 12 | mutual_funds_services.get_mutual_fund_filings_by_type( 13 | cik='C000005186', 14 | mutual_fund_type='mutual-fund', 15 | number_of_filings=300 16 | ) 17 | ) 18 | 19 | # Grab all the mutual fund filings for a specific name.. 20 | pprint( 21 | mutual_funds_services.get_mutual_funds_by_name( 22 | company_name='ADVANCED SERIES TRUST', 23 | ) 24 | ) 25 | 26 | # Grab all the series and Contracts. 27 | pprint( 28 | mutual_funds_services.list_series_and_contracts_by_cik( 29 | cik='814679' 30 | ) 31 | ) 32 | -------------------------------------------------------------------------------- /samples/use_ownership_filings_service.py: -------------------------------------------------------------------------------- 1 | from pprint import pprint 2 | from edgar.client import EdgarClient 3 | 4 | # Initialize the Edgar Client 5 | edgar_client = EdgarClient() 6 | 7 | # Initialize the `OwnershipFilings` Services. 8 | filings_service = edgar_client.ownership_filings() 9 | 10 | # Grab all the Ownership Filings that fall under a certain CIK number. 11 | pprint( 12 | filings_service.get_ownership_filings_by_cik( 13 | cik='1326801' 14 | ) 15 | ) 16 | 17 | # Grab all the Ownership Filings that fall under a certain company name. 18 | pprint( 19 | filings_service.get_ownership_filings_by_name( 20 | company_name='Facebook' 21 | ) 22 | ) 23 | 24 | # Grab all the Non-Ownership Filings that fall under a certain CIK number. 25 | pprint( 26 | filings_service.get_non_ownership_filings_by_cik( 27 | cik='1326801' 28 | ) 29 | ) 30 | 31 | # Grab all the Non-Ownership Filings that fall under a certain company name. 32 | pprint( 33 | filings_service.get_non_ownership_filings_by_name( 34 | company_name='Facebook' 35 | ) 36 | ) 37 | 38 | # Complex Query for Ownership Filings. 39 | pprint( 40 | filings_service.query_ownership_filings( 41 | company_name='Facebook', 42 | after_date='2019-12-01' 43 | ) 44 | ) 45 | 46 | # Complex Query for Ownership Filings. 47 | pprint( 48 | filings_service.query_non_ownership_filings( 49 | company_name='Facebook', 50 | after_date='2019-12-01' 51 | ) 52 | ) -------------------------------------------------------------------------------- /samples/use_series_service.py: -------------------------------------------------------------------------------- 1 | from pprint import pprint 2 | from edgar.client import EdgarClient 3 | 4 | # Initialize the Edgar Client 5 | edgar_client = EdgarClient() 6 | 7 | # Initialize the `Series` Services. 8 | series_services = edgar_client.series() 9 | 10 | # Grab a series by the CIK number. 11 | pprint(series_services.get_series_by_cik(cik='814679')) 12 | 13 | # Grab all the series that belong to a particular series ID. 14 | pprint(series_services.get_series_by_series_id(series_id='S000001976')) 15 | 16 | # Get the filings that belong to a particular Series ID. 17 | pprint(series_services.get_series_filings_by_series_id(series_id='S000001976')) 18 | -------------------------------------------------------------------------------- /samples/use_variable_insurance_products.py: -------------------------------------------------------------------------------- 1 | from pprint import pprint 2 | from edgar.client import EdgarClient 3 | 4 | # Initialize the Edgar Client 5 | edgar_client = EdgarClient() 6 | 7 | # Initialize the `VariableInsuranceProducts` Services. 8 | insurance_prods_services = edgar_client.variable_insurance_products() 9 | 10 | # Grab all the products that fall under a certain name. 11 | insurance_prods_services.get_products_by_name( 12 | company_name='goldman sachs' 13 | ) -------------------------------------------------------------------------------- /setup.py: -------------------------------------------------------------------------------- 1 | from setuptools import setup 2 | from setuptools import find_namespace_packages 3 | 4 | # load the README file. 5 | with open(file="README.md", mode="r", encoding="utf-8") as readme_file: 6 | long_description = readme_file.read() 7 | 8 | setup( 9 | 10 | # this will be my Library name. 11 | name='python-sec', 12 | 13 | # Want to make sure people know who made it. 14 | author='Alex Reed', 15 | 16 | # also an email they can use to reach out. 17 | author_email='coding.sigma@gmail.com', 18 | 19 | # define the version of the package. 20 | version='0.1.6', 21 | 22 | # here is a simple description of the library, this will appear when someone 23 | # searches for the library on https://pypi.org/search 24 | description='A client library for collecting and scraping SEC filings.', 25 | 26 | # I have a long description but that will just be my README file, note the 27 | # variable up above where I read the file. 28 | long_description=long_description, 29 | 30 | # want to make sure that I specify the long description as MARKDOWN. 31 | long_description_content_type="text/markdown", 32 | 33 | # here is the URL you can find the code, this is just the GitHub URL. 34 | url='https://github.com/areed1192/python-sec', 35 | 36 | # there are some dependencies to use the library, so let's list them out. 37 | install_requires=[ 38 | 'requests==2.31.0', 39 | 'urllib3==1.26.5', 40 | 'beautifulsoup4==4.9.1' 41 | ], 42 | 43 | # some keywords for my library. 44 | keywords='finance, sec, api, web scraping, financial disclosures', 45 | 46 | # here are the packages I want "build." 47 | packages=find_namespace_packages( 48 | include=['edgar', 'samples', 'tests'] 49 | ), 50 | 51 | # here we specify any package data. 52 | package_data={ 53 | "edgar": ["parsing/*"], 54 | }, 55 | 56 | # I also have some package data, like photos and JSON files, so I want to include those too. 57 | include_package_data=True, 58 | 59 | # additional classifiers that give some characteristics about the package. 60 | classifiers=[ 61 | 62 | # I want people to know it's still early stages. 63 | 'Development Status :: 3 - Alpha', 64 | 65 | # My Intended audience is mostly those who understand finance. 66 | 'Intended Audience :: Financial and Insurance Industry', 67 | 68 | # My License is MIT. 69 | 'License :: OSI Approved :: MIT License', 70 | 71 | # I wrote the client in English 72 | 'Natural Language :: English', 73 | 74 | # The client should work on all OS. 75 | 'Operating System :: OS Independent', 76 | 77 | # The client is intendend for PYTHON 3 78 | 'Programming Language :: Python :: 3' 79 | ], 80 | 81 | # you will need python 3.7 to use this libary. 82 | python_requires='>=3.7' 83 | 84 | ) 85 | --------------------------------------------------------------------------------