API โทเค็น

Token API เสนอบริการการโอน, การสอบถาม, และการมอบหมายของ FT (Fungible Token)

รับข้อมูลโทเค็น¶

ส่งคืนข้อมูลสัญญาโทเค็นของที่อยู่สัญญา (contract).

URL ที่ร้องขอ¶

ลิงก์สด	https://bc-api.qpyou.cn/core/v1/ft/{contract}
ลิงก์ Sandbox	https://sandbox-bc-api.qpyou.cn/core/v1/ft/{contract}
วิธีการ HTTP	GET
ประเภทเนื้อหา	application/json

พารามิเตอร์เส้นทาง¶

ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
contract	ที่อยู่ของสัญญาโทเค็น	string	Y

พารามิเตอร์หัว¶

ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
x-network	เครือข่ายบล็อกเชน	สตริง	ใช่
Authorization	โทเค็นการตรวจสอบสิทธิ์ที่จำเป็นในการเรียก API	สตริง	ใช่

การตอบสนอง¶

ชื่อฟิลด์	คำอธิบาย	ประเภท
code	รหัสผลลัพธ์การร้องขอ API, 0: สำเร็จ	หมายเลข
message	ข้อความผลลัพธ์	สตริง
data	ข้อมูลการตอบกลับ API	json
data.name	ชื่อโทเค็น	สตริง
data.symbol	สัญลักษณ์ของโทเค็น	สตริง
data.decimals	จำนวนทศนิยมสูงสุดของโทเค็น	หมายเลข
data.totalSupply	จำนวนรวมของการจัดหา	สตริง

ตัวอย่างการร้องขอ¶

curl -X 'GET' 
  'https://sandbox-bc-api.qpyou.cn/core/v1/ft/0x94853BdC9c6AdD50D7842D1A3117fab385457470' 
  -H 'accept: application/json' 
  -H 'x-network: polygon' 
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...'

ตัวอย่างการตอบกลับ¶

{
  "code": 0,
  "message": "success",
  "data": {
    "name": "Simple Token",
    "symbol": "ST",
    "decimals": 18,
    "totalSupply": "1000000000"
  }
}

รับยอดเงินโทเค็น¶

ส่งคืนยอดโทเค็นปัจจุบันของบัญชีเจ้าของโทเค็น (from).

URL การร้องขอ¶

ลิงก์สด	https://bc-api.qpyou.cn/core/v1/ft/{contract}/account/{from}/balance
ลิงก์ Sandbox	https://sandbox-bc-api.qpyou.cn/core/v1/ft/{contract}/account/{from}/balance
วิธีการ HTTP	GET
ประเภทเนื้อหา	application/json

พารามิเตอร์เส้นทาง¶

ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
contract	ที่อยู่ของสัญญาโทเค็น	string	Y
from	เจ้าของโทเค็น	string	Y

พารามิเตอร์การค้นหา¶

ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
details	ว่าจะคืนรายละเอียดยอดคงเหลือหรือไม่	boolean	N

พารามิเตอร์หัวเรื่อง¶

ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
x-network	เครือข่ายบล็อกเชน	สตริง	ใช่
Authorization	โทเค็นการตรวจสอบสิทธิ์ที่จำเป็นในการเรียก API	สตริง	ใช่

การตอบกลับ¶

ชื่อฟิลด์	คำอธิบาย	ประเภท
code	รหัสผลลัพธ์การร้องขอ API, 0: สำเร็จ	หมายเลข
message	ข้อความผลลัพธ์	สตริง
data	ข้อมูลการตอบกลับ API	json
data.value	ยอดเงินโทเค็น	สตริง
data.rawValue	ยอดเงินโทเค็นที่ไม่ใช้ `data.decimals`	สตริง
data.symbol	สัญลักษณ์ของโทเค็น	สตริง
data.decimals	จำนวนตำแหน่งทศนิยมสูงสุดของโทเค็น	หมายเลข

ตัวอย่างคำขอ¶

curl -X 'GET' 
  'https://sandbox-bc-api.qpyou.cn/core/v1/ft/0x94853BdC9c6AdD50D7842D1A3117fab385457470/account/0x9428e6eF51FEb2201676deEc11B7E36F7c1F0765/balance?details=true' 
  -H 'accept: application/json' 
  -H 'x-network: polygon' 
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...'

ตัวอย่างการตอบกลับ¶

