语法指南 | 发明者量化


    javascript
    
    
function main(){
    // 一个不带参数的 GET 访问示例
    var info = JSON.parse(HttpQuery("https://www.okx.com/api/v5/public/time"))
    Log(info)
    // 一个带参数的 GET 访问示例
    var ticker = JSON.parse(HttpQuery("https://www.okx.com/api/v5/market/books?instId=BTC-USDT"))
    Log(ticker)
}


    python
    
    
import json
import urllib.request
def main():
    # HttpQuery 不支持 Python，可以使用 urllib/urllib2 库代替
    info = json.loads(urllib.request.urlopen("https://www.okx.com/api/v5/public/time").read().decode('utf-8'))
    Log(info)
    ticker = json.loads(urllib.request.urlopen("https://www.okx.com/api/v5/market/books?instId=BTC-USDT").read().decode('utf-8'))
    Log(ticker)


    rust
    
    
fn main() {
    // 一个不带参数的 GET 访问示例，在 Rust 中由返回值类型注解决定返回 Body 字符串（String）或完整应答（HttpRet）
    let body: String = HttpQuery("https://www.okx.com/api/v5/public/time", None);
    let info = JSONParse(&body).unwrap();
    Log!(info);
    // 一个带参数的 GET 访问示例
    let body2: String = HttpQuery("https://www.okx.com/api/v5/market/books?instId=BTC-USDT", None);
    let ticker = JSONParse(&body2).unwrap();
    Log!(ticker);
}


    c++
    
    
void main() {
    auto info = json::parse(HttpQuery("https://www.okx.com/api/v5/public/time"));
    Log(info);
    auto ticker = json::parse(HttpQuery("https://www.okx.com/api/v5/market/books?instId=BTC-USDT"));
    Log(ticker);
}

HttpQuery 函数使用代理设置的示例。


    javascript
    
    
function main() {
    // 本次设置代理并发送 HTTP 请求，无用户名、无密码，此次 HTTP 请求会通过代理发送
    HttpQuery("socks5://127.0.0.1:8889/http://www.baidu.com/")

    // 本次设置代理并发送 HTTP 请求，输入用户名和密码，仅对 HttpQuery 的当前调用生效；之后再次调用 HttpQuery("http://www.baidu.com") 时不会使用代理
    HttpQuery("socks5://username:[email protected]:8889/http://www.baidu.com/")
}


    python
    
    
# HttpQuery 不支持 Python，可以使用 Python 的 urllib2 库


    rust
    
    
fn main() {
    // 本次设置代理并发送 HTTP 请求，无用户名、无密码，此次 HTTP 请求会通过代理发送
    let ret1: String = HttpQuery("socks5://127.0.0.1:8889/http://www.baidu.com/", None);

    // 本次设置代理并发送 HTTP 请求，输入用户名和密码，仅对 HttpQuery 的当前调用生效；之后再次调用 HttpQuery("http://www.baidu.com") 时不会使用代理
    let ret2: String = HttpQuery("socks5://username:[email protected]:8889/http://www.baidu.com/", None);
}


    c++
    
    
void main() {
    HttpQuery("socks5://127.0.0.1:8889/http://www.baidu.com/");
    HttpQuery("socks5://username:[email protected]:8889/http://www.baidu.com/");
}

返回值

类型	描述
string / object	返回请求的应答数据。如果返回值为`JSON`字符串，在`JavaScript`语言的策略中可以使用`JSON.parse()`函数解析，在`C++`语言的策略中可以使用`json::parse()`函数解析。在参数`options`结构中，如果`debug`设置为 true，返回值为对象（JSON）；如果`debug`设置为 false，返回值为字符串。

参数

名称类型必填描述

url

string

是

HTTP 请求的 URL。

options

object

否

HTTP 请求的相关设置，例如可以是以下结构：


            json
            
            
{
    method: "POST",
    body: "a=10&b=20&c=30",
    charset: "UTF-8",
    cookie: "session_id=12345; lang=en",
    debug: false,
    headers: {"TEST-HTTP-QUERY": "123"},
    timeout: 1000
}

method: 用于设置请求方法。
body: 用于设置请求体内容，通常用于 POST、PUT 等请求。
cookie: 用于设置请求中的 Cookie，通常用于携带身份验证信息或会话标识。
headers: 用于设置请求头信息，可用于指定内容类型、身份验证信息等。
debug: 设置为true时，本次HttpQuery函数调用返回完整的应答报文；设置为false时，仅返回应答报文Body中的数据。
timeout: 超时设置，设置为 1000 表示超时时间为 1 秒。
charset: 支持对请求的应答数据进行转码，例如：GB18030，支持常用编码。

此结构中的所有字段均为可选，例如可以不设置headers字段。

参考

HttpQuery_Go

备注

HttpQuery()函数仅支持JavaScript、C++语言；Python语言可以使用urllib库直接发送 HTTP 请求。HttpQuery()主要用于访问交易所无需签名的接口，例如行情信息等公共接口。

回测系统中可以使用HttpQuery()发送请求（仅支持GET请求）以获取数据。回测时限制访问不同URL的次数为 20 次，并且HttpQuery()的访问会缓存数据；相同的URL第二次访问时，HttpQuery()函数将返回缓存数据，不再发起实际的网络请求。