samedi 14 décembre 2013

API : Bourse De Tunis

BourseTunisAPI



  BourseTunisAPI permet l'extraction des données de la bourse Tunisienne à temps réel. Elle est programmé en JAVA et peut être incluse dans n'importe quel projet JAVA.
   Les données pouvant être extraites avec cette API sont :
   1/ Les informations des différentes sociétés cotées dans la bourse tunisienne
   2/ Les Cours de ces différentes sociétés ( à temps réel bien sûr :) )
   3/ Le récapitulatif du marché.

 Vous trouverez cette API en librairie .jar que vous pouvez inclure dans votre projet. A travers ce tutoriel je vous montrerai comment utiliser BourseTunisAPI ainsi que les données pouvant être extraites.


LIEN de téléchargement de l'API : http://www.4shared.com/rar/F8CR0BD-/BourseTunisApi.html


1/ Créer un nouveau projet JAVA sous Eclipse :




2/Ajouter l'API à la javaBuildPath de votre Projet :

   Si vous avez téléchargé le fichier .rar que j'ai mentionné auparavant ( lien : http://www.4shared.com/rar/F8CR0BD-/BourseTunisApi.html ) , extrayons le dans un emplacement bien précis, par exemple sous le bureau.



Donc, maintenant faite un clic droit sur votre projet , puis choisissez BUILD PATH > ADD EXTERNAL ARCHIVES et choisissez le fichier TunisBourseApi.jar  que vous trouverez sous le dossier que vous avez déjà extrait ( dans votre bureau ).




3/ Utilisez l'API pour extraire les données :
Créons maintenant une classe de test pour tester l'extraction des données.
Donc sous le dossier src de votre projet : cliquez avec le bouton droit puis NEW > CLASS et nommez la TestBourseDeTunis puis appuyez sur Finish.


3.1/ Extraire les informations des entreprises :

Dans le dossier que vous avez extrait auparavant , vous trouverez un fichier nommé listedcompany.pdf où sont listées toutes les sociétés cotées dans la bourse Tunisienne ainsi que leurs code ISIN respectifs ( c'est le code qu'on va utiliser comme paramètre pour récupérer les données d'une société bien précise) . On va choisir par exemple  la Banque de Tunisie ( Code ISIN : TN0002200053).


donc dans le fichier TestBourseDeTunis écrivez :


Et exécuter le fichier avec RUN AS > JAVA APPLICATION
Ainsi vous obtenez dans la console le résultat suivant : BT ( c'est l'acronym de la banque de Tunisie , c'est bête non :) )
Maintenant on a toute une instance qui récapitule toutes les informations à propos de la BT, rappelons que la classe Societe a les attributs suivants :

Voici un exemple complet que vous pouvez recopier : 

package tn.TunisBourseApi.GetSociete;

import tn.TunisBourseApi.Entity.Societe;

public class ExempleSociete {
public static void main(String[] args) {
//EXEMPLE
//EXTRACTION DE LA SOCIETE BT " AMEN BANK " DONT LE CODE ISIN EST : "TN0002200053"
Societe s=GetSociete.execute("TN0002200053");
System.out.println(s.getAcronym());//Acronym
System.out.println(s.getCodeIsin());//Code Ison
System.out.println(s.getDateCreation());//Date Creation
System.out.println(s.getDenominationSociale());//Denomination Scociale
System.out.println(s.getEmail());//Email
System.out.println(s.getFax());//Fax
System.out.println(s.getFormeJuridique());//Forme Juridique
System.out.println(s.getNumtel());// Numéro Tel
System.out.println(s.getRegistreCommerce());//Registre Commerce
System.out.println(s.getSiegeSocial());//Siege Social
System.out.println(s.getStockguide());//Stock Guide
}
}



 et vous aurez comme résultat :


3.1/ Extraire les valeurs des cours des entreprises cotées à temps réel :

De même , on a la classe CoursIntraDay ( récapitulant les valeurs d'une action bien donnée dans la bourse Tunisienne )   définit de cette façon :


Et on procède de la même façon : 




3.1/ Extraire le récapitulatif du marché :

La classe RecapMarche donne des informations sur le nombre de sociétés cotées et non cotées, celles qui ont connu une baisse / Hausse pour leurs valeurs , les quantités et les capitaux globaux échangés.


De même : 







Je vous remercie pour votre lecture et j’espère que cette API facilitera la tâche des développeurs . Si vous avez des remarques et des problèmes à utiliser TunisBourseApi , veuillez le mentionner et je vous répondrai dés que possible.



6 commentaires: