go-binance
A Golang SDK for binance API.
All the REST APIs listed in binance API document are implemented, as well as the websocket APIs.
For best compatibility, please use Go >= 1.8.
Make sure you have read binance API document before continuing.
API List
| Name | Description | Status |
|---|---|---|
| rest-api.md | Details on the Rest API (/api) | Implemented |
| web-socket-streams.md | Details on available streams and payloads | Implemented |
| user-data-stream.md | Details on the dedicated account stream | Implemented |
| margin-api.md | Details on the Margin API (/sapi) | Implemented |
| futures-api.md | Details on the Futures API (/fapi) | Partially Implemented |
| delivery-api.md | Details on the Coin-M Futures API (/dapi) | Partially Implemented |
Installation
go get github.com/adshao/go-binance/v2
For v1 API, it has been moved to v1 branch, please use:
go get github.com/adshao/go-binance/v1
Importing
import (
"github.com/adshao/go-binance/v2"
)
Documentation
REST API
Setup
Init client for API services. Get APIKey/SecretKey from your binance account.
var (
apiKey = "your api key"
secretKey = "your secret key"
)
client := binance.NewClient(apiKey, secretKey)
futuresClient := binance.NewFuturesClient(apiKey, secretKey) // USDT-M Futures
deliveryClient := binance.NewDeliveryClient(apiKey, secretKey) // Coin-M Futures
A service instance stands for a REST API endpoint and is initialized by client.NewXXXService function.
Simply call API in chain style. Call Do() in the end to send HTTP request.
Following are some simple examples, please refer to godoc for full references.
Create Order
order, err := client.NewCreateOrderService().Symbol("BNBETH").
Side(binance.SideTypeBuy).Type(binance.OrderTypeLimit).
TimeInForce(binance.TimeInForceTypeGTC).Quantity("5").
Price("0.0030000").Do(context.Background())
if err != nil {
fmt.Println(err)
return
}
fmt.Println(order)
// Use Test() instead of Do() for testing.
Get Order
order, err := client.NewGetOrderService().Symbol("BNBETH").
OrderID(4432844).Do(context.Background())
if err != nil {
fmt.Println(err)
return
}
fmt.Println(order)
Cancel Order
_, err := client.NewCancelOrderService().Symbol("BNBETH").
OrderID(4432844).Do(context.Background())
if err != nil {
fmt.Println(err)
return
}
List Open Orders
openOrders, err := client.NewListOpenOrdersService().Symbol("BNBETH").
Do(context.Background())
if err != nil {
fmt.Println(err)
return
}
for _, o := range openOrders {
fmt.Println(o)
}
List Orders
orders, err := client.NewListOrdersService().Symbol("BNBETH").
Do(context.Background())
if err != nil {
fmt.Println(err)
return
}
for _, o := range orders {
fmt.Println(o)
}
List Ticker Prices
prices, err := client.NewListPricesService().Do(context.Background())
if err != nil {
fmt.Println(err)
return
}
for _, p := range prices {
fmt.Println(p)
}
Show Depth
res, err := client.NewDepthService().Symbol("LTCBTC").
Do(context.Background())
if err != nil {
fmt.Println(err)
return
}
fmt.Println(res)
List Klines
klines, err := client.NewKlinesService().Symbol("LTCBTC").
Interval("15m").Do(context.Background())
if err != nil {
fmt.Println(err)
return
}
for _, k := range klines {
fmt.Println(k)
}
List Aggregate Trades
trades, err := client.NewAggTradesService().
Symbol("LTCBTC").StartTime(1508673256594).EndTime(1508673256595).
Do(context.Background())
if err != nil {
fmt.Println(err)
return
}
for _, t := range trades {
fmt.Println(t)
}
Get Account
res, err := client.NewGetAccountService().Do(context.Background())
if err != nil {
fmt.Println(err)
return
}
fmt.Println(res)
Start User Stream
res, err := client.NewStartUserStreamService().Do(context.Background())
if err != nil {
fmt.Println(err)
return
}
fmt.Println(res)
Websocket
You don't need Client in websocket API. Just call binance.WsXxxServe(args, handler, errHandler).
For delivery API you can use
delivery.WsXxxServe(args, handler, errHandler).
Depth
wsDepthHandler := func(event *binance.WsDepthEvent) {
fmt.Println(event)
}
errHandler := func(err error) {
fmt.Println(err)
}
doneC, stopC, err := binance.WsDepthServe("LTCBTC", wsDepthHandler, errHandler)
if err != nil {
fmt.Println(err)
return
}
// use stopC to exit
go func() {
time.Sleep(5 * time.Second)
stopC <- struct{}{}
}()
// remove this if you do not want to be blocked here
<-doneC
Kline
wsKlineHandler := func(event *binance.WsKlineEvent) {
fmt.Println(event)
}
errHandler := func(err error) {
fmt.Println(err)
}
doneC, _, err := binance.WsKlineServe("LTCBTC", "1m", wsKlineHandler, errHandler)
if err != nil {
fmt.Println(err)
return
}
<-doneC
Aggregate
wsAggTradeHandler := func(event *binance.WsAggTradeEvent) {
fmt.Println(event)
}
errHandler := func(err error) {
fmt.Println(err)
}
doneC, _, err := binance.WsAggTradeServe("LTCBTC", wsAggTradeHandler, errHandler)
if err != nil {
fmt.Println(err)
return
}
<-doneC
User Data
wsHandler := func(message []byte) {
fmt.Println(string(message))
}
errHandler := func(err error) {
fmt.Println(err)
}
doneC, _, err := binance.WsUserDataServe(listenKey, wsHandler, errHandler)
if err != nil {
fmt.Println(err)
return
}
<-doneC
Setting Server Time
Your system time may be incorrect and you may use following function to set the time offset based off Binance Server Time:
// use the client future for Futures
client.NewSetServerTimeService().Do(context.Background())
Or you can also overwrite the TimeOffset yourself:
client.TimeOffset = 123
Testnet
You can use the testnet by enabling the corresponding flag.
Note that you can't use your regular API and Secret keys for the testnet. You have to create an account onthe testnet websites : https://testnet.binancefuture.com/ for futures and deliveryor https://testnet.binance.vision/ for the Spot Test Network.
Spot
Use the binance.UseTestnet flag before calling the client creation and the websockets methods.
import (
"github.com/adshao/go-binance/v2"
)
binance.UseTestnet = true
client := binance.NewClient(apiKey, secretKey)
Futures (usd(s)-m futures)
Use the futures.UseTestnet flag before calling the client creation and the websockets methods
import (
"github.com/adshao/go-binance/v2/futures"
)
futures.UseTestnet = true
BinanceClient = futures.NewClient(ApiKey, SecretKey)
Delivery (coin-m futures)
Use the delivery.UseTestnet flag before calling the client creation and the websockets methods
import (
"github.com/adshao/go-binance/v2/delivery"
)
delivery.UseTestnet = true
BinanceClient = delivery.NewClient(ApiKey, SecretKey)
-
因业务需要搭建Binance全节点，过程颇为坎坷，记录一下，以防后人爬不上来， 搭建过程参照https://docs.binance.org/fullnode.html#state-sync，具体步骤不一一解释，这里只说明几个出现问题的地方 下载源代码需要使用git lfs，使用git拉取二进制的节点文件会不存在 如果想同步所有区块，/config/config.toml这个文件中的state_s
-
一 基本介绍 Golang 仍然有面向对象编程的继承、封装和多态的特性，只是实现的方式和其它 OOP 语言不一样。 二 封装介绍 封装(encapsulation)就是把抽象出的字段和对字段的操作封装在一起，数据被保护在内部，程序的其它包只有通过被授权的操作(方法),才能对字段进行操作。 三 封装的理解和好处 1 隐藏实现细节。 2 可以对数据进行验证，保证安全合理(例如 Age 不能超过200
-
1.安装 要求 python 版本为 3.6 以上，安装命令很简单， pip install python-binance-chain 如果安装过程中出现问题，请按照 sec256k1-py, 此处提供一种安装 sec256k1-py 失败的解决方案。 错误1：pkg-config包安装不成功 这个错误是由于pkg-config缺失引起的，手动安装这个包 错误2：secp256k1包安装不成功 安
-
package main import ( "bytes" "flag" "fmt" "github.com/golang/glog" "os/exec" ) func main() { var cmd *exec.Cmd //初始化命令行参数 flag.Parse
-
Go! 是一个 PHP 5.4 库，让 PHP 支持 AOP 面向方面编程方法，无需 PECL 扩展、Runkit、evals 或者 DI 容器支持。可使用 XDebug 轻松调试。 示例代码： // Aspect/MonitorAspect.phpnamespace Aspect;use Go\Aop\Aspect;use Go\Aop\Intercept\FieldAccess;use Go\
-
命令go vet是一个用于检查Go语言源码中静态错误的简单工具。与大多数Go命令一样，go vet命令可以接受-n标记和-x标记。-n标记用于只打印流程中执行的命令而不真正执行它们。-n标记也用于打印流程中执行的命令，但不会取消这些命令的执行。示例如下： hc@ubt:~$ go vet -n pkgtool /usr/local/go/pkg/tool/linux_386/vet golang/
-
命令go fix会把指定代码包的所有Go语言源码文件中的旧版本代码修正为新版本的代码。这里所说的版本即Go语言的版本。代码包的所有Go语言源码文件不包括其子代码包（如果有的话）中的文件。修正操作包括把对旧程序调用的代码更换为对新程序调用的代码、把旧的语法更换为新的语法，等等。 这个工具其实非常有用。在编程语言的升级和演进的过程中，难免会对过时的和不够优秀的语法及标准库进行改进。这样的改进对于编程语
-
Pact Go的版本目前支持Pact v2规范，访问网站开始学习。 Go-Kit例子 Pact Go代码库中有一个详细的Go Kit 例子，介绍如何使用Pact去测试Go Kit微服务。 原生Go实现 还有一个Go版本的Pact(兼容pact v1.1)，不需要运行一个守护进程。如果你不需要v2+的匹配以及运行守护进程，可以考虑使用或者为Pact Go贡献。
-
Panic表示的意思就是有些意想不到的错误发生了。通常我们用来表示程序正常运行过程中不应该出现的，或者我们没有处理好的错误。 package main import "os" func main() { // 我们使用panic来检查预期不到的错误 panic("a problem") // Panic的通常使用方法就是如果一个函数 // 返回一个我们不知道怎么处理
-
使用os.Exit可以给定一个状态，然后立刻退出程序运行。 package main import "fmt" import "os" func main() { // 当使用`os.Exit`的时候defer操作不会被运行， // 所以这里的``fmt.Println`将不会被调用 defer fmt.Println("!") // 退出程序并设置退出状态值
-
Defer 用来保证一个函数调用会在程序执行的最后被调用。通常用于资源清理工作。 package main import "fmt" import "os" // 假设我们想创建一个文件，然后写入数据，最后关闭文件 func main() { // 在使用createFile得到一个文件对象之后，我们使用defer // 来调用关闭文件的方法closeFile，这个方法将在main
-
11.1. go test go test命令是一个按照一定的约定和组织来测试代码的程序。在包目录内，所有以_test.go为后缀名的源文件在执行go build时不会被构建成包的一部分，它们是go test测试的一部分。 在*_test.go文件中，有三种类型的函数：测试函数、基准测试(benchmark)函数、示例函数。一个测试函数是以Test为函数名前缀的函数，用于测试程序的一些逻辑行为是否