Anomalie API — API Publique

Démarrage rapide

Tester en 30 secondes

# Vérifier que l'API est en ligne
curl https://api.anomalie.eu/public/status

# Obtenir tous les cours boursiers
curl https://api.anomalie.eu/public/cours

# Obtenir le portfolio d'un joueur
curl https://api.anomalie.eu/public/portfolio/ABC123XYCopier

Structure d'une réponse

// Succès
{
  "success": true,
  "cours": [ ... ],
  "_meta": {
    "timestamp": "2024-01-15T14:30:00.000Z",
    "documentation": "/wiki"
  }
}

// Erreur
{
  "error": "Description de l'erreur",
  "code": "ERROR_CODE"
}Copier

Prix Items

{
  "success": true,
  "count": 42,
  "prices": {
    "bread":             { "price": 12.50,  "updatedAt": "2024-01-15T14:25:00.000Z" },
    "iron_ore":          { "price": 87.30,  "updatedAt": "2024-01-15T14:25:00.000Z" },
    "electronic_parts":  { "price": 234.80, "updatedAt": "2024-01-15T14:25:00.000Z" }
  },
  "_meta": { ... }
}Copier

{
  "success": true,
  "item": "iron_ore",
  "price": 87.30,
  "variation24h": "-2.45",
  "_meta": { ... }
}Copier

Bourse

{
  "success": true,
  "count": 8,
  "cours": [
    {
      "id": 1,
      "ticker": "MAZE",
      "name": "Maze Bank Corp",
      "currentPrice": 1250.00,
      "openPrice": 1200.00,
      "highPrice": 1280.00,
      "lowPrice": 1190.00,
      "totalShares": 10000,
      "isListed": true,
      "suspensionUntil": null,
      "rating": "AA",
      "volume24h": 342,
      "priceYesterday": 1180.00,
      "variation24h": 5.93
    }
  ],
  "_meta": { ... }
}Copier

{ "success": true, "company": { /* même structure que /cours */ }, "_meta": { ... } }Copier

{
  "success": true,
  "ticker": "MAZE",
  "period": "24h",
  "history": [
    { "time": "2024-01-15T12:00:00.000Z", "open": 1200, "high": 1250, "low": 1190, "close": 1230, "volume": 45 }
  ],
  "_meta": { ... }
}Copier

Portfolio Joueur

{
  "success": true,
  "portfolio": {
    "summary": {
      "totalCurrentValue": 15750.00,
      "totalInvested":     12000.00,
      "totalPnl":           3750.00,
      "totalPnlPercent":      31.25
    },
    "positions": [
      {
        "ticker":       "MAZE",
        "name":         "Maze Bank Corp",
        "sharesHeld":   10,
        "avgBuyPrice":  1200.00,
        "currentPrice": 1250.00,
        "currentValue": 12500.00,
        "pnl":           500.00,
        "pnlPercent":      4.17,
        "rating":       "AA"
      }
    ],
    "dividendsHistory": [
      {
        "paid_at":         "2024-01-10T09:00:00.000Z",
        "ticker":          "MAZE",
        "shares_at_time":  10,
        "amount_per_share": 50.00,
        "amount_received":  500.00
      }
    ]
  },
  "_meta": { ... }
}Copier

Fonds ETF

{
  "success": true,
  "count": 3,
  "funds": [
    {
      "id": 1,
      "name":             "Fonds LS Diversifié",
      "description":      "Portefeuille équilibré des grandes entreprises",
      "managerCitizenId": "ABC123XY",
      "shareValue":       850.00,
      "totalShares":      500,
      "commissionRate":   0.02,
      "isActive":         true,
      "holdings": [
        { "ticker": "MAZE", "weight": 0.60 },
        { "ticker": "RON",  "weight": 0.40 }
      ]
    }
  ],
  "_meta": { ... }
}Copier

Statut du Serveur

{
  "success":  true,
  "status":   "online",
  "uptime":   86400,
  "version":  "1.0.0",
  "endpoints": {
    "prices": "/public/prices",
    "cours":  "/public/cours",
    "etf":    "/public/etf",
    "wiki":   "/wiki"
  },
  "rateLimit": {
    "withoutKey": "60 req/min",
    "withKey":    "Voir header X-RateLimit-Limit"
  },
  "_meta": { ... }
}Copier

FAQ & Limites