Historiques SCPI

Le lien entre un historique et son fonds part est effectué par le biais de l'idFund
Cette ressource permet de récupérer et maintenir à jours les données caractéristiques historisées des SCPI.

NOTE : Afin de limiter le nombre de résultats potentiels, il est necessaire de spécifier au moins l'un des paramêtres suivants pour effectuer ne requete sur cette ressource: latestOnly,funds, isins, from, to, upFromDate, upToDate

Lister les historiques

Requêtes de base:

Récupérer le dernier historique de tous les fonds:
Tester
https://services.opcvm360.com/api-v1/scpi-history?latestOnly=1
Récupérer l'historique du fonds par l'identifiant du fonds idFund 22954 :
Tester
https://services.opcvm360.com/api-v1/scpi-history?funds=22954
Récupérer l'historique du fonds par son code isin:
Tester
https://services.opcvm360.com/api-v1/scpi-history?isins=SCPI00000859

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 du fonds idFund 22954 depuis le 12/06/2018 au 18/12/2018:
Tester
https://services.opcvm360.com/api-v1/scpi-history?funds=22954&from=2018-06-12&to=2018-12-18

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 que nous complétions ou corrigions ces historiques. 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=2018-11-22 pour donner la date de votre dernière requête de ce type.

Optionnellement avec ce paramêtre :
  • upToDate=2018-11-23 pour préciser une date de fin

Exemple d'utilisation:

Récupérer les historiques de tous les fonds mis à jour depuis le 22/11/2018
Tester
https://services.opcvm360.com/api-v1/scpi-history?upFromDate=2018-11-22
Récupérer les historiques des fonds 22954 mis à jour depuis le 22/11/2018
Tester
https://services.opcvm360.com/api-v1/scpi-history?funds=22954&upFromDate=2018-11-22

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


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
idFund Identifiant interne du fonds. Int
name Nom du fonds. String
date Date Date => YYYY-MM-DD
nbPartners Nombre d'associés Int
avgPurchasePrice Prix moyen d'achat Float
dividend Dividende versé Float
tdvm TDVM (Taux de Dividende à la Valeur de Marché) Float
nbBuildings Nombre d'immeubles Int
overallArea Surface globale Int
nbTenants Nombre de locataires Int
tof TOF (Taux d'occupation financier) Float
toi TOI (Taux d'occupation immobilier) Float
tr Taux de recouvrement Float
yearGrossCollect Collecte brute sur l'année Float
yearNetCollect Collecte nette sur l'année Float
nbShareSubscription Nombre de parts souscrites Float
nbShareWithdrawn Nombre de parts retirées Float
realizationValue Valeur de réalisation (par part) Float
reconstitutionValue Valeur de reconstitution (par part) Float
tri TRI (Taux de Rendement Interne 10 ans) Float
ran Report à nouveau (RAN par part) Float