Aller au contenu

La fiche d'un instrument à une date

GET
/instruments/{instrument}
curl --request GET \
--url 'https://example.com/instruments/example?date=2026-04-15' \
--header 'Authorization: Bearer <token>'
instrument
required
string
>= 1 characters

L’identifiant publié de l’instrument — stable à vie.

date
required
string format: date

La date de consultation (AAAA-MM-JJ) — toute consommation de donnée datée est datée ; la date vient toujours de l’appelant.

La fiche à la date demandée.

Media typeapplication/json
object
instrument
required

L’identifiant publié.

string
libelle
required
string
nature
required
string
Allowed values: placement_collectif ccb devise
isin

Le code ISIN, s’il existe — celui de la catégorie de parts que l’instrument représente (chaque catégorie de parts est un instrument).

string
unite
required

L’unité dans laquelle toute quantité de cet instrument s’exprime chez les consommateurs — l’unité que la tenue de compte et la passerelle partenaires citent sans jamais la redéfinir.

string
Allowed values: part unite_monetaire
decimales
required

La précision de l’unité : une quantité s’échange en entier à l’échelle 10^-decimales (millionièmes de part : 6).

integer
entreprise_debitrice

L’identifiant publié de la débitrice — CCB seulement.

string
accord_participation

L’identifiant publié de l’accord — CCB seulement.

string
etat
required

L’état du cycle — un terminus reste servi à jamais.

string
Allowed values: en_preparation commercialisable annule absorbe liquide
date
required

La date de consultation servie.

string format: date
structure

La structure du placement collectif — le véhicule qui porte l’instrument, le compartiment le cas échéant, la catégorie de parts que la ligne représente. Absente pour un CCB et une devise. Le véhicule est servi RÉSOLU à la date : régime, profils et rôles sont ce qui s’applique — jamais l’arbre des versions. Les lignes sœurs du même fonds se découvrent par le filtre vehicule de la collection.

object
vehicule

L’enveloppe juridique qui porte le placement collectif et émet les parts — pas un instrument : rien ne s’y détient, il ne publie aucune valeur.

object
vehicule
required
string
>= 1 characters
type
required

Le type du véhicule — un OPC maître n’est jamais tenu, il n’apparaît qu’en cible de la relation maître.

string
Allowed values: fcpe sicavas
nom_legal
string
est_compartimente

Le compartimentage déclaré par la documentation du fonds — vrai, chaque ligne vit sur un compartiment ; faux, aucun compartiment n’existe.

boolean
agrement

La référence de l’agrément, quand il est établi.

string
regime_juridique

Le régime juridique explicite d’un FCPE — liste fermée par le logiciel ; sa mutation (le fonds relais) est un ré-établissement tracé, pas un état.

string
Allowed values: l_214_164 l_214_165 l_214_165_1 reprise_l_3332_16
profils

Les profils opérationnels datés en vigueur — cumulables. Le profil nourricier se DÉDUIT de l’existence d’une relation maître effective, il ne se saisit pas.

Array<string>
Allowed values: solidaire relais garanti a_formule nourricier
etat
string
Allowed values: en_preparation agree ouvert abandonne dissous
intervenants

Les rôles d’intervenants en vigueur à la date, pour le fonds entier.

Array<object>
object
role
required

La nomenclature des rôles structurels — propriété du domaine ; la relation tiers détient l’identité générale des acteurs et consomme ces rôles sans les modifier.

string
Allowed values: societe_de_gestion depositaire valorisateur agent_de_transfert centralisateur teneur_compte_emission commissaire_aux_comptes conseil_de_surveillance
intervenant
required

L’identifiant de l’intervenant chez ce tenant.

string
nom
required
string
du
required
string format: date
au

La borne de fin

string format: date
relation_maitre

La relation maître/nourricier effective à la date — au plus une. Le maître est une référence publiée (jamais tenu au référentiel).

object
maitre
required
object
nom
required
string
isin
string
du
required
string format: date
provenance
object
source
required
string
Allowed values: document saisie flux_de_place
document

La référence du document — obligatoire quand la source est un document.

string
sous_jacents

Les relations sous-jacent d’un FCPE d’actionnariat : le titre visé est une référence publiée — l’exposition PRÉVUE par la documentation, jamais l’inventaire du portefeuille réel.

Array<object>
object
titre
required

La référence publiée du titre (émetteur, identifiants externes).

object
emetteur
required
string
isin
string
role_du_titre
required
string
Allowed values: sous_jacent_principal sous_jacent_de_formule titre_de_reference actif_de_couverture
mode_exposition
required
string
Allowed values: direct indirect garanti a_effet_de_levier
du
required
string format: date
au
string format: date
provenance
required
object
source
required
string
Allowed values: document saisie flux_de_place
document

