快速开始

本指南将帮助您快速上手 AiCoin 开放 API，了解如何进行接口认证并获取加密货币数据。

获取 API 凭证

要开始使用 AiCoin 开放 API，您需要先获取 API 凭证，请点击下方按钮咨询商务获取。

开放API地址

所有 API 请求都应该发送到以下基础 URL:

https://open.aicoin.com/api/v2

认证流程

所有 API 请求都需要包含以下认证参数：

Name
AccessKeyId
Type
string
Description
您的访问密钥ID
Name
SignatureNonce
Type
string
Description
签名随机数（每次请求都应不同）
Name
Timestamp
Type
string
Description
请求时间戳（秒），有效期30秒
Name
Signature
Type
string
Description
使用 HmacSHA1 + Base64 生成的签名，请参考如何获取 API 认证参数

示例请求

以下是一个完整的 API 调用示例，展示如何获取比特币的实时行情：

const crypto = require('crypto');

// 1. 准备认证参数
const ACCESS_KEY_ID = 'YOUR_ACCESS_KEY_ID';
const ACCESS_SECRET = 'YOUR_ACCESS_SECRET';
const SIGNATURE_NONCE = crypto.randomBytes(4).toString('hex');
const TIMESTAMP = Math.floor(Date.now() / 1000).toString();

// 2. 生成签名
function generateSignature(accessKeyId, accessSecret, signatureNonce, timestamp) {
  const str = `AccessKeyId=${accessKeyId}&SignatureNonce=${signatureNonce}&Timestamp=${timestamp}`;
  const hmac = crypto.createHmac('sha1', accessSecret);
  hmac.update(str);
  return Buffer.from(hmac.digest('hex'), 'binary').toString('base64');
}

const signature = generateSignature(
  ACCESS_KEY_ID,
  ACCESS_SECRET,
  SIGNATURE_NONCE,
  TIMESTAMP
);

// 3. 发起请求
fetch('https://open.aicoin.com/api/v2/coin/ticker?' + new URLSearchParams({
  coin_list: 'bitcoin',
  AccessKeyId: ACCESS_KEY_ID,
  SignatureNonce: SIGNATURE_NONCE,
  Timestamp: TIMESTAMP,
  Signature: signature
}))
.then(response => response.json())
.then(data => console.log(data));

注意事项

每个 API 请求都需要包含完整的认证参数
SignatureNonce 需要保证每次请求都不同
Timestamp 时间戳有效期为 30 秒