ຕາຕະລາງເນື້ອໃນ

ພາບລວມ ນະໂຍບາຍການຈັດລະບົບເວີຊັນ ຄວາມເຂົ້າກັນໄດ້ຂອງເວີຊັນກ່ອນໜ້າ ການຍ້າຍຈາກ V1 ໄປ V2 ການປ່ຽນແປງຂອງ Endpoint ການອັບເດດຮູບແບບຕອບກັບ ເວລາທີ່ຈະເລີກການໃຊ້ ການປ່ຽນແປງທີ່ສົ່ງຜົນກະທົບ ຂັ້ນຕອນການຍ້າຍແບບລະບຽບ ການຊ່ວຍເຫຼືອ ແລະ ຊັບພະຍາກອນ

ເອກະສານກ່ຽວກັບ API

API Migration Guide — Upgrading Between Versions

ວາງແຜນ ແລະ ດຳເນີນການອັບເກຣດເວີຊັນ API ແບບລຽບງ່າຍ. ເຂົ້າໃຈການປ່ຽນແປງທີ່ສົ່ງຜົນກະທົບ, ເວລາທີ່ຈະເລີກການໃຊ້, ແລະ ວິທີປະຕິບັດທີ່ດີທີ່ສຸດເພື່ອຍ້າຍລະຫວ່າງເວີຊັນ Smart Money API.

ເຜີຍແຜ່ວັນທີ 21 ມີນາ 2026 • 16 ນາທີໃນການອ່ານ • ຂັ້ນສູງ

ພາບລວມການຍ້າຍ

Smart Money API ຖືກພັດທະນາຢ່າງຕໍ່ເນື່ອງພ້ອມກັບການອັບເດດປົກກະຕິ. ຄູ່ມືນີ້ຈະຄຸ້ມຄອງການຈັດລະບົບເວີຊັນ, ການປ່ຽນແປງທີ່ສົ່ງຜົນກະທົບ, ແລະ ວິທີຍ້າຍການເຊື່ອມຕໍ່ຂອງທ່ານໂດຍບໍ່ມີການຢຸດເຊົາ.

ຫຼັກການສຳຄັນໃນການຍ້າຍ:

ການຈັດລະບົບເວີຊັນແບບມີຄວາມໝາຍ — ຮູບແບບ MAJOR.MINOR.PATCH ຖືກປະຕິບັດຢ່າງເຂັ້ມງວດ
ການສະໜັບສະໜູນໄລຍະຍາວ — ເວີຊັນໃຫຍ່ກ່ອນໜ້າຈະໄດ້ຮັບການສະໜັບສະໜູນເປັນເວລາ 24+ ເດືອນ
ຄຳເຕືອນກ່ອນເລີກການໃຊ້ — ແຈ້ງການລ່ວງໜ້າ 6 ເດືອນສຳລັບການປ່ຽນແປງທີ່ສົ່ງຜົນກະທົບ
ການໃຊ້ເວີຊັນຄູ່ຂະນະ — ໃຊ້ v1 ແລະ v2 ພ້ອມກັນໃນຊ່ວງເວລາຍ້າຍ
ການທົດສອບແບບອັດຕະໂນມັດ — ມີເຄື່ອງມືທົດສອບຄວາມເຂົ້າກັນໄດ້

ສະຖານະປັດຈຸບັນ: v1 (ປະຈຸບັນ), v2 (beta, ຈະເປີດໃຊ້ທົ່ວໄປໃນ Q2 2026). v1 ຈະໄດ້ຮັບການສະໜັບສະໜູນຈົນເຖິງ Q1 2028.

ນະໂຍບາຍການຈັດລະບົບເວີຊັນ

ການຈັດລະບົບເວີຊັນແບບມີຄວາມໝາຍ

ຮູບແບບເວີຊັນ
ເວີຊັນ API: MAJOR.MINOR.PATCH
ຕົວຢ່າງ: 2.1.3
MAJOR (2) - ການປ່ຽນແປງທີ່ສົ່ງຜົນກະທົບ, ໂຄງສ້າງໃໝ່
MINOR (1) - ຄຸນສົມບັດທີ່ເຂົ້າກັນໄດ້ກັບເວີຊັນກ່ອນໜ້າ
PATCH (3) - ການແກ້ໄຂຂໍ້ຜິດພາດ, ການອັບເດດຄວາມປອດໄພ