La référence du document — obligatoire quand la source est un document.

string
orientation_gestion

L’exposition prévue par le règlement d’un FCPE d’actionnariat — seuils ou fourchettes, à la date.

object
part_minimale_pb
integer
part_maximale_pb
integer
provenance
object
source
required
string
Allowed values: document saisie flux_de_place
document

La référence du document — obligatoire quand la source est un document.

string
compartiment

Le compartiment qui porte la ligne, quand le véhicule est compartimenté — la subdivision du patrimoine ; jamais servi pour un véhicule qui ne se déclare pas compartimenté.

object
compartiment
required
string
>= 1 characters
libelle
string
categorie

La catégorie de parts que la ligne représente, quand la documentation du fonds différencie les parts — la subdivision des droits ; absente pour une catégorie de parts unique. Son identité (devise, politique de revenus) est celle de la ligne ; ses frais se lisent aux caractéristiques applicables de l’instrument (frais_du_fonds), jamais ici — une seule source, à date.

object
libelle
required
string
>= 1 characters
devise
string
politique_revenus
string
regle_valorisation

La règle de valorisation RÉSOLUE applicable à l’instrument : la règle vit au niveau qui porte le patrimoine valorisé d’un seul mouvement — le véhicule non compartimenté ou le compartiment — et s’hérite puis se spécialise ; le service publie toujours la règle résolue, jamais l’arbre. Toutes les lignes d’un même patrimoine partagent leurs échéances. Pour un CCB, la périodicité de la valeur administrée reste une caractéristique datée : ce champ est absent.

object
portee
required

Le niveau auquel la règle est déclarée — celui d’où la résolution part.

string
Allowed values: vehicule compartiment instrument
frequence
required
string
Allowed values: quotidienne hebdomadaire mensuelle
ancrage

La règle d’ancrage — chaque jour admissible, chaque vendredi, dernier jour ouvré du mois…

string
heure_limite
required

L’heure limite contractuelle de réception des instructions (HH:MM, 24 h). L’heure limite de service du teneur de compte ne peut lui être postérieure.

string
/^([01][0-9]|2[0-3]):[0-5][0-9]$/
fuseau
required

Le fuseau IANA de l’heure limite — une heure locale sans fuseau n’est pas une donnée.

string
>= 1 characters
convention_report

Ce que devient une échéance qui tombe un jour fermé.

string
delai_publication_jours
integer
delai_reglement_jours
integer
calendriers

Les affectations de calendriers de la règle résolue — la simple présence d’un lien ne détermine jamais un effet, la sémantique est explicite. Le calendrier lui-même se consulte au contrat consultation-des-calendriers.

Array<object>
object
calendrier
required
string
version
required
string
semantique
required
string
Allowed values: ouverture_requise fermeture_exclusive dependance_valorisation calcul_publication calcul_reglement informatif
provenances

D’où vient chaque élément de la règle résolue — résoudre une règle n’efface jamais la trace documentaire acquise sur les caractéristiques absorbées.

Array<object>
object
element
required
string
Allowed values: frequence ancrage heure_limite convention_report delai_publication_jours delai_reglement_jours calendriers
provenance
required
object
source
required
string
Allowed values: document saisie flux_de_place
document

La référence du document — obligatoire quand la source est un document.

string
du
required
string format: date
au
string format: date
caracteristiques
required
Array<object>
object
type
required

La typologie fermée des caractéristiques datées servies à ce niveau. La périodicité de publication ne concerne que le CCB (hors calendriers de place) ; pour un placement collectif, elle est absorbée — avec l’heure limite — par la règle de valorisation.

string
Allowed values: periodicite_de_publication classification frais_du_fonds taux_d_interet mecanisme_plafonnement_rachats modalites_d_ordre
du
required
string format: date
au

La borne de fin

string format: date
provenance
required
object
source
required
string
Allowed values: document saisie flux_de_place
document

La référence du document — obligatoire quand la source est un document.

string
periodicite
string
Allowed values: quotidienne hebdomadaire mensuelle
classification
string
droits_entree_pb
integer
droits_sortie_pb
integer
part_minimale_pb
integer
part_maximale_pb
integer
taux_pb
integer
convention
string
plafonnement

Le mécanisme de plafonnement des rachats (la « gate ») tel que la documentation du fonds le prévoit — sa PRÉSENCE et son paramétrage, jamais sa décision d’activation (elle arrive en restriction de négociabilité). Le carnet d’ordres consomme la version applicable et la fige avec l’ordre.

object
seuil_pb
required