{
  "code": 0,
  "message": "success",
  "data": {
    "value": "999998999",
    "symbol": "ST",
    "decimals": 18,
    "rawValue": "999998999000000000000000000"
  }
}

รับจำนวนโทเค็นที่มีอยู่สำหรับการโอนที่อนุมัติ¶

คืนจำนวนโทเคนที่บัญชีเจ้าของโทเคน from ได้อนุมัติให้บัญชี spender ส่งในนามของเจ้าของ

URL คำขอ¶

ลิงก์สด	https://bc-api.qpyou.cn/core/v1/ft/{contract}/account/{from}/allowance/{spender}
ลิงก์ Sandbox	https://sandbox-bc-api.qpyou.cn/core/v1/ft/{contract}/account/{from}/allowance/{spender}
วิธีการ HTTP	GET
ประเภทเนื้อหา	application/json

พารามิเตอร์เส้นทาง¶

ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
contract	ที่อยู่ของสัญญาโทเค็น	สตริง	ใช่
from	เจ้าของโทเค็น	สตริง	ใช่
spender	บัญชีที่ได้รับอนุญาตให้ส่งโทเค็น	สตริง	ใช่

พารามิเตอร์หัว¶

ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
x-network	เครือข่ายบล็อกเชน	สตริง	ใช่
Authorization	โทเค็นการตรวจสอบสิทธิ์ที่จำเป็นในการเรียก API	สตริง	ใช่

การตอบกลับ¶

ชื่อฟิลด์	คำอธิบาย	ประเภท
code	รหัสผลลัพธ์การร้องขอ API, 0: สำเร็จ	number
message	ข้อความผลลัพธ์	String
data	ข้อมูลการตอบกลับ API	json
data.allowance	จำนวนโทเค็นที่สามารถส่งได้	string

ตัวอย่างคำขอ¶

curl -X 'GET' 
  'https://sandbox-bc-api.qpyou.cn/core/v1/ft/0x94853BdC9c6AdD50D7842D1A3117fab385457470/account/0x9428e6eF51FEb2201676deEc11B7E36F7c1F0765/allowance/0xFBd488D1b00604d3b05124d80E35FeA9A39C3296' 
  -H 'accept: application/json' 
  -H 'x-network: polygon' 
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...'

ตัวอย่างการตอบกลับ¶

{
  "code": 0,
  "message": "success",
  "data": {
    "allowance": "0"
  }
}

ส่งโทเค็น¶

สร้างธุรกรรมที่ส่งโทเค็นไปยังที่อยู่เฉพาะ from จะต้องเป็นเจ้าของโทเค็น หากบัญชีผู้รับ (to) เป็นสัญญา สัญญานี้สามารถทำงานเพิ่มเติมกับ data

URL ขอ¶

ลิงก์สด	https://bc-api.qpyou.cn/core/v1/ft/{contract}/transfer
ลิงก์ Sandbox	https://sandbox-bc-api.qpyou.cn/core/v1/ft/{contract}/transfer
วิธีการ HTTP	POST
ประเภทเนื้อหา	application/json

พารามิเตอร์เส้นทาง¶

ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
contract	ที่อยู่ของสัญญาโทเค็น	สตริง	Y

พารามิเตอร์หัวเรื่อง¶

ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
x-network	เครือข่ายบล็อกเชน	สตริง	ใช่
Authorization	โทเค็นการตรวจสอบสิทธิ์ที่จำเป็นในการเรียก API	สตริง	ใช่

เนื้อหาคำขอ¶

ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
encoded	ว่าการทำธุรกรรมที่ส่งคืนถูกเข้ารหัสหรือไม่ `true`: รับสตริงธุรกรรมดิบที่เข้ารหัส (`data.rawTx`). `false`: รับ `data.rawTx` ที่ถอดรหัส (JSON).	boolean	N
from	ที่อยู่บัญชีที่ส่งโทเค็น	string	Y
to	ที่อยู่บัญชีที่รับโทเค็น	string	Y
amount	จำนวนโทเค็นที่จะส่ง	string	Y

การตอบสนอง¶

