POST /apiv2/reports/statement

स्टेटमेंट फ़ाइल का ऑर्डर दें — किसी समयावधि में एक टोकन का प्रत्येक ऑपरेशन, CSV या PDF के रूप में। फ़ाइल बैकग्राउंड में बनाई जाती है: अनुरोध तुरंत एक ऑर्डर नंबर लौटाता है, और फ़ाइल तैयार होने के बाद उसे प्राप्त किया जाता है।

बिना प्रतीक्षा किए उसी डेटा को तुरंत देखने के लिए, इसके बजाय स्टेटमेंट पूर्वावलोकन का उपयोग करें — यह तुरंत उत्तर देता है लेकिन लौटाए जाने वाले ऑपरेशनों की संख्या को सीमित करता है।

एंडपॉइंट बेस URL

https://netts.io/apiv2/reports

अनुरोध हेडर

Header	Required	Description
X-API-KEY	हाँ	डैशबोर्ड से प्राप्त API कुंजी
X-Real-IP	हाँ	कुंजी श्वेतसूची (whitelist) से एक पता
X-Idempotency-Key	नहीं	आपकी अपनी कुंजी, A-Z a-z 0-9 . _ : - के 12–128 वर्ण

एक फ़ाइल ऑर्डर करें

curl -s -X POST 'https://netts.io/apiv2/reports/statement' \
  -H 'X-API-KEY: your-api-key' \
  -H 'X-Real-IP: 203.0.113.10' \
  -H 'Content-Type: application/json' \
  -d '{
        "client_request_id": "stmt-2026-09-usdt",
        "address": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "token_id": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
        "date_from": "2026-09-01",
        "date_to": "2026-09-30",
        "format": "csv"
      }'

{
  "status": "success",
  "code": 0,
  "msg": "created",
  "data": {
    "order_no": "REPxxxxxxxxxxxx",
    "client_request_id": "stmt-2026-09-usdt",
    "type": "statement",
    "status": "queued",
    "quota_bucket": "free",
    "progress_pct": 0,
    "address": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "token_id": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
    "date_from": "2026-09-01",
    "date_to": "2026-09-30",
    "format": "csv",
    "created_at": "2026-09-06 17:01:51.868542+00:00",
    "finished_at": null,
    "expires_at": null,
    "artifact_sha256": null,
    "artifact_size": null,
    "download_url": null
  }
}

Field	Required	Notes
client_request_id	हाँ	आपका पहचानकर्ता। प्रति खाता अद्वितीय
address	हाँ	TRON base58, 34 वर्ण
token_id	नहीं	डिफ़ॉल्ट रूप से TRX; एक TRC20 अनुबंध या एक TRC10 id
date_from, date_to	हाँ	UTC, सम्मिलित। अधिकतम 366 दिन
format	नहीं	डिफ़ॉल्ट रूप से csv। PDF 5000 ऑपरेशनों तक सीमित है

फिर इसके लिए प्रतीक्षा करें

curl -s 'https://netts.io/apiv2/reports/REPxxxxxxxxxxxx' \
  -H 'X-API-KEY: your-api-key' -H 'X-Real-IP: 203.0.113.10'

status फ़ील्ड इन चरणों से गुजरता है: queued → running → waiting_cypherarc → done। दो अन्य अंतिम स्थितियाँ हैं: error, जिसका कारण error_code और error_message में होता है, और expired जब फ़ाइल की समय सीमा समाप्त हो जाती है। एक छोटा स्टेटमेंट आमतौर पर एक मिनट से भी कम समय में तैयार हो जाता है; done के अलावा किसी भी स्थिति को "प्रतीक्षा जारी रखें" मानें।

एक बार जब यह done हो जाता है, तो download_url भर दिया जाता है — एक पथ के रूप में, पूर्ण URL के रूप में नहीं — और फ़ाइल को प्राप्त किया जा सकता है:

curl -s -OJ 'https://netts.io/apiv2/reports/REPxxxxxxxxxxxx/download' \
  -H 'X-API-KEY: your-api-key' -H 'X-Real-IP: 203.0.113.10'

