Actions

Le service des actions permet d'accéder aux informations sur les actions.

Liste de toutes les actions [GET /v1/shares]

Vous pouvez spécifier les paramètres suivants:

name : pour filtrer par le nom de l'action
structure : pour filtrer par le nom de la structure
currency : pour filtrer par devise
country : pour filtrer par pays
quoting_place : pour filtrer par place de cotation

Vous obtiendrez une réponse qui se présente comme suit:

    {
        "meta": {
            "total": 2,
            "count": 20,
            "per_page": 20,
            "current_page": 1,
            "total_pages": 1
        },
        "data": [
        {
            "id": 2,
            "internal_code": "BOAB",
            "isin": "BJ0000000048",
            "name": "BANK OF AFRICA BN",
            "quoting_place": "BOURSE REGIONALE DES VALEURS MOBILIERES",
            "first_quoting_date": "2000-11-17",
            "introduction_price": "28000",
            "number_of_shares": "20280524",
            "approval_number": ""
        },
        {
            "id": 3,
            "internal_code": "BOABF",
            "isin": "BF0000000133",
            "name": "BANK OF AFRICA BF",
            "quoting_place": "BOURSE REGIONALE DES VALEURS MOBILIERES",
            "first_quoting_date": "2010-12-30",
            "introduction_price": "28565",
            "number_of_shares": "22000000",
            "approval_number": ""
        }
        ]
    } 

Récupération des informations d'une action [GET /v1/shares/{id}]

"data": {
        "id": 3,
        "internal_code": "BOABF",
        "isin": "BF0000000133",
        "name": "BANK OF AFRICA BURKINA FASO",
        "quoting_place_code": "BRVM",
        "quoting_place_name": "BOURSE REGIONALE DES VALEURS MOBILIERES",
        "first_quoting_date": "2010-12-30T00:00:00.000000Z",
        "introduction_price": 28565,
        "number_of_shares": 22000000,
        "approval_number": "",
        "code": "BOA BF",
        "country_code": "BF",
        "country_name": "BURKINA FASO",
        "currency_code": "XOF",
        "currency_name": "FRANC CFA",
        "profile": "Bank of Africa Burkina Faso est la 2nde banque burkinabé. L'activité s'organise essentiellement autour de 2 pôles :  banque de détail : vente de services bancaires classiques et spécialisés (crédit à la consommation, crédit mobilier, crédit immobilier, etc.) ;",
        "address": "770 Avenue du Président Aboubacar Sangoulé LAMIZANA 01 BP 1319",
        "phone_number": " (+226) 50 30 88 70/73",
        "email": "information@boaburkinafaso.com",
        "website": "www.boaburkinafaso.com",
        "legal_status": "Société Anonyme",
        "siren": "",
        "creation_year": null,
        "outlook": "A fin 2013, le groupe gère 437,6 M€ d'encours de dépôts et 416,7 M€ d'encours de crédits. La commercialisation des produits et services est assurée au travers d'un réseau de 31 agences implantées au Burkina Faso.",
        "historical": "",
        "investment": "",
        "activity_area": "BANQUE ET FINANCE",
        "reuters_code": "",
        "bloomberg_code": "",
        "mnemo_code": "BOABF",
        "quoting_method": "2",
        "fax": "+226 50 30 88 74",
        "last_date_price": "2022-08-03T00:00:00.000000Z",
        "last_day_price": "5700.00",
        "last_variation": "0.00",
        "last_volume": "311.00",
        "last_closing_price": "5700.00",
        "last_opening_price": "5750.00",
        "last_upper": "5750.00",
        "last_lower": "5700.00",
        "last_per": "5.90",
        "varp7d": 0.0169,
        "varp1m": 0.027,
        "varp3m": -0.0339,
        "varp6m": -0.0484,
        "varpYtd": 0,
        "varp1y": 0.4615,
        "varp2y": 0.5261,
        "varp3y": 0.2667,
        "varp5y": -0.5929,
        "volat7d": 0.0147,
        "volat1m": 0.0157,
        "volat3m": 0.0166,
        "volat6m": 0.022,
        "volat1y": 0.0226,
        "volat2y": 0.0226,
        "volat3y": 0.024,
        "volat5y": 0.0306
    }

Récupération du cours d'une action [GET /v1/shares/price/{id}]

