Aller au contenu principal

Actions

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

Types de données​

SharesDto​

AttributTypeDescription
idIntIdentifiant unique
internal_codeStringCode Orishas
isinStringCode ISIN
nameStringNom de l'action
quoting_place_codeStringCode de la place de cotation
quoting_place_nameStringNom de la place de cotation
first_quoting_dateDateDate de première cotation
introduction_priceFloatPrix d'introduction
number_of_sharesIntNombre d'actions émises
approval_numberStringNuméro d'agrément
org_codeStringCode de la société
org_nameStringNom de la société
country_codeStringCode ISO alpha-2 du pays
country_nameStringNom du pays
currency_codeStringCode de la devise
currency_nameStringNom de la devise
profileStringPrésentation de la société
addressStringAdresse du siège social
phone_numberStringNuméro de téléphone
emailStringAdresse email
websiteStringSite web
legal_statusStringForme juridique
sirenStringNuméro SIREN
creation_yearStringDate de création de la société
outlookStringPerspectives
historicalStringHistorique
investmentStringThèse d'investissement
activity_areaStringSecteur d'activité
reuters_codeStringCode Reuters
bloomberg_codeStringCode Bloomberg
mnemo_codeStringCode mnémonique
quoting_methodStringMéthode de cotation
faxStringNuméro de fax
last_date_priceDateDate du dernier cours
last_day_priceFloatDernier cours du jour
last_variationFloatDernière variation
last_volumeFloatDernier volume échangé
last_closing_priceFloatDernier cours de clôture
last_opening_priceFloatDernier cours d'ouverture
last_upperFloatPlus haut du dernier cours
last_lowerFloatPlus bas du dernier cours
last_perFloatDernier PER
varp7dFloatPerformance sur les 7 derniers jours
varp1mFloatPerformance sur 1 mois
varp3mFloatPerformance sur 3 mois
varp6mFloatPerformance sur 6 mois
varpYtdFloatPerformance depuis le début de l'année
varp1yFloatPerformance sur 1 an
varp2yFloatPerformance sur 2 ans
varp3yFloatPerformance sur 3 ans
varp5yFloatPerformance sur 5 ans
volat7dFloatVolatilité sur 7 jours
volat1mFloatVolatilité sur 1 mois
volat3mFloatVolatilité sur 3 mois
volat6mFloatVolatilité sur 6 mois
volat1yFloatVolatilité sur 1 an
volat2yFloatVolatilité sur 2 ans
volat3yFloatVolatilité sur 3 ans
volat5yFloatVolatilité sur 5 ans

SharesPriceItem​

AttributTypeDescription
idStringIdentifiant de l'action
price_dateDateDate du cours
day_priceFloatCours du jour
variationFloatVariation
volumeFloatVolume échangé
closing_priceFloatCours de clôture
opening_priceFloatCours d'ouverture
upperFloatPlus haut
lowerFloatPlus bas
perFloatPER

SharesFinancialItem​

AttributTypeDescription
idStringIdentifiant unique
fiscal_yearDateExercice fiscal
net_banking_incomeFloatProduit net bancaire
net_income_growthFloatCroissance du résultat net
net_profitFloatRésultat net
net_profit_growthFloatCroissance du résultat net (%)
dividend_per_shareFloatDividende par action
dividend_yieldFloatRendement du dividende
dividend_payment_dateDateDate de paiement du dividende
perFloatPER

SharesBoardMemberDto​

Utilisé pour les membres du conseil d'administration et de la direction générale.

AttributTypeDescription
idStringIdentifiant unique
titleStringFonction occupée
fromDateDate de début de mandat
toDateDate de fin de mandat
last_renewDateDate du dernier renouvellement
personPersonDtoInformations sur la personne

PersonDto​

AttributTypeDescription
nameStringNom complet
birthdateDateDate de naissance
genderStringGenre
addressStringAdresse
phoneStringNuméro de téléphone

SharesAuditorDto​

AttributTypeDescription
idStringIdentifiant unique
nameStringNom du cabinet
typeStringType de commissariat aux comptes
phoneStringNuméro de téléphone
addressStringAdresse

SharesShareholderDto​

AttributTypeDescription
nameStringNom de l'actionnaire
shareFloatPart détenue (%)
voting_rightsStringDroits de vote

SharesDiaryDto​

AttributTypeDescription
idStringIdentifiant unique
structure_idStringIdentifiant de l'action
structure_nameStringNom de l'action
titleStringTitre de l'évènement
descriptionStringDescription de l'évènement
dateDateDate de l'évènement

SharesDocumentDto​

AttributTypeDescription
nameStringDescriptif du document
pathStringURL du document
dateDateDate du document

SharesRatingDto​

AttributTypeDescription
idIntIdentifiant unique
rating_agencyStringAgence de notation
long_term_noteStringNote long terme
short_term_noteStringNote court terme
long_perspectiveStringPerspective long terme
short_perspectiveStringPerspective court terme
expiration_dateDateDate d'expiration de la notation

Liste des actions​

Requête​

Point de terminaison​

/v1/shares

Attributs de filtrage​

AttributTypeDescription
limitNumberNombre d'éléments par page
pageNumberNuméro de page
nameStringFiltrer par nom de l'action
structureStringFiltrer par nom de la structure
currencyStringFiltrer par devise
countryStringFiltrer par pays
quoting_placeStringFiltrer par place de cotation

Réponse​

AttributTypeDescription
metaPageDtoInformations relatives aux données
dataList<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",
"email": "information@boacoteivoire.com",
"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​

AttributTypeDescription
dataSharesDtoDé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",
"email": "information@boacoteivoire.com",
"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​

AttributTypeDescription
limitNumberNombre d'éléments par page
pageNumberNuméro de page

Réponse​

AttributTypeDescription
metaPageDtoInformations relatives aux données
dataList<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​

AttributTypeDescription
limitNumberNombre d'éléments par page
pageNumberNuméro de page
fromDateRécupérer depuis une date donnée (format YYYY-mm-dd)
toDateRécupérer l'historique jusqu'à une date précise (format YYYY-mm-dd)

Réponse​

AttributTypeDescription
metaPageDtoInformations relatives aux données
dataList<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​

AttributTypeDescription
limitNumberNombre d'éléments par page
pageNumberNuméro de page

Réponse​

AttributTypeDescription
metaPageDtoInformations relatives aux données
dataList<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​

AttributTypeDescription
limitNumberNombre d'éléments par page
pageNumberNuméro de page

Réponse​

AttributTypeDescription
metaPageDtoInformations relatives aux données
dataList<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​

AttributTypeDescription
limitNumberNombre d'éléments par page
pageNumberNuméro de page

Réponse​

AttributTypeDescription
metaPageDtoInformations relatives aux données
dataList<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​

AttributTypeDescription
dataList<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​

AttributTypeDescription
limitNumberNombre d'éléments par page
pageNumberNuméro de page

Réponse​

AttributTypeDescription
metaPageDtoInformations relatives aux données
dataList<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​

AttributTypeDescription
limitNumberNombre d'éléments par page
pageNumberNuméro de page

Réponse​

AttributTypeDescription
metaPageDtoInformations relatives aux données
dataList<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​

AttributTypeDescription
limitNumberNombre d'éléments par page
pageNumberNuméro de page

Réponse​

AttributTypeDescription
metaPageDtoInformations relatives aux données
dataList<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​

AttributTypeDescription
limitNumberNombre d'éléments par page
pageNumberNuméro de page

Réponse​

AttributTypeDescription
metaPageDtoInformations relatives aux données
dataList<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"
},
...
]
}