使用 PHP 调用 OKX 接口获取比特币价格与 K 线数据

在数字货币开发中，获取准确的市场数据是进行行情分析、策略回测和交易决策的基础。本文将详细介绍如何使用 PHP 语言，通过 OKX 交易所提供的 API 接口，安全、高效地获取比特币的最新价格和 K 线数据。

环境准备与工具选择

在开始之前，请确保您的开发环境已满足以下条件：

已安装 PHP 运行环境（建议 PHP 7.4 或更高版本）。
使用 Composer 作为 PHP 的依赖管理工具。
选择了一个 PHP 框架（本文以 ThinkPHP 为例，但核心逻辑适用于任何框架或原生 PHP）。

为了简化 HTTP 请求过程，我们推荐使用功能强大的 Guzzle HTTP 客户端库。您可以通过 Composer 轻松安装它：

composer require guzzlehttp/guzzle

配置请求头与生成签名

OKX API 对私有接口的访问有严格的身份验证要求，这是保障您资产安全的重要机制。在开始编码前，您需要准备好三组密钥信息：

API Key: 您的 API 访问公钥。
Secret Key: 用于生成签名的私钥。
Passphrase: 创建 API 密钥时设置的密码。

这些密钥都需要您登录 OKX 官网，在账户的 API 管理页面中创建并获取。

理解签名机制

根据 OKX 官方文档，每个私有请求的头部都必须包含以下字段：

OK-ACCESS-KEY: 您的 API Key 字符串。
OK-ACCESS-SIGN: 使用 HMAC SHA256 算法生成的签名，并经过 Base-64 编码。
OK-ACCESS-TIMESTAMP: 发起请求的 UTC 时间，格式为 ISO 8601（例如：2020-12-08T09:08:57.715Z）。
OK-ACCESS-PASSPHRASE: 您设置的 Passphrase。

签名的生成是核心步骤，其公式为：
signature = Base64Encode( HMAC-SHA256(timestamp + HTTP方法 + 请求路径 + 请求主体, SecretKey) )

实现签名代码

以下 PHP 代码演示了如何设置 UTC 时区并生成符合要求的签名和请求头：

$api_key = "您的_API_Key";
$secret_key = "您的_Secret_Key";
$passphrase = "您的_Passphrase";

// 设置时区为UTC并生成ISO格式时间戳
date_default_timezone_set('UTC');
$timestamp = (new DateTime())->format('Y-m-d\TH:i:s.u\Z');

// 假设请求获取账户余额 GET /api/v5/account/balance
$requestPath = '/api/v5/account/balance';
$method = 'GET';
$body = ''; // GET请求通常无请求体

// 拼接签名字符串
$message = $timestamp . $method . $requestPath . $body;
// 使用HMAC SHA256算法生成签名
$signature = base64_encode(hash_hmac('sha256', $message, $secret_key, true));

// 组装请求头
$headers = [
    "OK-ACCESS-KEY" => $api_key,
    "OK-ACCESS-SIGN" => $signature,
    "OK-ACCESS-TIMESTAMP" => $timestamp,
    "OK-ACCESS-PASSPHRASE" => $passphrase,
    "Content-Type" => "application/json"
];

处理网络连接与代理配置

由于网络环境差异，直接请求海外接口可能会遇到速度慢或连接不上的问题。配置代理是解决此问题的常用方法。

如果您在本地开发环境中运行了代理软件（如 VPN），可以将 Guzzle 客户端的代理指向本地端口。以下示例展示了如何在初始化 Guzzle 客户端时配置代理和之前生成的请求头：

use GuzzleHttp\Client;

$this->client = new Client([
    'base_uri' => 'https://www.okx.com', // 设置基础URI
    'proxy' => 'http://127.0.0.1:23457', // 根据您的本地代理端口修改
    'verify' => false, // 如果需要忽略SSL证书验证，请设置为false（生产环境建议开启）
    'headers' => $headers // 填入上述生成的认证头
]);

完整功能实现与代码整合

我们将上述步骤整合到一个类中，实现一个获取比特币永续合约标记价格的功能。

