Actions
Le service des actions permet d'accéder aux informations sur les actions.
Types de données
SharesDto
| Attribut | Type | Description |
|---|---|---|
| id | Int | Identifiant unique |
| internal_code | String | Code Orishas |
| isin | String | Code ISIN |
| name | String | Nom de l'action |
| quoting_place_code | String | Code de la place de cotation |
| quoting_place_name | String | Nom de la place de cotation |
| first_quoting_date | Date | Date de première cotation |
| introduction_price | Float | Prix d'introduction |
| number_of_shares | Int | Nombre d'actions émises |
| approval_number | String | Numéro d'agrément |
| org_code | String | Code de la société |
| org_name | String | Nom de la société |
| country_code | String | Code ISO alpha-2 du pays |
| country_name | String | Nom du pays |
| currency_code | String | Code de la devise |
| currency_name | String | Nom de la devise |
| profile | String | Présentation de la société |
| address | String | Adresse du siège social |
| phone_number | String | Numéro de téléphone |
| String | Adresse email | |
| website | String | Site web |
| legal_status | String | Forme juridique |
| siren | String | Numéro SIREN |
| creation_year | String | Date de création de la société |
| outlook | String | Perspectives |
| historical | String | Historique |
| investment | String | Thèse d'investissement |
| activity_area | String | Secteur d'activité |
| reuters_code | String | Code Reuters |
| bloomberg_code | String | Code Bloomberg |
| mnemo_code | String | Code mnémonique |
| quoting_method | String | Méthode de cotation |
| fax | String | Numéro de fax |
| last_date_price | Date | Date du dernier cours |
| last_day_price | Float | Dernier cours du jour |
| last_variation | Float | Dernière variation |
| last_volume | Float | Dernier volume échangé |
| last_closing_price | Float | Dernier cours de clôture |
| last_opening_price | Float | Dernier cours d'ouverture |
| last_upper | Float | Plus haut du dernier cours |
| last_lower | Float | Plus bas du dernier cours |
| last_per | Float | Dernier PER |
| varp7d | Float | Performance sur les 7 derniers jours |
| varp1m | Float | Performance sur 1 mois |
| varp3m | Float | Performance sur 3 mois |
| varp6m | Float | Performance sur 6 mois |
| varpYtd | Float | Performance depuis le début de l'année |
| varp1y | Float | Performance sur 1 an |
| varp2y | Float | Performance sur 2 ans |
| varp3y | Float | Performance sur 3 ans |
| varp5y | Float | Performance sur 5 ans |
| volat7d | Float | Volatilité sur 7 jours |
| volat1m | Float | Volatilité sur 1 mois |
| volat3m | Float | Volatilité sur 3 mois |
| volat6m | Float | Volatilité sur 6 mois |
| volat1y | Float | Volatilité sur 1 an |
| volat2y | Float | Volatilité sur 2 ans |
| volat3y | Float | Volatilité sur 3 ans |
| volat5y | Float | Volatilité sur 5 ans |
SharesPriceItem
| Attribut | Type | Description |
|---|---|---|
| id | String | Identifiant de l'action |
| price_date | Date | Date du cours |
| day_price | Float | Cours du jour |
| variation | Float | Variation |
| volume | Float | Volume échangé |
| closing_price | Float | Cours de clôture |
| opening_price | Float | Cours d'ouverture |
| upper | Float | Plus haut |
| lower | Float | Plus bas |
| per | Float | PER |
SharesFinancialItem
| Attribut | Type | Description |
|---|---|---|
| id | String | Identifiant unique |
| fiscal_year | Date | Exercice fiscal |
| net_banking_income | Float | Produit net bancaire |
| net_income_growth | Float | Croissance du résultat net |
| net_profit | Float | Résultat net |
| net_profit_growth | Float | Croissance du résultat net (%) |
| dividend_per_share | Float | Dividende par action |
| dividend_yield | Float | Rendement du dividende |
| dividend_payment_date | Date | Date de paiement du dividende |
| per | Float | PER |
SharesBoardMemberDto
Utilisé pour les membres du conseil d'administration et de la direction générale.
| Attribut | Type | Description |
|---|---|---|
| id | String | Identifiant unique |
| title | String | Fonction occupée |
| from | Date | Date de début de mandat |
| to | Date | Date de fin de mandat |
| last_renew | Date | Date du dernier renouvellement |
| person | PersonDto | Informations sur la personne |
PersonDto
| Attribut | Type | Description |
|---|---|---|
| name | String | Nom complet |
| birthdate | Date | Date de naissance |
| gender | String | Genre |
| address | String | Adresse |
| phone | String | Numéro de téléphone |
SharesAuditorDto
| Attribut | Type | Description |
|---|---|---|
| id | String | Identifiant unique |
| name | String | Nom du cabinet |
| type | String | Type de commissariat aux comptes |
| phone | String | Numéro de téléphone |
| address | String | Adresse |
SharesShareholderDto
| Attribut | Type | Description |
|---|---|---|
| name | String | Nom de l'actionnaire |
| share | Float | Part détenue (%) |
| voting_rights | String | Droits de vote |
SharesDiaryDto
| Attribut | Type | Description |
|---|---|---|
| id | String | Identifiant unique |
| structure_id | String | Identifiant de l'action |
| structure_name | String | Nom de l'action |
| title | String | Titre de l'évènement |
| description | String | Description de l'évènement |
| date | Date | Date de l'évènement |
SharesDocumentDto
| Attribut | Type | Description |
|---|---|---|
| name | String | Descriptif du document |
| path | String | URL du document |
| date | Date | Date du document |
SharesRatingDto
| Attribut | Type | Description |
|---|---|---|
| id | Int | Identifiant unique |
| rating_agency | String | Agence de notation |
| long_term_note | String | Note long terme |
| short_term_note | String | Note court terme |
| long_perspective | String | Perspective long terme |
| short_perspective | String | Perspective court terme |
| expiration_date | Date | Date d'expiration de la notation |
Liste des actions
Requête
Point de terminaison
/v1/shares
Attributs de filtrage
| Attribut | Type | Description |
|---|---|---|
| limit | Number | Nombre d'éléments par page |
| page | Number | Numéro de page |
| name | String | Filtrer par nom de l'action |
| structure | String | Filtrer par nom de la structure |
| currency | String | Filtrer par devise |
| country | String | Filtrer par pays |
| quoting_place | String | Filtrer par place de cotation |
Réponse
| Attribut | Type | Description |
|---|---|---|
| meta | PageDto | Informations relatives aux données |
| data | List<SharesDto> | Liste des actions |
Exemple
Requête
curl --location 'https://sandbox-data.orishas-finance.com/api/v1/shares' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
Réponse
data.json
{
"meta": {
"total": 238,
"per_page": 20,
"current_page": 1,
"total_pages": 12
},
"data": [
{
"id": 1,
"internal_code": "BOAC",
"isin": "CI0000000956",
"name": "BANK OF AFRICA CI",
"quoting_place_code": "BRVM",
"quoting_place_name": "BOURSE REGIONALE DES VALEURS MOBILIERES",
"first_quoting_date": "2010-04-07",
"introduction_price": "23000.00",
"number_of_shares": 20000000,
"approval_number": "",
"org_code": "BOA CI",
"org_name": "BANK OF AFRICA COTE D IVOIRE",
"country_code": "CI",
"country_name": "COTE D'IVOIRE",
"currency_code": "XOF",
"currency_name": "FRANC CFA",
"profile": "BANK OF AFRICA - COTE D'IVOIRE, ouverte au public en janvier 1996, dispose actuellement d'un capital de 8,2 milliards de F CFA. Elle fait partie des 4 premières banques ivoiriennes cotées à la Bourse Régionale des Valeurs Mobilière (BRVM).",
"address": "Abidjan - Plateau, Avenue Terrasson de Fougères",
"phone_number": "(+225) 20 30 34 00",
"website": "www.boacoteivoire.com",
"legal_status": "Société Anonyme",
"siren": "",
"creation_year": "1996-01-29 00:00:00",
"outlook": "",
"historical": "",
"investment": "",
"activity_area": null,
"reuters_code": null,
"bloomberg_code": null,
"mnemo_code": null,
"quoting_method": null,
"fax": null,
"last_date_price": "2026-01-19",
"last_day_price": "7180.00",
"last_variation": "0.00",
"last_volume": "3011.00",
"last_closing_price": "7180.00",
"last_opening_price": "7180.00",
"last_upper": "7185.00",
"last_lower": "7150.00",
"last_per": "12.49",
"varp7d": -0.0028,
"varp1m": 0.0021,
"varp3m": -0.0178,
"varp6m": 0.1732,
"varpYtd": -0.1493,
"varp1y": 0.4134,
"varp2y": 0.0559,
"varp3y": 0.6318,
"varp5y": 1.3933,
"volat7d": 0.0012,
"volat1m": 0.0071,
"volat3m": 0.0102,
"volat6m": 0.0122,
"volat1y": 0.0152,
"volat2y": 0.0322,
"volat3y": 0.331,
"volat5y": 0.2568
},
...
]
}
Récupérer une action
Récupérer les informations d'une action en utilisant son identifiant unique.
Requête
Point de terminaison
/v1/shares/{id}
Réponse
| Attribut | Type | Description |
|---|---|---|
| data | SharesDto | Détails de l'action |
Exemple
Requête
curl --location 'https://sandbox-data.orishas-finance.com/api/v1/shares/1' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
Réponse
data.json
{
"data": {
"id": 1,
"internal_code": "BOAC",
"isin": "CI0000000956",
"name": "BANK OF AFRICA CI",
"quoting_place_code": "BRVM",
"quoting_place_name": "BOURSE REGIONALE DES VALEURS MOBILIERES",
"first_quoting_date": "2010-04-07",
"introduction_price": "23000.00",
"number_of_shares": 20000000,
"approval_number": "",
"org_code": "BOA CI",
"org_name": "BANK OF AFRICA COTE D IVOIRE",
"country_code": "CI",
"country_name": "COTE D'IVOIRE",
"currency_code": "XOF",
"currency_name": "FRANC CFA",
"profile": "BANK OF AFRICA - COTE D'IVOIRE, ouverte au public en janvier 1996, dispose actuellement d'un capital de 8,2 milliards de F CFA. Elle fait partie des 4 premières banques ivoiriennes cotées à la Bourse Régionale des Valeurs Mobilière (BRVM).",
"address": "Abidjan - Plateau, Avenue Terrasson de Fougères",
"phone_number": "(+225) 20 30 34 00",
"website": "www.boacoteivoire.com",
"legal_status": "Société Anonyme",
"siren": "",
"creation_year": "1996-01-29 00:00:00",
"outlook": "",
"historical": "",
"investment": "",
"activity_area": null,
"reuters_code": null,
"bloomberg_code": null,
"mnemo_code": null,
"quoting_method": null,
"fax": null,
"last_date_price": "2026-01-19",
"last_day_price": "7180.00",
"last_variation": "0.00",
"last_volume": "3011.00",
"last_closing_price": "7180.00",
"last_opening_price": "7180.00",
"last_upper": "7185.00",
"last_lower": "7150.00",
"last_per": "12.49",
"varp7d": -0.0028,
"varp1m": 0.0021,
"varp3m": -0.0178,
"varp6m": 0.1732,
"varpYtd": -0.1493,
"varp1y": 0.4134,
"varp2y": 0.0559,
"varp3y": 0.6318,
"varp5y": 1.3933,
"volat7d": 0.0012,
"volat1m": 0.0071,
"volat3m": 0.0102,
"volat6m": 0.0122,
"volat1y": 0.0152,
"volat2y": 0.0322,
"volat3y": 0.331,
"volat5y": 0.2568
}
}
Cours d'une action
Requête
Point de terminaison
/v1/shares/price/{id}
Attributs de filtrage
| Attribut | Type | Description |
|---|---|---|
| limit | Number | Nombre d'éléments par page |
| page | Number | Numéro de page |
Réponse
| Attribut | Type | Description |
|---|---|---|
| meta | PageDto | Informations relatives aux données |
| data | List<SharesPriceItem> | Cours de l'action |
Exemple
Requête
curl --location 'https://sandbox-data.orishas-finance.com/api/v1/shares/price/3' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
Réponse
data.json
{
"meta": {
"total": 2075,
"count": 20,
"per_page": 20,
"current_page": 1,
"total_pages": 104
},
"data": [
{
"id": "3",
"price_date": "2022-02-09",
"day_price": "6100.0",
"variation": "-0.65000000000000002",
"volume": "126.0",
"closing_price": "6100.0",
"opening_price": "6000.0",
"upper": "6100.0",
"lower": "6000.0",
"per": "7.5"
},
...
]
}
Historique du cours d'une action
Requête
Point de terminaison
/v1/shares/historic/{id}
Attributs de filtrage
| Attribut | Type | Description |
|---|---|---|
| limit | Number | Nombre d'éléments par page |
| page | Number | Numéro de page |
| from | Date | Récupérer depuis une date donnée (format YYYY-mm-dd) |
| to | Date | Récupérer l'historique jusqu'à une date précise (format YYYY-mm-dd) |
Réponse
| Attribut | Type | Description |
|---|---|---|
| meta | PageDto | Informations relatives aux données |
| data | List<SharesPriceItem> | Historique des cours |
Exemple
Requête
curl --location 'https://sandbox-data.orishas-finance.com/api/v1/shares/historic/3' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
Réponse
data.json
{
"meta": {
"total": 2075,
"count": 20,
"per_page": 20,
"current_page": 1,
"total_pages": 104
},
"data": [
{
"id": "3",
"price_date": "2024-01-17",
"day_price": "7195.0",
"closing_price": "7195.0",
"opening_price": "7195.0",
"variation": "0.0",
"volume": "41.0",
"upper": "7195.0",
"lower": "7195.0",
"per": "6.21"
},
...
]
}
Données financières d'une société cotée
Requête
Point de terminaison
/v1/shares/financial-data/{id}
Attributs de filtrage
| Attribut | Type | Description |
|---|---|---|
| limit | Number | Nombre d'éléments par page |
| page | Number | Numéro de page |
Réponse
| Attribut | Type | Description |
|---|---|---|
| meta | PageDto | Informations relatives aux données |
| data | List<SharesFinancialItem> | Données financières |
Exemple
Requête
curl --location 'https://sandbox-data.orishas-finance.com/api/v1/shares/financial-data/3' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
Réponse
data.json
{
"meta": {
"total": 13,
"per_page": 20,
"current_page": 1,
"total_pages": 1
},
"data": [
{
"id": "3562",
"fiscal_year": "2020-12-31 00:00:00.000",
"net_banking_income": 47367496842,
"net_income_growth": null,
"net_profit": 17607918915,
"net_profit_growth": null,
"dividend_per_share": 370,
"dividend_yield": null,
"dividend_payment_date": "2021-05-04 00:00:00.000",
"per": null
},
...
]
}
Conseil d'administration d'une société cotée
Cet endpoint renvoie la liste des membres du conseil d'administration.
Requête
Point de terminaison
/v1/shares/board-of-directors/{id}
Attributs de filtrage
| Attribut | Type | Description |
|---|---|---|
| limit | Number | Nombre d'éléments par page |
| page | Number | Numéro de page |
Réponse
| Attribut | Type | Description |
|---|---|---|
| meta | PageDto | Informations relatives aux données |
| data | List<SharesBoardMemberDto> | Membres du conseil d'administration |
Exemple
Requête
curl --location 'https://sandbox-data.orishas-finance.com/api/v1/shares/board-of-directors/3' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
Réponse
data.json
{
"meta": {
"total": 6,
"per_page": 20,
"current_page": 1,
"total_pages": 1
},
"data": [
{
"id": "P31-4",
"title": "Administrateur Représentant BOA WEST AFRICA",
"from": null,
"to": null,
"last_renew": null,
"person": {
"name": "Lala MOULAYE EZZEDINE",
"birthdate": null,
"gender": null,
"address": "",
"phone": ""
}
},
...
]
}
Direction générale d'une société cotée
Cet endpoint renvoie la liste des membres de la direction générale.
Requête
Point de terminaison
/v1/shares/executive-management/{id}
Attributs de filtrage
| Attribut | Type | Description |
|---|---|---|
| limit | Number | Nombre d'éléments par page |
| page | Number | Numéro de page |
Réponse
| Attribut | Type | Description |
|---|---|---|
| meta | PageDto | Informations relatives aux données |
| data | List<SharesBoardMemberDto> | Membres de la direction générale |
Exemple
Requête
curl --location 'https://sandbox-data.orishas-finance.com/api/v1/shares/executive-management/3' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
Réponse
data.json
{
"meta": {
"total": 2,
"per_page": 20,
"current_page": 1,
"total_pages": 1
},
"data": [
{
"id": "D31-1",
"title": "Directeur Général",
"from": null,
"to": null,
"last_renew": null,
"person": {
"name": "Prénom NOM",
"birthdate": null,
"gender": null,
"address": "",
"phone": ""
}
},
...
]
}
Commissaires aux comptes d'une société cotée
Requête
Point de terminaison
/v1/shares/auditors/{id}
Réponse
| Attribut | Type | Description |
|---|---|---|
| data | List<SharesAuditorDto> | Commissaires aux comptes |
Exemple
Requête
curl --location 'https://sandbox-data.orishas-finance.com/api/v1/shares/auditors/3' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
Réponse
data.json
{
"data": [
{
"id": "1074",
"name": "CABINET ROSSETTE NACRO",
"type": null,
"phone": "(+226) 25 36 34 87 / 82",
"address": "Ouagadougou"
},
{
"id": "1470",
"name": "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"
}
]
}
Actionnaires d'une société cotée
Requête
Point de terminaison
/v1/shares/shareholders/{id}
Attributs de filtrage
| Attribut | Type | Description |
|---|---|---|
| limit | Number | Nombre d'éléments par page |
| page | Number | Numéro de page |
Réponse
| Attribut | Type | Description |
|---|---|---|
| meta | PageDto | Informations relatives aux données |
| data | List<SharesShareholderDto> | Actionnaires |
Exemple
Requête
curl --location 'https://sandbox-data.orishas-finance.com/api/v1/shares/shareholders/3' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
Réponse
data.json
{
"meta": {
"total": 5,
"per_page": 20,
"current_page": 1,
"total_pages": 1
},
"data": [
{
"name": "Autres Actionnaires",
"share": 0.59,
"voting_rights": "NA"
},
{
"name": "BOA WEST AFRICA",
"share": 56.48,
"voting_rights": ""
},
...
]
}
Agenda des évènements d'une société cotée
Requête
Point de terminaison
/v1/shares/diary/{id}
Attributs de filtrage
| Attribut | Type | Description |
|---|---|---|
| limit | Number | Nombre d'éléments par page |
| page | Number | Numéro de page |
Réponse
| Attribut | Type | Description |
|---|---|---|
| meta | PageDto | Informations relatives aux données |
| data | List<SharesDiaryDto> | Agenda des évènements |
Exemple
Requête
curl --location 'https://sandbox-data.orishas-finance.com/api/v1/shares/diary/3' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
Réponse
data.json
{
"meta": {
"total": 22,
"count": 20,
"per_page": 20,
"current_page": 1,
"total_pages": 2
},
"data": [
{
"id": null,
"structure_id": "3",
"structure_name": 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,
"structure_id": "3",
"structure_name": 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"
},
...
]
}
Documents d'une société cotée
Requête
Point de terminaison
/v1/shares/documents/{id}
Attributs de filtrage
| Attribut | Type | Description |
|---|---|---|
| limit | Number | Nombre d'éléments par page |
| page | Number | Numéro de page |
Réponse
| Attribut | Type | Description |
|---|---|---|
| meta | PageDto | Informations relatives aux données |
| data | List<SharesDocumentDto> | Documents |
Exemple
Requête
curl --location 'https://sandbox-data.orishas-finance.com/api/v1/shares/documents/3' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
Réponse
data.json
{
"meta": {
"total": 79,
"per_page": 20,
"current_page": 1,
"total_pages": 4
},
"data": [
{
"name": "Rapport d'activités du 3ème trimestre 2020",
"path": "https://sandbox-data.orishas-finance.com/shared/documents/c/847Rapport d'activités du 3ème trimestre 2020.pdf",
"date": "2020-10-19"
},
{
"name": "Rapport d'activité du 1er trimestre 2020",
"path": "https://sandbox-data.orishas-finance.com/shared/documents/c/279Rapport d'activité du 1er trimestre 2020.pdf",
"date": "2020-04-20"
},
...
]
}
Notations d'une société cotée
Requête
Point de terminaison
/v1/shares/rating/{id}
Attributs de filtrage
| Attribut | Type | Description |
|---|---|---|
| limit | Number | Nombre d'éléments par page |
| page | Number | Numéro de page |
Réponse
| Attribut | Type | Description |
|---|---|---|
| meta | PageDto | Informations relatives aux données |
| data | List<SharesRatingDto> | Notations |
Exemple
Requête
curl --location 'https://sandbox-data.orishas-finance.com/api/v1/shares/rating/3' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
Réponse
data.json
{
"meta": {
"total": 5,
"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"
},
...
]
}