/API Reference● v1.0.0DashboardObtenir une clé
API
Reference
Accédez aux données de marchés Somust via notre API RESTful. Réponses JSON, authentification par clé, latence minimale.
✓ Clé API sécurisée{ } JSON natifϟ Faible latence
BASE URL
https://api.somust.com⌕
Authentification
Clé API requise pour chaque requêteToutes les requêtes doivent inclure votre clé API via l'en-tête Authorization. Obtenez votre clé depuis Paramètres → Clés API dans le dashboard.
▣ Format d'autorisation
JSON / HTTP
Authorization: Bearer sk_live_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789
⚠ SécuritéNe partagez jamais votre clé API. Ne l'exposez pas dans le code côté client. Utilisez toujours un serveur proxy.
GET
Liste des marchés disponibles/api/v1/marketsRetourne les marchés supportés avec symbole, nom, statut, type, prix et variation 24h.
☷ Paramètres
| Nom / Code | Type | Requis | Description |
|---|---|---|---|
| type | string | Non | crypto · forex · stocks |
| status | string | Non | active · inactive |
⌘ Réponse 200 OK
JSON / HTTP
{
"success": true,
"data": [{ "symbol": "BTC/USDT", "price": 67234.50, "change_24h": 2.34 }],
"total": 156
}▸ Exemples
JSON / HTTP
curl -X GET "https://api.somust.com/api/v1/markets?type=crypto" \\ -H "Authorization: Bearer sk_live_..."
GET
Résumé du marché en temps réel/api/v1/briefRésumé condensé : tendances, volumes, signaux et indicateurs clés pour les symboles demandés.
☷ Paramètres
| Nom / Code | Type | Requis | Description |
|---|---|---|---|
| symbols | string[] | Oui | Symboles séparés par virgules |
| limit | integer | Non | 1–100, défaut 10 |
| interval | string | Non | 5m · 15m · 1h · 4h · 1d |
⌘ Réponse 200 OK
JSON / HTTP
{
"success": true,
"data": { "interval": "1h", "markets": [{ "symbol": "BTC/USDT", "trend": "bullish", "confidence": 0.82 }] }
}▸ Exemples
JSON / HTTP
curl -X GET "https://api.somust.com/api/v1/brief?symbols=BTC/USDT,ETH/USDT" \\ -H "Authorization: Bearer sk_live_..."
GET
Alertes actives de votre compte/api/v1/alertsRécupère les alertes configurées : seuils de prix et signaux personnalisés.
☷ Paramètres
| Nom / Code | Type | Requis | Description |
|---|---|---|---|
| status | string | Non | active · triggered · expired |
| symbol | string | Non | Filtrer par symbole |
⌘ Réponse 200 OK
JSON / HTTP
{
"success": true,
"data": [{ "id": "alert_9f8e7d6c5b4a", "status": "active", "triggered_at": null }],
"total": 3
}▸ Exemples
JSON / HTTP
curl -X GET "https://api.somust.com/api/v1/alerts?status=active" \\ -H "Authorization: Bearer sk_live_..."
◴
Limites de requêtes
Taux limités par plan| Nom / Code | Type | Requis | Description |
|---|---|---|---|
| Free | 10 | 1 000 | /markets uniquement |
| Pro | 60 | 50 000 | Tous les endpoints |
| Enterprise | ∞ | ∞ | Tous + Webhooks |
ⓘ En-têtes inclus : X-RateLimit-Remaining · X-RateLimit-Reset
!
Codes d'erreur
Codes HTTP et formats de réponseL'API utilise les codes HTTP standards. Chaque erreur inclut un objet JSON descriptif.
| Nom / Code | Type | Requis | Description |
|---|---|---|---|
| 401 | Unauthorized | Clé API invalide, manquante ou révoquée | |
| 403 | Forbidden | Plan insuffisant pour cet endpoint | |
| 429 | Too Many Requests | Limite dépassée | |
| 400 | Bad Request | Paramètres invalides ou manquants | |
| 404 | Not Found | Endpoint ou ressource introuvable | |
| 500 | Internal Error | Erreur serveur |
JSON / HTTP
{
"success": false,
"error": { "code": 401, "type": "unauthorized", "message": "Invalid API key provided." }
}