फ़ाइल gzipped रूप में आती है। एक CSV ऑर्डर application/gzip के रूप में डाउनलोड होता है जिसमें Content-Disposition में एक .csv.gz फ़ाइल नाम होता है; पार्स करने से पहले इसे डीकंप्रेस करें। स्थिति प्रतिक्रिया में ठीक उसी तरह डिलीवर की गई संपीड़ित फ़ाइल के लिए artifact_sha256 और artifact_size शामिल होते हैं, जिससे आप दूसरे अनुरोध के बिना डाउनलोड को सत्यापित कर सकते हैं।

बार-बार पोल करने के बजाय, एक वेबहुक पंजीकृत करें ताकि फ़ाइल तैयार होने पर आपको सूचित किया जा सके।

अनुरोध दोहराना सुरक्षित है

वही client_request_id, या वही X-Idempotency-Key भेजें, और आपको दूसरी फ़ाइल बनने के बजाय मौजूदा ऑर्डर वापस मिल जाएगा। प्रतिक्रिया में "msg": "existing" शामिल होता है ताकि आप दोनों में अंतर कर सकें।

अलग बॉडी के साथ किसी पहचानकर्ता का पुन: उपयोग करना एक त्रुटि है, नया ऑर्डर नहीं: यह 409 देता है। पहचानकर्ता केवल आपके खाते के भीतर ही अद्वितीय होते हैं — किसी अन्य खाते के पहचानकर्ता कभी भी आपके पहचानकर्ताओं से नहीं टकराते।

फ़ाइलें 30 दिनों तक रहती हैं

उसके बाद ऑर्डर expired हो जाता है और डाउनलोड करने पर 410 मिलता है। यदि आपको बाद में इसकी आवश्यकता हो तो इसे फिर से ऑर्डर करें।

दर सीमाएं

10 अनुरोध प्रति सेकंड प्रति एंडपॉइंट, सभी क्लाइंट्स में साझा। इससे अधिक होने पर Retry-After: 1 और संदेश Endpoint rate limit exceeded (10 req/s shared) के साथ 429 मिलता है।

यही एकमात्र सीमा है। कोई मासिक कोटा नहीं है, आप कितनी फ़ाइलें ऑर्डर कर सकते हैं इसकी कोई सीमा नहीं है, और एक बार में कितनी फ़ाइलें बन सकती हैं इसकी कोई सीमा नहीं है — सकारात्मक शेष राशि वाला खाता उतना ऑर्डर कर सकता है जितना कि दर सीमा अनुमति देती है। बिल्ड कतार द्वारा ली जा सकने वाली सीमा से परे के ऑर्डर अस्वीकार किए जाने के बजाय रोक कर रखे जाते हैं और स्वचालित रूप से पुन: प्रयास किए जाते हैं, इसलिए अचानक अधिक ट्रैफ़िक आने पर आपको विफलता नहीं, बल्कि केवल विलंबता का सामना करना पड़ता है।

त्रुटि प्रतिक्रियाएं

HTTP	Meaning
400	पता 34 वर्णों का है लेकिन इसका base58 चेकसम विफल रहता है
401	कुंजी गायब या अमान्य है, या स्रोत IP श्वेतसूची में नहीं है
402	खाता शेष 4 TRX न्यूनतम से कम है
403	API कुंजी अवरुद्ध है; सहायता से संपर्क करें
409	उसी पहचानकर्ता का उपयोग एक अलग बॉडी के साथ किया गया था — बॉडी IDEMPOTENCY_CONFLICT है
410	फ़ाइल की समय सीमा समाप्त हो गई है
422	कोई फ़ील्ड गायब या विकृत है, या अवधि 366 दिनों से अधिक है
429	दर सीमा पार हो गई — Retry-After के बाद पुन: प्रयास करें

संबंधित

• शेष राशि — शेष राशि पढ़ना और त्वरित स्टेटमेंट पूर्वावलोकन
• रिपोर्ट वेबहुक — फ़ाइल तैयार होने पर सूचना