Référence de l’API
Documentation de l’API
Une API JSON en lecture seule sur les mêmes données de marché que celles affichées par ce site. Les réponses réussies utilisent l’enveloppe { data, meta } ; les échecs utilisent { error: { code, message } }.
- URL de base
- http://localhost:3000
- Méthodes
- GET uniquement
- Format
- JSON, UTF-8
- Limite de requêtes
- 60 requêtes par 60 secondes, par adresse IP et par point de terminaison
These are API examples. This site is served as static files.
MARKET_DATA_PROVIDER=fmp avec FMP_API_KEY. Le champ meta.provider de chaque réponse indique quelle source a répondu.Lister les cotations
/api/quotesRenvoie une page d’instruments sous forme de tableau plat, avec total, page et pageSize dans meta. Tous les filtres du screener ci-dessous fonctionnent aussi ici ; les valeurs qui ne peuvent pas être analysées sont ignorées.
Paramètres
| Paramètre | Dans | Type | Obligatoire | Description |
|---|---|---|---|---|
| sector | query | string | Facultatif | Nom exact du secteur : Technology, Healthcare, Financials, Consumer Discretionary, Consumer Staples, Industrials, Energy, Materials, Utilities, Real Estate. |
| sort | query | string | Facultatif | Champ de tri : marketCap (par défaut), price, changePercent, volume ou symbol. |
| order | query | string | Facultatif | Ordre de tri : desc (par défaut) ou asc. |
| page | query | number | Facultatif | Numéro de page, à partir de 1. |
| pageSize | query | number | Facultatif | Lignes par page : 20 par défaut, 100 au maximum. |
Requête
curl -s "http://localhost:3000/api/quotes?pageSize=3"Exemple de réponse
200application/json
{
"data": [
{
"symbol": "NWRB",
"name": "Northwind Robotics",
"exchange": "NASDAQ",
"sector": "Technology",
"industry": "Industrial Automation",
"price": 733.8,
"change": -16.52,
"changePercent": -2.2,
"previousClose": 750.32,
"open": 750.03,
"dayHigh": 751.29,
"dayLow": 731.5,
"volume": 3471317,
"avgVolume": 2962633,
"marketCap": 982258754565,
"peRatio": 60.35,
"eps": 12.16,
"dividendYield": null,
"week52High": 963.99,
"week52Low": 583.89,
"afterHoursPrice": 731,
"afterHoursChangePercent": -0.38,
"updatedAt": "2026-11-12T21:00:00.000Z"
}
],
"meta": {
"provider": "demo",
"generatedAt": "2026-11-12T21:00:04.512Z",
"disclaimer": "Demo dataset: fictional issuers and simulated prices. Not investment advice.",
"total": 20,
"page": 1,
"pageSize": 3
}
}L’exemple est réduit à une ligne.
Obtenir une cotation
/api/quotes/{symbol}Renvoie la cotation complète d’un instrument ou d’un indice. Un symbole inconnu renvoie 404 not_found.
Paramètres
| Paramètre | Dans | Type | Obligatoire | Description |
|---|---|---|---|---|
| symbol | path | string | Obligatoire | Symbole d’instrument ou d’indice, par exemple NWRB. La correspondance ignore la casse. |
Requête
curl -s "http://localhost:3000/api/quotes/NWRB"Exemple de réponse
200application/json
{
"data": {
"symbol": "NWRB",
"name": "Northwind Robotics",
"exchange": "NASDAQ",
"sector": "Technology",
"industry": "Industrial Automation",
"price": 733.8,
"change": -16.52,
"changePercent": -2.2,
"previousClose": 750.32,
"open": 750.03,
"dayHigh": 751.29,
"dayLow": 731.5,
"volume": 3471317,
"avgVolume": 2962633,
"marketCap": 982258754565,
"peRatio": 60.35,
"eps": 12.16,
"dividendYield": null,
"week52High": 963.99,
"week52Low": 583.89,
"afterHoursPrice": 731,
"afterHoursChangePercent": -0.38,
"updatedAt": "2026-11-12T21:00:00.000Z"
},
"meta": {
"provider": "demo",
"generatedAt": "2026-11-12T21:00:04.512Z",
"disclaimer": "Demo dataset: fictional issuers and simulated prices. Not investment advice."
}
}Obtenir des chandeliers
/api/candles/{symbol}Renvoie des chandeliers OHLCV, du plus ancien au plus récent. La plage 1D utilise des intervalles de 30-minute ; toutes les autres plages utilisent des chandeliers journaliers. Une plage inconnue renvoie 400 bad_request.
Paramètres
| Paramètre | Dans | Type | Obligatoire | Description |
|---|---|---|---|---|
| symbol | path | string | Obligatoire | Symbole d’instrument ou d’indice, par exemple NWRB. La correspondance ignore la casse. |
| range | query | string | Facultatif | L’une des valeurs 1D, 5D, 1M, 6M, 1Y, 5Y. Par défaut : 1M. |
Requête
curl -s "http://localhost:3000/api/candles/NWRB?range=1M"Exemple de réponse
200application/json
{
"data": [
{
"time": "2026-11-11",
"open": 757.4,
"high": 761.18,
"low": 743.92,
"close": 750.32,
"volume": 3531710
},
{
"time": "2026-11-12",
"open": 750.03,
"high": 751.29,
"low": 731.5,
"close": 733.8,
"volume": 3471317
}
],
"meta": {
"provider": "demo",
"generatedAt": "2026-11-12T21:00:04.512Z",
"disclaimer": "Demo dataset: fictional issuers and simulated prices. Not investment advice.",
"symbol": "NWRB",
"range": "1M"
}
}L’exemple est réduit à deux chandeliers ; 1M en renvoie 22.
Filtrer les instruments
/api/screenerFiltre, trie et pagine les instruments avec les mêmes paramètres que la page screener. Le résultat contient rows avec total, page et pageSize ; les valeurs qui ne peuvent pas être analysées sont ignorées.
Paramètres
| Paramètre | Dans | Type | Obligatoire | Description |
|---|---|---|---|---|
| sector | query | string | Facultatif | Nom exact du secteur : Technology, Healthcare, Financials, Consumer Discretionary, Consumer Staples, Industrials, Energy, Materials, Utilities, Real Estate. |
| minMarketCap, maxMarketCap | query | number | Facultatif | Bornes de capitalisation boursière en USD. |
| minPrice, maxPrice | query | number | Facultatif | Bornes de prix en USD. |
| minChangePercent, maxChangePercent | query | number | Facultatif | Bornes de variation journalière en points de pourcentage : -3 signifie -3 %. |
| minVolume | query | number | Facultatif | Volume journalier minimal en titres. |
| profitableOnly | query | string | Facultatif | Définir sur 1 pour ne conserver que les instruments dont l’EPS est supérieur à 0. |
| sort | query | string | Facultatif | Champ de tri : marketCap (par défaut), price, changePercent, volume ou symbol. |
| order | query | string | Facultatif | Ordre de tri : desc (par défaut) ou asc. |
| page | query | number | Facultatif | Numéro de page, à partir de 1. |
| pageSize | query | number | Facultatif | Lignes par page : 20 par défaut, 100 au maximum. |
Requête
curl -s "http://localhost:3000/api/screener?profitableOnly=1&pageSize=5"Exemple de réponse
200application/json
{
"data": {
"rows": [
{
"symbol": "NWRB",
"name": "Northwind Robotics",
"exchange": "NASDAQ",
"sector": "Technology",
"industry": "Industrial Automation",
"price": 733.8,
"change": -16.52,
"changePercent": -2.2,
"previousClose": 750.32,
"open": 750.03,
"dayHigh": 751.29,
"dayLow": 731.5,
"volume": 3471317,
"avgVolume": 2962633,
"marketCap": 982258754565,
"peRatio": 60.35,
"eps": 12.16,
"dividendYield": null,
"week52High": 963.99,
"week52Low": 583.89,
"afterHoursPrice": 731,
"afterHoursChangePercent": -0.38,
"updatedAt": "2026-11-12T21:00:00.000Z"
}
],
"total": 17,
"page": 1,
"pageSize": 5
},
"meta": {
"provider": "demo",
"generatedAt": "2026-11-12T21:00:04.512Z",
"disclaimer": "Demo dataset: fictional issuers and simulated prices. Not investment advice.",
"total": 17,
"page": 1,
"pageSize": 5
}
}L’exemple est réduit à une ligne.
Authentification
Le mode démo ne nécessite aucune clé. Lorsque le serveur définit la variable d’environnement API_KEY, chaque requête doit envoyer la même valeur dans l’en-tête X-API-Key ; toute autre valeur reçoit 401 unauthorized.
curl -s "http://localhost:3000/api/quotes/NWRB" \
-H "X-API-Key: your-key-here"Codes d’erreur
Les requêtes en échec renvoient un statut HTTP correspondant et un seul objet d’erreur. Branchez-vous sur code ; le message est rédigé pour les humains et peut changer.
{
"error": {
"code": "not_found",
"message": "A human-readable explanation."
}
}| Statut HTTP | Code | Quand cela se produit |
|---|---|---|
| 400 | bad_request | Une valeur de paramètre n’est pas autorisée, par exemple une plage de chandeliers inconnue. |
| 401 | unauthorized | API_KEY est configurée et la requête n’a pas d’en-tête X-API-Key correspondant. |
| 404 | not_found | Le symbole n’existe pas dans le jeu de données. |
| 405 | method_not_allowed | L’API est en lecture seule : /api/quotes répond à POST avec ce code. |
| 429 | rate_limited | Plus de 60 requêtes en 60 secondes depuis une adresse IP vers un point de terminaison. La réponse inclut Retry-After en secondes. |
Retrouvez les mêmes données dans le produit
L’aperçu du marché, les pages de cotation et le screener lisent le même fournisseur que ces points de terminaison.