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": "[email protected]",
"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"
}
]