API এন্ডপয়েন্ট - API ডকুমেন্টেশন

Base URL

উৎপাদন: https://api.usdtlowfee.com

সাধারণ নিয়মাবলী

একক

• sun: 1 TRX = 1,000,000 sun (সকল price fields sun ব্যবহার করে)
• energyValue: energy এর একক (int64 সংখ্যা)
• durationHours: ঘন্টা (int সংখ্যা)

ডেটা প্রকার

• ID fields: int64 সংখ্যা (snowflake ID)
• Price fields: int64 সংখ্যা (*Sun দিয়ে শেষ যেমন: balanceSun, priceSun)
• Time fields: টেক্সট (ISO8601 UTC বিন্যাস যেমন: "2025-01-15T10:30:00Z")
• Boolean fields: true/false

প্রতিক্রিয়া বিন্যাস

• সফলতা: { "data": {...}, "meta": {...} } (meta ঐচ্ছিক)
• ত্রুটি: { "error": { "code": "...", "message": "..." } }

অ্যাকাউন্ট ব্যবস্থাপনা

Wallet ব্যালেন্স এবং ব্যবহারকারীর তথ্য জিজ্ঞাসা করুন

GET /v1/wallet/balance

ব্যালেন্স জিজ্ঞাসা করুন

বর্তমান wallet ব্যালেন্স জিজ্ঞাসা করুন

প্রতিক্রিয়া উদাহরণ:

{
  "data": {
    "balanceSun": 1000000,
    "frozenSun": 0,
    "totalSun": 1000000
  }
}

GET /v1/users/me

ব্যবহারকারীর তথ্য

বর্তমান ব্যবহারকারীর মৌলিক তথ্য জিজ্ঞাসা করুন

প্রতিক্রিয়া উদাহরণ:

{
  "data": {
    "id": 123456,
    "email": "user@example.com",
    "emailVerified": true,
    "createdAt": "2025-01-01T00:00:00Z"
  }
}

Order ব্যবস্থাপনা

Energy order তৈরি এবং জিজ্ঞাসা করুন

POST /v1/energy/orders

Order তৈরি করুন

নির্দিষ্ট address এর জন্য energy ভাড়া order তৈরি করুন (বর্তমানে শুধুমাত্র manual type সমর্থিত)

অনুরোধ প্যারামিটার:

প্যারামিটার	ধরন	প্রয়োজনীয়	বিবরণ
type	string	হ্যাঁ	Order এর প্রকার, বর্তমানে শুধুমাত্র "manual" সমর্থিত
data.tronAddress	string	হ্যাঁ	TRON address যা energy পাবে (৩৪ অক্ষর, T দিয়ে শুরু)
data.energyValue	int64	হ্যাঁ	Energy এর পরিমাণ (সংখ্যা, ন্যূনতম 32000, USDT স্থানান্তরের জন্য 65000 সুপারিশ করা হয়)
data.durationHours	int	হ্যাঁ	ভাড়ার সময়কাল (ঘন্টায়, বৈধ মান: 1, 24, 72, 168, 336, 720)

অনুরোধ উদাহরণ:

{
  "type": "manual",
  "data": {
    "tronAddress": "TYour1Address2Here3...",
    "energyValue": 65000,
    "durationHours": 1
  }
}

প্রতিক্রিয়া উদাহরণ:

{
  "data": {
    "id": 1234567890,
    "userId": 9876543210,
    "tronAddress": "TYour1Address2Here3...",
    "energyValue": 65000,
    "durationHours": 1,
    "priceSun": 3000000,
    "priceTrx": 3.0,
    "orderType": "manual",
    "status": "processing",
    "createdAt": "2025-01-15T10:30:00Z",
    "updatedAt": "2025-01-15T10:30:00Z",
    "statusUpdatedAt": "2025-01-15T10:30:00Z",
    "canTransitionTo": ["completed", "failed"]
  }
}

GET /v1/energy/orders/:id

Order জিজ্ঞাসা করুন

ID ব্যবহার করে order এর বিস্তারিত জিজ্ঞাসা করুন

প্রতিক্রিয়া উদাহরণ:

{
  "data": {
    "id": 1234567890,
    "userId": 9876543210,
    "tronAddress": "TYour1Address2Here3...",
    "energyValue": 65000,
    "durationHours": 1,
    "priceSun": 3000000,
    "priceTrx": 3.0,
    "orderType": "manual",
    "status": "completed",
    "txid": "abc123...",
    "createdAt": "2025-01-15T10:30:00Z",
    "completedAt": "2025-01-15T10:30:05Z",
    "updatedAt": "2025-01-15T10:30:05Z",
    "statusUpdatedAt": "2025-01-15T10:30:05Z",
    "canTransitionTo": []
  }
}