ชื่อฟิลด์	คำอธิบาย	ประเภท
code	รหัสผลลัพธ์การร้องขอ API, 0: สำเร็จ	หมายเลข
message	ข้อความผลลัพธ์	สตริง
data	ข้อมูลการตอบกลับ API	json
data.rawTx	ข้อมูลการทำธุรกรรม	สตริงหรือ json
data.hashedTx	นี่คือ `data.rawTx` ที่ถูกแฮช ค่านี้จะถูกส่งกลับเฉพาะเมื่อส่วนหัว API `x-network` เป็น "polygon" และ Request Body `from` เป็นที่อยู่กระเป๋าเงินมัลติซิก	สตริง
data.requestId	ค่าที่ไม่ซ้ำกันซึ่งสามารถระบุการร้องขอ API แต่ละรายการ	สตริง

ตัวอย่างคำขอ¶

curl -X 'POST' 
  'https://sandbox-bc-api.qpyou.cn/core/v1/ft/0x94853BdC9c6AdD50D7842D1A3117fab385457470/transfer' 
  -H 'accept: */*' 
  -H 'x-network: polygon' 
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...' 
  -H 'Content-Type: application/json' 
  -d '{
  "encoded": true,
  "from": "0x9428e6eF51FEb2201676deEc11B7E36F7c1F0765",
  "to": "0xFBd488D1b00604d3b05124d80E35FeA9A39C3296",
  "amount": "100.55"
}'

ตัวอย่างการตอบกลับ¶

// Polygon
{
  "code": 0,
  "message": "success",
  "data": {
    "rawTx": "02f8738301388181c2846fc23ac0846fc23ad882cdc49494853bdc9c6add50d7842d1a3117fab38545747080b8...",
    "hashedTx": "0x53e8783e4da707daf58c96a8cea278e7b2a8a5f185af0913b518974556c79076...",
    "requestId": "4d4aa1e5-2bfe-4080-b42f-03319810fe29"
  }
}
// XPLA
{
  "code": 0,
  "message": "success",
  "data": {   
   "rawTx": "0x53e8783e4da707daf58c96a8cea278e7b2a8a5f185af0913b518974556c79076.....",
    "reqeustId": "4d4aa1e5-2bfe-4080-b42f-03319810fe29"
  }
}

ส่งโทเค็นในนามของเจ้าของ¶

สร้างธุรกรรมที่ส่งโทเค็นไปยังที่อยู่เฉพาะในนามของเจ้าของโทเค็น from จะต้องเป็นบัญชีที่ได้รับมอบหมายสิทธิในการส่งโทเค็นจากเจ้าของโทเค็น (owner) หากบัญชีผู้รับ (to) เป็นสัญญา สัญญานี้สามารถทำงานเพิ่มเติมด้วย data

URL การร้องขอ¶

ลิงก์สด	https://bc-api.qpyou.cn/core/v1/ft/{contract}/transfer-from
ลิงก์ Sandbox	https://sandbox-bc-api.qpyou.cn/core/v1/ft/{contract}/transfer-from
วิธีการ HTTP	POST
ประเภทเนื้อหา	application/json

พารามิเตอร์เส้นทาง¶

ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
สัญญา	ที่อยู่ของสัญญา	สตริง	ใช่

พารามิเตอร์หัวเรื่อง¶

ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
x-network	เครือข่ายบล็อกเชน	สตริง	ใช่
Authorization	โทเค็นการตรวจสอบสิทธิ์ที่จำเป็นในการเรียก API	สตริง	ใช่

เนื้อหาคำขอ¶

ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
from	ที่อยู่กระเป๋าเงินของบัญชีที่ได้รับอนุญาตให้ส่งโทเค็น	สตริง	ใช่
to	ที่อยู่กระเป๋าเงินที่รับโทเค็น	สตริง	ใช่
amount	จำนวนโทเค็นที่จะส่ง	สตริง	ใช่
data	ข้อมูลที่จะส่งหากผู้รับเป็นสัญญา	สตริง	ใช่
owner	ที่อยู่กระเป๋าเงินของบัญชีเจ้าของโทเค็น	สตริง	ใช่
encoded	ว่าการทำธุรกรรมที่ส่งกลับถูกเข้ารหัสหรือไม่ `true`: รับสตริงธุรกรรมดิบที่เข้ารหัส (`data.rawTx`). `false`: รับ `data.rawTx` ที่ถูกถอดรหัส (JSON).	บูลีน	ไม่

การตอบสนอง¶