ວົງຈອນການປ່ອຍເວີຊັນ

ໄລຍະ	ໄລຍະເວລາ	ລັກສະນະ
Alpha	2-4 ອາທິດ	ມີການປ່ຽນແປງຫຼາຍ, ສຳລັບການທົດສອບເທົ່ານັ້ນ
Beta	4-8 ອາທິດ	ສະຖານະຄົງທີ່ສ່ວນໃຫຍ່, ຮັບຟິດແບກຈາກຊຸມຊົນ
Release Candidate	2-4 ອາທິດ	ພ້ອມໃຊ້ໃນການຜະລິດ, ຂັ້ນຕອນສຸດທ້າຍ
General Availability	24+ ເດືອນ	ການສະໜັບສະໜູນການຜະລິດເຕັມຮູບແບບ

ຮັບກະແຈ API ໃນ 30 ວິນາທີ

ພ້ອມສ້າງແລ້ວບໍ? ຮັບກະແຈ API ຟຣີ (100 ຄຳຮ້ອງຕໍ່ມື້, ບໍ່ຕ້ອງໃຊ້ບັດ) ແລະ ເລີ່ມດຶງຂໍ້ມູນ whale, funding ແລະ on-chain ແບບຕົວຈິງ.

ຮັບກະແຈ API →

ຄວາມເຂົ້າກັນໄດ້ຂອງເວີຊັນກ່ອນໜ້າ

ຄວາມເຂົ້າກັນໄດ້ລະຫວ່າງເວີຊັນ

ພາຍໃນເວີຊັນໃຫຍ່ດຽວກັນ, ທ່ານສາມາດອັບເກຣດໄປເວີຊັນ minor/patch ໃໝ່ໄດ້ຢ່າງປອດໄພ:

URL ຂອງ Endpoint — ບໍ່ມີການປ່ຽນແປງ
ຟິວທີ່ຕ້ອງການ — ຈະບໍ່ຖືກລົບອອກ (ມີແຕ່ການເພີ່ມຟິວເສີມເທົ່ານັ້ນ)
ລະຫັດສະຖານະ HTTP — ຄົງທີ່ສຳລັບສະຖານະການທີ່ມີຢູ່ແລ້ວ
ໂຄງສ້າງການຕອບກັບ — ຟິວຫຼັກຍັງຄົງຄືເກົ່າ
ການຢືນຢັນຕົວຕົນ — ບໍ່ມີການປ່ຽນແປງລະບົບການຢືນຢັນ

ການເລີກການໃຊ້ແບບມີການແຈ້ງເຕືອນ

ເວລາທີ່ຈະເລີກການໃຊ້
// ເດືອນທີ 1: ປະກາດເລີກການໃຊ້
// ຄຸນສົມບັດທີ່ຖືກໝາຍດ້ວຍຫົວຂໍ້ Deprecation
Deprecation: version="2.2", sunset="2026-09-01"
// ເດືອນທີ 3-6: ໄລຍະເວລາການເລີກການໃຊ້
// API ຈະສົ່ງຄຳເຕືອນແຕ່ຍັງໃຊ້ງານໄດ້
X-Deprecation-Warning: This endpoint will be removed on 2026-09-01
// ເດືອນທີ 6: ການລົບອອກສຸດທ້າຍ
// Endpoint ຈະຕອບກັບ 410 Gone
HTTP/1.1 410 Gone

ການຍ້າຍຈາກ V1 ໄປ V2

ການປ່ຽນແປງຫຼັກ

ການອອກແບບ REST API ໃໝ່ — Endpoint ຂອງຊັບພະຍາກອນທີ່ສະອາດຂຶ້ນ
ຮູບແບບການຕອບກັບ — ການຫໍ່ແບບສອດຄ່ອງ, ການຈັດການຂໍ້ຜິດພາດທີ່ດີຂຶ້ນ
ການຢືນຢັນຕົວຕົນ — ເພີ່ມການສະໜັບສະໜູນ OAuth 2.0 (ຍັງໃຊ້ກະແຈ API ໄດ້)
ການຈຳກັດອັດຕາການໃຊ້ — ມີຄວາມລະອຽດ ແລະ ຄວາມຊັດເຈນດີຂຶ້ນ
Webhooks — ອອກແບບຮູບແບບເຫດການ ແລະ ການລົງນາມໃໝ່

