İkincil Grup Arama
Tüm token'larda ikincil piyasa gruplarını arayın.
Endpoint
POST /v2/users/secondary-markets/group-search
Headers
| Header | Değer |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer {token} |
İstek Gövdesi
{
"page": 1,
"per_page": 10,
"filters": {
"token_id": "string",
"min_price": "number",
"max_price": "number",
"price_symbol": "string",
"min_quantity": "number",
"max_quantity": "number",
"seller_id": "string",
"status": "string"
}
}
Parametreler
| Parametre | Tip | Gerekli | Açıklama |
|---|---|---|---|
| page | integer | Evet | Sayfalama için sayfa numarası |
| per_page | integer | Evet | Sayfa başına öğe sayısı |
| filters | object | Hayır | Arama için isteğe bağlı filtreler |
| filters.token_id | string | Hayır | Belirli token ID'ye göre filtrele |
| filters.min_price | number | Hayır | Minimum fiyat filtresi |
| filters.max_price | number | Hayır | Maksimum fiyat filtresi |
| filters.price_symbol | string | Hayır | Fiyat para birimi sembolü (örn. "USDT") |
| filters.min_quantity | number | Hayır | Minimum miktar filtresi |
| filters.max_quantity | number | Hayır | Maksimum miktar filtresi |
| filters.seller_id | string | Hayır | Satıcı ID'ye göre filtrele |
| filters.status | string | Hayır | Anlaşma durumuna göre filtrele |
Yanıt
Arama kriterlerine uyan ikincil piyasa gruplarının sayfalı listesini döndürür.
Hata Yanıtları
400 Bad Request
{
"error": "Geçersiz istek parametreleri",
"details": "Geçersiz filtre değerleri"
}
401 Unauthorized
{
"error": "Kimlik doğrulaması gerekli"
}
403 Forbidden
{
"error": "Erişim reddedildi"
}
500 Internal Server Error
{
"error": "İç sunucu hatası"
}