ชื่อฟิลด์	คำอธิบาย	ประเภท
code	รหัสผลลัพธ์ของคำขอ API, 0: สำเร็จ	หมายเลข
message	ข้อความผลลัพธ์	สตริง
data	ข้อมูลการตอบกลับของ API	json
data.rawTx	ข้อมูลการทำธุรกรรม	สตริงหรือ json
data.hashedTx	นี่คือ `data.rawTx` ที่ถูกแฮช ค่า นี้จะถูกส่งกลับเมื่อ API header `x-network` เป็น "polygon" และ Request Body `from` เป็นที่อยู่กระเป๋าเงินหลายลายเซ็น	สตริง
data.requestId	ค่าที่ไม่ซ้ำกันซึ่งสามารถระบุคำขอ API แต่ละรายการ	สตริง

ตัวอย่างคำขอ¶

curl -X 'POST' 
  'https://sandbox-bc-api.qpyou.cn/core/v1/ft/0x5bd415aeb2b382c7fac9cc72c1f3994e33ff7b02/transfer-from' 
  -H 'accept: */*' 
  -H 'x-network: polygon' 
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...' 
  -H 'Content-Type: application/json' 
  -d '{
  "encoded": true,
  "from": "0xA10078576Ca6f63dc6f78ff9a8ed8bd05B51f463",
  "to": "0xdcd51770d06B54204abd8c30A25b4583D4cABa39",
  "amount": "0.000001",
  "owner": "0xD6e69da7f1be111394dfef4C48eaC9b52ddf2Fd0"
}'

ตัวอย่างการตอบกลับ¶

{
  "code": 0,
  "message": "success",
  "data": {
    "rawTx": "02f8738301388181c2846fc23ac0846fc23ad882cdc49494853bdc9c6add50d7842d1a3117fab38545747080b8...",
    "hashedTx": "0x53e8783e4da707daf58c96a8cea278e7b2a8a5f185af0913b518974556c79076...",
    "requestId": "4d4aa1e5-2bfe-4080-b42f-03319810fe29"
  }
}

มอบสิทธิ์ในการส่งโทเค็น¶

สร้างธุรกรรมที่บัญชี from อนุมัติให้บัญชี to ส่ง amount ของโทเค็นในนามของบัญชี from โดย from จะต้องเป็นเจ้าของโทเค็น

URL การร้องขอ¶

URL สด	https://bc-api.qpyou.cn/core/v1/ft/{contract}/approve
URL แซนด์บ็อกซ์	https://sandbox-bc-api.qpyou.cn/core/v1/ft/{contract}/approve
วิธีการ HTTP	POST
ประเภทเนื้อหา	application/json

พารามิเตอร์เส้นทาง¶

ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
contract	ที่อยู่ของสัญญาโทเค็น	string	Y

พารามิเตอร์หัว¶

ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
x-network	เครือข่ายบล็อกเชน	สตริง	ใช่
Authorization	โทเค็นการตรวจสอบสิทธิ์ที่จำเป็นในการเรียก API	สตริง	ใช่

เนื้อหาคำขอ¶

ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
from	ที่อยู่กระเป๋าเงินของบัญชีเจ้าของโทเค็น	สตริง	ใช่
to	ที่อยู่กระเป๋าเงินของบัญชีที่ได้รับสิทธิในการส่งโทเค็น	สตริง	ใช่
amount	จำนวนโทเค็นที่จะส่ง	สตริง	ใช่
encoded	ว่าการทำธุรกรรมที่ส่งคืนถูกเข้ารหัสหรือไม่ `true`: รับสตริงธุรกรรมดิบที่เข้ารหัส (`data.rawTx`). `false`: รับ `data.rawTx` ที่ถอดรหัส (JSON).	บูลีน	ไม่

การตอบกลับ¶

ชื่อฟิลด์	คำอธิบาย	ประเภท
code	รหัสผลลัพธ์การร้องขอ API, 0: สำเร็จ	หมายเลข
message	ข้อความผลลัพธ์	สตริง
data	ข้อมูลการตอบกลับ API	json
data.rawTx	ข้อมูลการทำธุรกรรม	สตริงหรือ json
data.hashedTx	นี่คือ `data.rawTx` ที่ถูกแฮช ค่านี้จะถูกส่งกลับเฉพาะเมื่อส่วนหัว API `x-network` เป็น "polygon" และ Request Body `from` เป็นที่อยู่กระเป๋าเงินหลายลายเซ็น	สตริง
data.requestId	ค่าที่ไม่ซ้ำกันซึ่งสามารถระบุการร้องขอ API แต่ละรายการ	สตริง

ตัวอย่างคำขอ¶