"meta": {
        "total": 2,
        "count": 20,
        "per_page": 20,
        "current_page": 1,
        "total_pages": 89
    },
    "data": [
        {
            "id": "1",
            "date_cours": "2019-08-05",
            "cours_jour": "2695.0",
            "variation": "-3.75",
            "volume": null,
            "cours_fermeture": null,
            "cours_ouverture": null,
            "plus_haut": null,
            "plus_bas": null,
            "per_estime": null
        },
        {
            "id": "1",
            "date_cours": "2019-02-22",
            "cours_jour": "3400.0",
            "variation": "1.49",
            "volume": null,
            "cours_fermeture": null,
            "cours_ouverture": null,
            "plus_haut": null,
            "plus_bas": null,
            "per_estime": null
        }

Récupération de l'historique du cours d’une action [GET /v1/shares/historic/{id}]

Vous pouvez spécifier les paramètres suivants:

from : (format YYYY-mm-dd), pour récupérer depuis une date donnée
to : (format YYYY-mm-dd), pour récupérer l'historique jusqu'à une date précise

"meta": {
        "total": 2,
        "count": 20,
        "per_page": 20,
        "current_page": 1,
        "total_pages": 1
    },
    "data": [
        {
            "id": "3",
            "price_date": "2022-08-03",
            "day_price": "5700.0",
            "closing_price": "5700.0",
            "opening_price": "5750.0",
            "variation": "0.0",
            "volume": "311.0",
            "upper": "5750.0",
            "lower": "5700.0",
            "reference_price": "5700.0"
        },
        {
            "id": "3",
            "price_date": "2022-08-02",
            "day_price": "5700.0",
            "closing_price": "5700.0",
            "opening_price": "5750.0",
            "variation": "-0.87",
            "volume": "90.0",
            "upper": "5750.0",
            "lower": "5700.0",
            "reference_price": "5727.8900000000003"
        }
    ]

Récupération les données financières d’une société cotée [GET /v1/shares/financial-data/{id}]

"meta": {
        "total": 2,
        "per_page": 20,
        "current_page": 1,
        "total_pages": 1
    },
    "data": [
        {
            "id": "3703",
            "fiscal_year": "2021-12-31 00:00:00.000",
            "net_banking_income": null,
            "net_income_growth": null,
            "net_profit": null,
            "net_profit_growth": "-73.51",
            "dividend_per_share": null,
            "dividend_yield": null,
            "dividend_payment_date": null,
            "financial_per": null
        },
        {
            "id": "3827",
            "fiscal_year": "2021-12-31 00:00:00.000",
            "net_banking_income": null,
            "net_income_growth": null,
            "net_profit": "1414667000",
            "net_profit_growth": "-2.17",
            "dividend_per_share": null,
            "dividend_yield": null,
            "dividend_payment_date": "2021-03-26 00:00:00.000",
            "financial_per": null
        }
    ]

Récupération du conseil d'administration d’une société cotée [GET /v1/shares/board-of-directors/{id}]

Cet endpoint renvoie la liste des membres du conseil d'administration

"meta": {
        "total": 3,
        "per_page": 20,
        "current_page": 1,
        "total_pages": 1
    },
    "data": [
        {
            "id": 4,
            "name": "Lala MOULAYE EZZEDINE",
            "title": "Administrateur Représentant BOA WEST AFRICA",
            "nomination_date": null
        },
        {
            "id": 6,
            "name": "Amine BOUABID",
            "title": "administrateur réprésentant BMCE BANK",
            "nomination_date": null
        },
        {
            "id": 18,
            "name": "Lassiné DIAWARA",
            "title": "Président du Conseil d’Administration",
            "nomination_date": null
        }
    ]

Récupération de la direction générale d’une société cotée [GET /v1/shares/executive-management/{id}]

Cet endpoint renvoie la liste des membres de la direction générale

"meta": {
        "total": 3,
        "per_page": 20,
        "current_page": 1,
        "total_pages": 1
    },
    "data": [
        {
            "id": 8,
            "name": "Faustin AMOUSSOU",
            "title": "Directeur Général",
            "nomination_date": null
        },
        {
            "id": 16,
            "name": "Marcel BASSOLE",
            "title": "Directeur Général Adjoint - Support",
            "nomination_date": null
        },
        {
            "id": 17,
            "name": "Abdel ZAMPALEGRE",
            "title": "Directeur Général Adjoint - Exploitation",
            "nomination_date": null
        }
    ]

Récupération des commissaires aux comptes d’une société cotée [GET /v1/shares/auditors/{id}]

[
        {
            "id": "1074",
            "named": "CABINET ROSSETTE NACRO",
            "type": null,
            "phone": "(+226) 25 36 34 87 / 82",
            "address": "Ouagadougou"
        },
        {
            "id": "1470",
            "named": "SOCIETE FIDUCIAIRE INTERNATIONALE D EXPERT COMPTABLE",
            "type": "",
            "phone": "(+225) 21 35 67 78 / 21 35 06 09",
            "address": "Abidjan, Marcory Bd. de Marseille, Impasse Saturne, km 6"
        }
    ]

Récupération des actionnaires d’une société cotée [GET /v1/shares/shareholders/{id}]

"meta": {
        "total": 3,
        "per_page": 20,
        "current_page": 1,
        "total_pages": 1
    },
    "data": [
        {
            "named": "Autres Actionnaires",
            "share_percentage": "0.58999999999999997",
            "voting_rights_percentage": "NA"
        },
        {
            "named": "BOA WEST AFRICA",
            "share_percentage": "56.479999999999997",
            "voting_rights_percentage": ""
        },
        {
            "named": "Actionnaires Privées",
            "share_percentage": "25.329999999999998",
            "voting_rights_percentage": "NA"
        }
    ]

Récupération de l'agenda des évènements d’une société cotée [GET /v1/shares/diary/{id}]

 "meta": {
        "total": 3,
        "count": 20,
        "per_page": 20,
        "current_page": 1,
        "total_pages": 1
    },
    "data": [
        {
            "id": null,
            "title": "Assemblée Générale Ordinaire",
            "description": "Lieu: Salle WAONGO I de l'hôtel LAICO à Ouaga 2000 Heure: 10H00",
            "date": "2019-04-02"
        },
        {
            "id": null,
            "title": "Paiement de dividendes",
            "description": "Paiement de dividendes - Exercice 2018 - BOA BURKINA FASO mettra en paiement, 02/05/2019, son dividende annuel de 366 FCFA net par action au titre de l'exercice 2018",
            "date": "2019-05-02"
        },
        {
            "id": null,
            "title": "Etats financiers ",
            "description": "Etats financiers certifiés et approuvés exercice 2019 - BOA BURKINA FASO",
            "date": "2020-08-21"
        }
    ]

Récupération des documents d’une société cotée [GET /v1/shares/documents/{id}]

"meta": {
        "total": 3,
        "per_page": 20,
        "current_page": 1,
        "total_pages": 1
    },
    "data": [
        {
            "name": "Etats Financiers",
            "path": "http://orishas-api.local/shared/documents/c/737BOA_BF_etats_financiers_2015.pdf",
            "date": "2015-12-31"
        },
        {
            "name": "Rapport Annuel",
            "path": "http://orishas-api.local/shared/documents/c/14BOA_BF_rapport_annuel_2009.pdf",
            "date": "2009-12-31"
        },
        {
            "name": "Rapport Annuel",
            "path": "http://orishas-api.local/shared/documents/c/517BOA_BF_rapport_annuel_2010.pdf",
            "date": "2010-12-31"
        }
        
    ]

Récupération des notations d’une société cotée [GET /v1/shares/rating/{id}]

"meta": {
        "total": 3,
        "per_page": 20,
        "current_page": 1,
        "total_pages": 1
    },
    "data": [
        {
            "id": 98,
            "rating_agency": "BLOOMFIELD INVESTMENT CORPORATION",
            "long_term_note": "A",
            "short_term_note": "A2",
            "long_perspective": "Stable",
            "short_perspective": "Stable",
            "expiration_date": "2019-07-30 00:00:00.000"
        },
        {
            "id": 86,
            "rating_agency": "BLOOMFIELD INVESTMENT CORPORATION",
            "long_term_note": "A",
            "short_term_note": "A1",
            "long_perspective": "Stable",
            "short_perspective": "Stable",
            "expiration_date": "2019-05-31 00:00:00.000"
        },
        {
            "id": 17,
            "rating_agency": "BLOOMFIELD INVESTMENT CORPORATION",
            "long_term_note": "A",
            "short_term_note": "A1",
            "long_perspective": "Stable",
            "short_perspective": "Stable",
            "expiration_date": "2017-12-31 00:00:00.000"
        }
    ]    

Actions

Liste de toutes les actions [GET /v1/shares]​

Récupération des informations d'une action [GET /v1/shares/{id}]​

Récupération du cours d'une action [GET /v1/shares/price/{id}]​

Récupération de l'historique du cours d’une action [GET /v1/shares/historic/{id}]​

Récupération les données financières d’une société cotée [GET /v1/shares/financial-data/{id}]​

Récupération du conseil d'administration d’une société cotée [GET /v1/shares/board-of-directors/{id}]​

Récupération de la direction générale d’une société cotée [GET /v1/shares/executive-management/{id}]​

Récupération des commissaires aux comptes d’une société cotée [GET /v1/shares/auditors/{id}]​

Récupération des actionnaires d’une société cotée [GET /v1/shares/shareholders/{id}]​

Récupération de l'agenda des évènements d’une société cotée [GET /v1/shares/diary/{id}]​

Récupération des documents d’une société cotée [GET /v1/shares/documents/{id}]​

Récupération des notations d’une société cotée [GET /v1/shares/rating/{id}]​