Gate.io API获取指南：密钥、权限与应用详解

• 只读权限： 允许 API 密钥获取市场数据、账户余额等信息，但不能进行任何交易操作。这适用于仅需要分析数据的应用程序。
• 交易权限： 允许 API 密钥执行交易，包括下单、取消订单等。务必谨慎使用此权限，并采取安全措施防止密钥泄露。
• 提现权限： 允许 API 密钥提现资金。这是最高级别的权限，强烈建议不要轻易授予，除非您完全信任您的应用程序并采取了最严格的安全措施。

• API 密钥 (API Key)： 用于身份验证的公钥。您需要将此密钥提供给您的应用程序以进行身份验证。
• API 密钥私钥 (Secret Key)： 用于签名请求的私钥。务必妥善保管此密钥，切勿泄露给他人。

此示例需要交易权限。

以下代码片段展示了如何使用Python的 requests 库与Gate.io交易所的API交互，以进行现货交易下单。 此操作依赖于有效的API密钥和密钥，以及交易所账户已启用交易权限。请注意，此代码只是一个示例，交易决策和参数设置应基于个人的风险承受能力和市场分析。

import requests import hashlib import hmac import time from urllib.parse import urlencode, urlparse

这段代码导入了必要的Python库： requests 用于发送HTTP请求， hashlib 和 hmac 用于生成安全签名， time 用于获取当前时间戳， urllib.parse 用于解析URL和编码数据。

api_key = "YOUR_API_KEY" secret_key = "YOUR_SECRET_KEY" url = "https://api.gateio.ws/api/v4/spot/orders"

在这里，你需要将 "YOUR_API_KEY" 和 "YOUR_SECRET_KEY" 替换为你从Gate.io交易所获得的实际API密钥和密钥。 url 变量定义了API端点，用于创建现货订单。请确保API密钥已启用现货交易权限。

