Ressource: fundshares-ost

Permet de récupérer des OST (opérations sur titres)

Généralités
  • Une OST est associée à une part par l'identifiant interne de la part idFundShare.
  • Une OST est identifiée par un idOst.
  • Le champ idOstType permet de connaitre le type d'OST (division du nominal, changement d'isin, ...), ces constantes sont décrites ci-dessous.
  • Les champs oldValue et newValue sont optionnels et donnent respectivement la valeur précédente et la nouvelle valeur pour les OST concernées.
  • Le champ idFundShare2 est optionnel, il donne l'identifiant interne de la part indirectement liée à l'OST (ex: lors d'une absorption ce champ donne l'identifiant de la part absorbante).

Lister les OST

Requêtes de base:

Récupérer la liste complète des OST:
Tester
http://services.opcvm360.com/api-v1/fundshares-ost
Par défaut la requête retourne une liste paginée de 500 OST par page.
Récupérer les OST de la part idFundShare 1 :
Tester
http://services.opcvm360.com/api-v1/fundshares-ost?fundshares=1

Vous pouvez aussi avoir besoin de récupérer des OST entre deux dates précises. Pour cela vous pouvez utiliser les paramêtres from et to qui permettent respectivement de spécifier une date de début et une date de fin.

Récupérer les OST de la part idFundShare 1 depuis le 24/06/2011 au 24-06-2012:
Tester
http://services.opcvm360.com/api-v1/fundshares-ost?fundshares=1&from=2011-06-24&to=2012-06-24
Récupérer toutes les OST de type "Division du nominal" : idOstType=6 :
Tester
http://services.opcvm360.com/api-v1/fundshares-ost?idOstType=6

NOTE : Par défaut un maximum de 500 OST vous sont retournées.
Utilisez le paramètre limit afin d'augmenter ou diminuer cette limite et le paramêtre offset pour accéder aux pages suivantes.

Constantes

Certaines informations textuelles sont retournées sous forme de constantes, les tableaux ci-dessous vous permettent de faire la liaison entre constante et libellé. Il est donc aisé de redéfinir votre propre wording, de plus les modifications de notre côté n'impactent pas l'API.

Constantes pour le champ: idOstType

Constante Libellé
6 Division du nominal
7 Multiplication du nominal
9 Absorbée par un autre OPCVM
10 A changé de nom
11 A été mise en liquidation/ferm
19 Changement de gestionnaire
36 Changement de la fréquence de valorisation
37 Changement Cut off
38 Changement Depositaire
39 Changement d'isin
40 Scission
41 Fermé aux souscriptions
42 Ouvert aux souscriptions
43 Détachement de dividende
44 En cours de liquidation
45 Suspension de cotation

Constantes pour les champs newValue et oldValue

pour les changements de fréquence de cotation idOstType=36

Constante Libellé
1 Quotidien
10 Continu
2 Hebdomadaire
3 Bihebdomadaire
8 Semi-mensuel
4 Mensuel
9 Bimestriel
5 Trimestriel
6 Semestriel
7 Annuel

Liste des informations disponibles pour la ressource

Déjà client ? Connectez-vous pour n'afficher que les données disponibles avec vos accès.

Nom dans l'API Description Type
idOst Identifiant interne de l'OST. Int
idOstType Type d'OST (constante). Int
idFundShare Identifiant interne de la part concernée. Int
date Date de l'OST. Date => YYYY-MM-DD
oldValue Ancienne valeur. Certaines valeurs peuvent être des constantes (champ optionnel) String
newValue Nouvelle valeur. Certaines valeurs peuvent être des constantes (champ optionnel) String
idFundShare2 Identifiant interne d'une autre part liée à l'OST. Actuellement le champ n'est utilisé que pour donner l'identifiant interne d'une part absorbante des OST de type "Absorbée par un autre OPCVM" (champ optionnel) Int