Le seuil de déclenchement

integer
perimetre
required
string
Allowed values: instrument vehicule
regle_de_report

Ce que deviennent les quantités non exécutées.

string
revocable

La documentation admet-elle la révocation d’un reliquat.

boolean
representations_max

Le nombre maximal de représentations d’un reliquat.

integer
duree_max_jours
integer
modalites

Les modalités d’ordre intrinsèques au support — le carnet d’ordres et les opérations les consomment, jamais ne les recalculent.

object
minimum_souscription_ue6

Le minimum de souscription

integer
minimum_rachat_ue6
integer
pas_de_souscription_ue6

Le pas d’arrondi d’une souscription en montant.

integer
decimales_quantite

La précision d’exécution en quantité

integer
restrictions
required

Les restrictions de négociabilité en vigueur à la date — cumulables.

Array<object>
object
type
required
string
Allowed values: ferme_aux_souscriptions ferme_aux_rachats suspendu ferme_aux_nouveaux_versements
du
required
string format: date
au

La borne de levée

string format: date
provenance
object
source
required
string
Allowed values: document saisie flux_de_place
document

La référence du document — obligatoire quand la source est un document.

string
capacites_touchees

Les capacités que la restriction suspend — l’indisponibilité est hors cycle : elle touche des capacités, jamais l’état de l’instrument.

Array<string>
Allowed values: souscription rachat arbitrage_entrant arbitrage_sortant transfert affectation_ccb
heure_effet

L’heure d’effet, quand la restriction prend effet en cours de journée.

string
/^([01][0-9]|2[0-3]):[0-5][0-9]$/
fuseau

Le fuseau IANA de l’heure d’effet.

string
portee
string
Allowed values: instrument vehicule
capacites
required

LA RÉSOLUTION SERVIE : pour chaque capacité, le verdict à la date, dérivé de l’état du cycle, des restrictions en vigueur et de la nature — le consommateur ne dérive jamais l’« ordonnabilité » lui-même. La capacité intrinsèque de l’instrument, jamais l’ouverture contextuelle d’un dispositif (domaine Entreprise) ni l’admissibilité d’une instruction (carnet d’ordres).

Array<object>
object
capacite
required
string
Allowed values: souscription rachat arbitrage_entrant arbitrage_sortant transfert affectation_ccb
admise
required
boolean
motifs

Les motifs du refus, normalisés — vide quand la capacité est admise.

Array<string>
Allowed values: instrument_non_commercialisable souscription_fermee rachat_ferme suspendu ferme_aux_nouveaux_versements nature_inapplicable
Example
{
"nature": "placement_collectif",
"unite": "part",
"etat": "en_preparation",
"structure": {
"vehicule": {
"type": "fcpe",
"regime_juridique": "l_214_164",
"profils": [
"solidaire"
],
"etat": "en_preparation",
"intervenants": [
{
"role": "societe_de_gestion"
}
],
"relation_maitre": {
"provenance": {
"source": "document"
}
},
"sous_jacents": [
{
"role_du_titre": "sous_jacent_principal",
"mode_exposition": "direct",
"provenance": {
"source": "document"
}
}
],
"orientation_gestion": {
"provenance": {
"source": "document"
}
}
}
},
"regle_valorisation": {
"portee": "vehicule",
"frequence": "quotidienne",
"calendriers": [
{
"semantique": "ouverture_requise"
}
],
"provenances": [
{
"element": "frequence",
"provenance": {
"source": "document"
}
}
]
},
"caracteristiques": [
{
"type": "periodicite_de_publication",
"provenance": {
"source": "document"
},
"periodicite": "quotidienne",
"plafonnement": {
"perimetre": "instrument"
}
}
],
"restrictions": [
{
"type": "ferme_aux_souscriptions",
"provenance": {
"source": "document"
},
"capacites_touchees": [
"souscription"
],
"portee": "instrument"
}
],
"capacites": [
{
"capacite": "souscription",
"motifs": [
"instrument_non_commercialisable"
]
}
]
}

La demande est irrecevable (date mal formée, bornes incohérentes…) — le motif nomme le champ.

Media typeapplication/json
object
motif
required

Le motif, qui nomme le champ ou l’identifiant en cause.

string
Examplegenerated
{
"motif": "example"
}

Aucune identité présentée (l’exigence est du contrat, le mécanisme de l’assemblage).

L’identité présentée n’a pas la famille d’accès instruments:consultation.

La ressource est inconnue de ce tenant — rien n’existe à travers la muraille.

Media typeapplication/json
object
motif
required

Le motif, qui nomme le champ ou l’identifiant en cause.

string
Examplegenerated
{
"motif": "example"
}