payload = { "currency_pair": "BTC_USDT", "type": "limit", "account": "spot", "side": "buy", "amount": "0.0001", "price": "10000", # replace with current market price or desired limit price "time_in_force": "gtc" # Good Till Canceled. See API documentation for other options }

payload 字典包含了订单的详细信息：

• currency_pair : 交易对，例如 "BTC_USDT"。
• type : 订单类型，这里设置为 "limit"，表示限价单。
• account : 交易账户类型，这里设置为 "spot"，表示现货账户。
• side : 交易方向，这里设置为 "buy"，表示买入。
• amount : 购买数量，这里设置为 "0.0001" BTC。 请根据最小交易单位进行调整。
• price : 限价单的价格，这里设置为 "10000" USDT。请替换为当前市场价格或期望的限价。
• time_in_force : 订单有效期，这里设置为 "gtc" (Good Till Canceled)，表示订单会一直有效，直到被执行或取消。 其他可选值包括 ioc (Immediate Or Cancel) 和 fok (Fill Or Kill)，具体含义请参考Gate.io API文档。

务必根据实际需求修改这些参数。

def generate_signature(url, method, query_string, secret_key): t = int(time.time()) m = hashlib.sha512() query_string = urlparse(url).path + "?" + query_string if query_string else urlparse(url).path msg = f'{method}\n{query_string}\n{urlencode(payload)}\n{t}' # Include POST data in signature for POST requests m.update(msg.encode('utf-8')) sign = hmac.new(secret_key.encode('utf-8'), m.digest(), hashlib.sha512).hexdigest() return sign, t

generate_signature 函数用于生成API请求的签名。Gate.io 使用 HMAC-SHA512 算法对请求进行签名，以确保请求的安全性。该函数接受URL、HTTP方法、查询字符串和密钥作为参数，并返回签名和时间戳：

• 它获取当前时间戳，并创建一个 SHA512 哈希对象。
• 然后，它构建签名消息，该消息包括HTTP方法、URL路径、编码后的 payload 数据（用于POST请求）和时间戳。
• 接下来，它使用密钥对消息进行哈希处理，并返回十六进制格式的签名。

正确生成签名是成功调用API的关键。请仔细核对签名算法和参数。

headers = { 'Content-Type': 'application/', 'KEY': api_key, }

headers 字典包含了HTTP请求头：

• Content-Type : 设置为 application/ ，表示请求体是JSON格式的数据。
• KEY : 设置为你的API密钥。

请注意，根据Gate.io API文档，还需要添加 SIGN 和 Timestamp 到header中。

sign, t = generate_signature(url, "POST", "", secret_key)

调用 generate_signature 函数生成签名和时间戳。

headers['SIGN'] = sign headers['Timestamp'] = str(t) response = requests.post(url, headers=headers, =payload)

将签名和时间戳添加到请求头中。然后，使用 requests.post 函数发送POST请求到API端点。 =payload 参数将 payload 字典转换为 JSON 字符串，并将其作为请求体发送。

if response.status_code == 201: # 201 indicates successful creation data = response.() print(data) else: print(f"Error: {response.status_code}, {response.text}")

检查响应状态码。如果状态码为 201，表示订单已成功创建。然后，将响应体解析为 JSON 格式，并打印出来。如果状态码不是 201，则表示请求失败，打印错误信息，包括状态码和响应文本。 常见的错误包括权限不足、签名错误、参数错误等，请仔细检查API密钥、签名算法和请求参数。

import requests import hashlib import hmac import time from urllib.parse import urlencode, urlparse

apikey = "YOURAPIKEY" secretkey = "YOURSECRETKEY" url = "https://api.gateio.ws/api/v4/spot/accounts" # Endpoint to retrieve spot account balances

def generatesignature(url, method, querystring, secretkey): t = int(time.time()) m = hashlib.sha512() querystring = urlparse(url).path + "?" + querystring if querystring else urlparse(url).path msg = f'{method}\n{querystring}\n\n{t}' m.update(msg.encode('utf-8')) sign = hmac.new(secretkey.encode('utf-8'), m.digest(), hashlib.sha512).hexdigest() return sign, t

headers = { 'Content-Type': 'application/', 'KEY': api_key, }

sign, t = generatesignature(url, "GET", "", secretkey) # No query string for this endpoint

headers['SIGN'] = sign headers['Timestamp'] = str(t)

response = requests.get(url, headers=headers)

if response.status_code == 200: data = response.() print(data) # Prints all account balances for all currencies # You can then iterate through the list of balances to find specific currencies. # Example: # for account in data: # if account['currency'] == 'USDT': # print(f"USDT Balance: Available - {account['available']}, Locked - {account['locked']}")

else: print(f"Error: {response.status_code}, {response.text}")

import requests import hashlib import hmac import time from urllib.parse import urlencode, urlparse

apikey = "YOURAPIKEY" secretkey = "YOURSECRETKEY" orderid = "ORDERIDTOCANCEL" # Replace with the actual order ID you want to cancel. url = f"https://api.gateio.ws/api/v4/spot/orders/{order_id}" # Endpoint to cancel a specific order.

def generatesignature(url, method, querystring, secretkey): t = int(time.time()) m = hashlib.sha512() querystring = urlparse(url).path + "?" + querystring if querystring else urlparse(url).path # Correctly handle potential query string presence msg = f'{method}\n{querystring}\n\n{t}' # Empty body for DELETE request m.update(msg.encode('utf-8')) sign = hmac.new(secretkey.encode('utf-8'), m.digest(), hashlib.sha512).hexdigest() return sign, t

headers = { 'Content-Type': 'application/', 'KEY': api_key, }

sign, t = generatesignature(url, "DELETE", "", secretkey) # No query string for cancelling by order ID.

headers['SIGN'] = sign headers['Timestamp'] = str(t)

response = requests.delete(url, headers=headers) # DELETE request for cancelling an order.

if response.statuscode == 204: # No Content - Successful deletion print(f"Order {orderid} successfully cancelled.") elif response.statuscode == 404: # Order not found. print(f"Order {orderid} not found.") else: print(f"Error: {response.status_code}, {response.text}")