curl -X 'POST' 
  'https://sandbox-bc-api.qpyou.cn/core/v1/ft/0x5bd415aeb2b382c7fac9cc72c1f3994e33ff7b02/approve' 
  -H 'accept: */*' 
  -H 'x-network: polygon' 
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...' 
  -H 'Content-Type: application/json' 
  -d '{
  "encoded": true,
  "from": "0xD6e69da7f1be111394dfef4C48eaC9b52ddf2Fd0",
  "to": "0xA10078576Ca6f63dc6f78ff9a8ed8bd05B51f463",
  "amount": "100"
}'

ตัวอย่างการตอบกลับ¶

{
  "code": 0,
  "message": "success",
  "data": {
    "rawTx": "02f8738301388181c2846fc23ac0846fc23ad882cdc49494853bdc9c6add50d7842d1a3117fab38545747080b8...",
    "hashedTx": "0x53e8783e4da707daf58c96a8cea278e7b2a8a5f185af0913b518974556c79076...",
    "requestId": "4d4aa1e5-2bfe-4080-b42f-03319810fe29"
  }
}

สัญญาโทเค็นการปรับใช้¶

สร้างธุรกรรมที่ปรับใช้สัญญาโทเคนมาตรฐาน

URL การร้องขอ¶

ลิงก์สด	https://bc-api.qpyou.cn/core/v1/ft/contract
ลิงก์ Sandbox	https://sandbox-bc-api.qpyou.cn/core/v1/ft/contract
วิธีการ HTTP	POST
ประเภทเนื้อหา	application/json

พารามิเตอร์หัวเรื่อง¶

ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
x-network	เครือข่ายบล็อกเชน	สตริง	ใช่
Authorization	โทเค็นการตรวจสอบสิทธิ์ที่จำเป็นในการเรียก API	สตริง	ใช่

เนื้อหาคำขอ¶

ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
from	ที่อยู่กระเป๋าเงินที่ใช้ในการปรับใช้สัญญาโทเค็น	string	Y
name	ชื่อโทเค็น	string	Y
symbol	สัญลักษณ์ของโทเค็น	string	Y
decimals	จำนวนทศนิยมสูงสุดของโทเค็น	number	Y
initialSupply	จำนวนเริ่มต้นของโทเค็นที่ถูกสร้างขึ้น	string	Y
encoded	ว่าการทำธุรกรรมที่ส่งคืนถูกเข้ารหัสหรือไม่ `true`: รับสตริงธุรกรรมดิบที่เข้ารหัส (`data.rawTx`). `false`: รับ `data.rawTx` ที่ถอดรหัส (JSON).	boolean	N

การตอบกลับ¶

ชื่อฟิลด์	คำอธิบาย	ประเภท
code	รหัสผลลัพธ์ของคำขอ API, 0: สำเร็จ	number
message	ข้อความผลลัพธ์	String
data	ข้อมูลการตอบกลับของ API	json
data.rawTx	ข้อมูลการทำธุรกรรม	string หรือ json
data.hashedTx	นี่คือ `data.rawTx` ที่ถูกแฮช ค่านี้จะถูกส่งกลับเฉพาะเมื่อส่วนหัว API `x-network` เป็น "polygon" และเนื้อหาคำขอ `from` เป็นที่อยู่กระเป๋าเงินหลายลายเซ็น	string
data.requestId	ค่าที่ไม่ซ้ำกันซึ่งสามารถระบุคำขอ API แต่ละรายการ	string

ตัวอย่างคำขอ¶

curl -X 'POST' 
  'https://sandbox-bc-api.qpyou.cn/core/v1/ft/contract' 
  -H 'accept: */*' 
  -H 'x-network: polygon' 
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...' 
  -H 'Content-Type: application/json' 
  -d '{
  "encoded": true,
  "from": "0x9428e6eF51FEb2201676deEc11B7E36F7c1F0765",
  "name": "Simple Token",
  "symbol": "ST",
  "decimals": 18,
  "initialSupply": "1000000000"
}'

ตัวอย่างการตอบกลับ¶

{
  "code": 0,
  "message": "success",
  "data": {
    "rawTx": "02f8738301388181c2846fc23ac0846fc23ad882cdc49494853bdc9c6add50d7842d1a3117fab38545747080b8...",
    "hashedTx": "0x53e8783e4da707daf58c96a8cea278e7b2a8a5f185af0913b518974556c79076...",
    "requestId": "4d4aa1e5-2bfe-4080-b42f-03319810fe29"
  }
}