首先，定义一个简单的响应封装类（如 Res.php），用于标准化 API 的返回格式：

class Res {
    public function success($msg, $data = null) {
        return json_encode([
            "code" => 200,
            "msg" => $msg,
            "data" => $data
        ]);
    }
    public function error($msg) {
        return json_encode([
            "code" => 400,
            "msg" => $msg,
            "data" => null
        ]);
    }
}

接下来，创建主要的服务类（如 OkxService.php）：

use GuzzleHttp\Client;
use DateTime;

class OkxService {
    private $client;
    private $result;
    private $api_key;
    private $secret_key;
    private $passphrase;

    public function __construct() {
        $this->api_key = "您的_API_Key";
        $this->secret_key = "您的_Secret_Key";
        $this->passphrase = "您的_Passphrase";
        $this->result = new Res();
        $this->initClient();
    }

    private function initClient() {
        // 生成签名和请求头
        date_default_timezone_set('UTC');
        $timestamp = (new DateTime())->format('Y-m-d\TH:i:s.u\Z');
        $requestPath = '/api/v5/public/mark-price';
        $method = 'GET';
        $body = '';

        $message = $timestamp . $method . $requestPath . $body;
        $signature = base64_encode(hash_hmac('sha256', $message, $this->secret_key, true));

        $headers = [
            "OK-ACCESS-KEY" => $this->api_key,
            "OK-ACCESS-SIGN" => $signature,
            "OK-ACCESS-TIMESTAMP" => $timestamp,
            "OK-ACCESS-PASSPHRASE" => $this->passphrase,
            "Content-Type" => "application/json"
        ];

        // 初始化Guzzle客户端
        $this->client = new Client([
            'base_uri' => 'https://www.okx.com',
            'proxy' => 'http://127.0.0.1:23457', // 请根据实际情况调整或移除
            'verify' => false,
            'headers' => $headers
        ]);
    }

    public function getMarkPrice($instId = 'BTC-USDT-SWAP') {
        try {
            $response = $this->client->get('/api/v5/public/mark-price?instType=SWAP&instId=' . $instId);
            $data = json_decode($response->getBody()->getContents(), true);
            return $this->result->success("获取数据成功", $data);
        } catch (Exception $e) {
            return $this->result->error("请求失败: " . $e->getMessage());
        }
    }
}

最后，在您的控制器（如 ThinkPHP 框架）中调用该服务：

public function getPrice($type = 'BTC') {
    $okxService = new OkxService();
    $instId = strtoupper($type) . '-USDT-SWAP';
    return $okxService->getMarkPrice($instId);
}

并配置相应的路由规则来访问这个控制器方法。

👉 查看实时行情数据接口文档

常见问题

Q1: 为什么请求返回 401 认证错误？
A1: 请依次检查：API Key、Secret Key 和 Passphrase 是否填写正确；服务器系统时间是否与 UTC 时间同步，误差需在 30 秒以内；签名参数的拼接字符串（timestamp + method + requestPath + body）格式是否完全正确。

Q2: 如何获取其他币种的数据或 K 线数据？
A2: OKX API 提供了丰富的接口。您只需将代码中的请求路径和参数替换为目标接口的即可。例如，获取 K 线数据的接口路径可能是 /api/v5/market/candles，具体参数请查阅官方文档。

Q3: 在生产环境中需要注意什么？
A3: 务必妥善保管您的 API 密钥，不要将其硬编码在代码中，推荐使用环境变量或配置中心管理。同时，应考虑加入重试机制、频率限制和完整的异常处理，以保证程序的稳定性。

Q4: 如果不使用代理，如何优化请求速度？
A4: 您可以选择使用 OKX API 提供的就近接入点（如 AWS 日本节点），或者将您的服务部署在海外服务器上，从而避免跨国网络延迟。

通过本文的指导，您应该已经掌握了使用 PHP 安全调用 OKX API 获取加密货币数据的基本方法。这套方法不仅适用于获取价格，稍作修改即可用于交易、查询账户信息等多种场景。