GET /v1/energy/orders

Order এর তালিকা

Order এর তালিকা জিজ্ঞাসা করুন (pagination এবং filtering সমর্থন করে)

অনুরোধ প্যারামিটার:

প্যারামিটার	ধরন	প্রয়োজনীয়	বিবরণ
offset	number	না	শুরুর বিন্দু, ডিফল্ট 0
limit	number	না	প্রতি পৃষ্ঠায় আইটেম সংখ্যা, ডিফল্ট 20, সর্বোচ্চ 100
status	string	না	Order অবস্থা অনুযায়ী ফিল্টার করুন: processing, completed, failed

প্রতিক্রিয়া উদাহরণ:

{
  "data": {
    "orders": [
      {
        "id": 1234567890,
        "userId": 9876543210,
        "tronAddress": "TYour1...",
        "energyValue": 65000,
        "durationHours": 1,
        "priceSun": 3000000,
        "priceTrx": 3.0,
        "orderType": "manual",
        "status": "completed",
        "createdAt": "2025-01-15T10:30:00Z",
        "updatedAt": "2025-01-15T10:30:05Z",
        "statusUpdatedAt": "2025-01-15T10:30:05Z",
        "canTransitionTo": []
      }
    ],
    "total": 100,
    "offset": 0,
    "limit": 20
  }
}

Address ব্যবস্থাপনা

প্রায়শই ব্যবহৃত addresses পরিচালনা করুন

POST /v1/addresses

Address যোগ করুন

নতুন address সংরক্ষণ করুন

অনুরোধ উদাহরণ:

{
  "tronAddress": "TYour1Address2Here3...",
  "label": "প্রধান Wallet",
  "isDefault": false
}

প্রতিক্রিয়া উদাহরণ:

{
  "data": {
    "id": 1,
    "tronAddress": "TYour1Address2Here3...",
    "label": "প্রধান Wallet",
    "isDefault": false,
    "usageCount": 0,
    "createdAt": "2025-01-01T00:00:00Z"
  }
}

GET /v1/addresses

Address এর তালিকা

সংরক্ষিত addresses এর তালিকা পান

প্রতিক্রিয়া উদাহরণ:

{
  "data": {
    "addresses": [
      {
        "id": 1,
        "tronAddress": "TYour1Address2Here3...",
        "label": "প্রধান Wallet",
        "isDefault": true,
        "usageCount": 5,
        "lastUsedAt": "2025-01-15T10:30:00Z",
        "createdAt": "2025-01-01T00:00:00Z"
      }
    ],
    "total": 1
  }
}

GET /v1/addresses/:id

Address বিস্তারিত

Address এর তথ্য জিজ্ঞাসা করুন

প্রতিক্রিয়া উদাহরণ:

{
  "data": {
    "id": 1,
    "tronAddress": "TYour1Address2Here3...",
    "label": "প্রধান Wallet",
    "isDefault": true,
    "usageCount": 5,
    "lastUsedAt": "2025-01-15T10:30:00Z",
    "createdAt": "2025-01-01T00:00:00Z"
  }
}

PUT /v1/addresses/:id/label

Address লেবেল আপডেট করুন

Address এর লেবেল পরিবর্তন করুন

অনুরোধ উদাহরণ:

{
  "label": "নতুন লেবেল"
}

প্রতিক্রিয়া উদাহরণ:

{
  "data": {
    "id": 1,
    "tronAddress": "TYour1Address2Here3...",
    "label": "নতুন লেবেল",
    "isDefault": false,
    "usageCount": 3,
    "lastUsedAt": "2025-01-15T10:30:00Z",
    "createdAt": "2025-01-01T00:00:00Z"
  }
}

PUT /v1/addresses/:id/default

ডিফল্ট Address হিসেবে সেট করুন

নির্দিষ্ট address কে ডিফল্ট recipient address হিসেবে সেট করুন

প্রতিক্রিয়া উদাহরণ:

// HTTP 204 No Content
// প্রতিক্রিয়ায় কোন কন্টেন্ট নেই

সফল হলে 204 status কোন কন্টেন্ট ছাড়াই ফেরত দেয়

DELETE /v1/addresses/:id

Address মুছুন

সংরক্ষিত address মুছুন