Ressource: fundshares-history

Cette ressource permet de récupérer et maintenir à jours les historiques de vos parts (VL et encours).
Le lien entre un historique et sa part est effectué par le biais de l'idFundShare

Lister les historiques

Requêtes de base:

Récupérer la liste complète des historiques:
Tester
http://services.opcvm360.com/api-v1/fundshares-history
Par défaut la requête retourne une liste paginé de 25 parts par page.
Récupérer l'historique de la part idFundShare 1 :
Tester
http://services.opcvm360.com/api-v1/fundshares-history?fundshares=1

Vous pouvez aussi avoir besoin de récupérer des historiques 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 d'historique.

Récupérer l'historique de la part idFundShare 1 depuis le 24/06/2011 au 24-06-2012:
Tester
http://services.opcvm360.com/api-v1/fundshares-history?fundshares=1&from=2011-06-24&to=2012-06-24

NOTE : Par défaut un maximum de 500 valeurs 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.


Maintenez vos historiques à jour

Il arrive régulièrement que nous complétions ou corrigions les historiques de VL. Il peut donc devenir compliqué et coûteux en ressources de maintenir vos historiques à jour. Afin de simplifier ce maintient nous vous conseillons d'utiliser la méthode suivante.

Récupérer uniquement les données mises à jours

Cette solution consiste à demander à l'API de retourner uniquement les valeurs qui ont été ajoutées ou modifiées dans notre base de données depuis votre dernière requête du même type. Vous êtes donc sûr de ne rater aucune mise à jour sans pour autant reparcourir la liste complète des historiques. Pour cela utilisez le paramètre upFromDate=2013-11-22 pour donner la date de votre dernière requête de ce type.

Optionnellement avec ce paramêtre :
  • upFromTime=10:05:00 pour préciser l'heure de début
  • upToDate=2013-11-23 pour préciser une date de fin
  • upToTime=10:05:00 pour préciser l'heure de fin

Exemple d'utilisation:

Récupérer les historiques de toutes les parts mis à jour depuis le 22/11/2013 à 10:05:00
Tester
http://services.opcvm360.com/api-v1/fundshares-history?upFromDate=2013-11-22&upFromTime=10:05:00
Récupérer les historiques des parts 1 et 2 mis à jour depuis le 22/11/2013 à 10:05:00
Tester
http://services.opcvm360.com/api-v1/fundshares-history?fundshares=1,2&upFromDate=2013-11-22&upFromTime=10:05:00
Utiliser les paramêtres de pagination :
Tester
http://services.opcvm360.com/api-v1/fundshares-history?fundshares=1,2&from=2011-06-24&to=2012-06-24&limit=3500&offset=3500
On retourne les historiques des parts 1 et 2 entre le 24/06/2011 et le 24/06/2012 avec maximum 3500 lignes et à partir de la ligne 3500

NOTE : le paramètre upFromDate ne peut être combiné aux paramêtres from et to décris en première partie.


Récupérer les lignes d'historiques supprimées

Il nous arrive dans certains de supprimer des lignes d'historique. Vous pouvez récuprérer ces informations à l'aide des requêtes suivantes.

Exemple d'utilisation:

Récupérer les lignes historiques supprimées depuis le 22/11/2013 à 10:05:00 de toutes les parts
Tester
http://services.opcvm360.com/api-v1/fundshares-history-deleted?upFromDate=2013-11-22&upFromTime=10:05:00
Récupérer les historiques supprimées depuis le 22/11/2013 à 10:05:00 des parts 1 et 2
Tester
http://services.opcvm360.com/api-v1/fundshares-history-deleted?fundshares=1,2&upFromDate=2013-11-22&upFromTime=10:05:00

NOTE 1: Ces 2 requetes renvoient uniquement l'idFundShare et la date des historiques supprimées.
NOTE 2: Les suppressions d'historiques sont sauvegardées pour une durée de 4 mois, au-delà cette information n'est plus accessible.


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
idFundShare Identifiant interne de la part. int
date Date de la valeur liquidative. Date => YYYY-MM-DD
vl Valeur liquidative. Float
shares Nombre de parts. Float
aum Encours de la part. Float
vlVarP Performance quotidienne de la valeur liquidative (VL precedente) Float