ການແປງ Endpoint

Endpoint V1	Endpoint V2	ການປ່ຽນແປງ
GET /whales	GET /v2/whales/tracking	ຈັດລະບຽບໃໝ່, ເພີ່ມການກັ່ນຕອງ
GET /funding	GET /v2/derivatives/funding-heatmap	ຕ້ອງການພາລາມິເຕີ exchange
GET /positions	GET /v2/derivatives/positions	ມີຕົວເລືອກການລວມຂໍ້ມູນໃໝ່

ການປ່ຽນແປງຂອງ Endpoint

ການປ່ຽນແປງພາລາມິເຕີການຮ້ອງຂໍ

ການຮ້ອງຂໍ V1
// V1: ອັດຕາ funding
GET /v1/funding?symbol=BTCUSDT&exchange=binance

ການຮ້ອງຂໍ V2
// V2: ຂໍ້ມູນດຽວກັນ, ໂຄງສ້າງທີ່ຊັດເຈນຂຶ້ນ
GET /v2/derivatives/funding-heatmap?
  symbol=BTCUSDT&
  exchange=binance

ການອັບເດດຮູບແບບການຕອບກັບ

V1 Response Structure

V1 Format
{
 "status": "success",
 "data": {
 "symbol": "BTCUSDT",
 "funding": 0.0001
  }
}

V2 Response Structure

V2 Format
{
 "data": {
 "symbol": "BTCUSDT",
 "funding_rate": 0.0001
  },
 "_meta": {
 "request_id": "req_abc123",
 "timestamp": 1709980800000
  }
}

Key Differences: No status wrapper, clearer field names, standardized metadata.

Deprecation Timeline

Planned Deprecations

Feature	Announced	Sunset Date	Replacement
/v1/whales	Jan 2026	Jan 2028	/v2/whales/tracking
/v1/funding	Jan 2026	Jan 2028	/v2/derivatives/funding-heatmap
API key only auth	Mar 2026	Mar 2027	OAuth 2.0 (keys still work)
Webhook v1 format	Q2 2026	Q2 2027	Webhook v2 format

Breaking Changes Detail

Removed Endpoints

/v1/stats — Replaced by /v2/metrics
/v1/historical — Replaced by /v2/historical with new parameters
/v1/alerts/create — Replaced by POST /v2/alerts

Parameter Changes

limit — Default changed from 100 to 20 (be explicit!)
timeframe — Now required on historical queries
sort — Format changed from "field asc" to "field:asc"

Response Field Changes

funding → funding_rate
price → mark_price
vol → volume_quote

Step-by-Step Migration

Phase 1: Planning (Week 1-2)

Audit existing integration for deprecated features
Map v1 endpoints to v2 equivalents
Identify breaking changes affecting your code
Plan testing strategy and timeline

Phase 2: Development (Week 3-4)

Create v2 branch in version control
Update all API endpoints to v2 URLs
Update request/response handling
Run unit tests against sandbox

Phase 3: Testing (Week 5-6)

Run full integration test suite
Test error scenarios and edge cases
Load testing with v2 endpoints
Security audit of updated code

Phase 4: Staging (Week 7)

Deploy v2 code to staging environment
Run full acceptance tests
Get sign-off from stakeholders
Prepare rollback plan

Phase 5: Production (Week 8)

Blue-green deploy to production
Monitor metrics and error rates
Stay on call for support issues
Gradually decommission v1 code

Support & Resources

Available Tools

Migration Validator — Check code for deprecated usage
API Upgrade Checker — Compare v1 and v2 compatibility
Migration Checklist — PDF with tasks and timeline
Code Examples — Before/after migration samples

Getting Help

Email: [email protected]
Documentation: See changelog-versioning.html
Discord: Community support channel
Enterprise: Dedicated migration engineer

Start Your Migration Today

Upgrade to API v2 with comprehensive migration tools, documentation, and support. Built to support zero-downtime migration.

Explore V2

V1 supported through Jan 2028. Plan your migration today.