nntaoli-project / goex

Cryptocurrency Exchange Rest API SDK For Golang Wrapper Support okx,huobi,binance

Introduction

• Unified and standardize the interfaces of various cryptocurrency trading platforms.

Donate

• [BTC] 1GoEXwVvXG7kNdQSFaUNF35A3izHojLGxP
• [USDT-TRC20] TGoExC6xvzE4wSA9cYZnwcPaXEjibA5Vtc

Example

package main

import (
	goexv2 "github.com/nntaoli-project/goex/v2"
	"github.com/nntaoli-project/goex/v2/logger"
	"github.com/nntaoli-project/goex/v2/model"
	"github.com/nntaoli-project/goex/v2/options"
	"log"
)

func main() {
	logger.SetLevel(logger.DEBUG)                             //设置日志输出级别
	//goexv2.DefaultHttpCli.SetProxy("socks5://127.0.0.1:1080") //socks代理
	goexv2.DefaultHttpCli.SetTimeout(5)                       // 5 second

	_, _, err := goexv2.OKx.Spot.GetExchangeInfo() //建议调用
	if err != nil {
		panic(err)
	}
	btcUSDTCurrencyPair, err := goexv2.OKx.Spot.NewCurrencyPair(model.BTC, model.USDT)//建议这样构建CurrencyPair
	if err != nil {
		panic(err)
	}
		
	//共有api调用
	log.Println(goexv2.OKx.Spot.GetTicker(btcUSDTCurrencyPair))

	//私有API调用
	okxPrvApi := goexv2.OKx.Spot.NewPrvApi(
		options.WithApiKey(""), 
		options.WithApiSecretKey(""), 
		options.WithPassphrase(""))
	
	//创建订单
	order, _, err := okxPrvApi.CreateOrder(btcUSDTCurrencyPair, 0.01, 18000, model.Spot_Buy, model.OrderType_Limit)
	log.Println(err)
	log.Println(order)
}

Filled The OrderClientID

ord, resp, err := okxPrvApi.CreateOrder(btcUSDTCurrencyPair, 0.01, 23000,
		model.Spot_Buy, model.OrderType_Limit,
		model.OptionParameter{}.OrderClientID("goex123027892")) //client id: goex123027892

Thanks

goex's Issues

Okex的websocket接口有使用的demo吗

websocket_test无法使用
okex何时可以支持V3接口

咱修改API的时候能向前兼容么

看了一下最近改的，如果升级，以前的程序完全没法用了，建议改的时候最好是添加，不要修改原接口、字段

是否能支持websocket的接口？

主流btc交易市场均提供了websocket的接口。
相比restapi接口，websocket接口更能及时跟踪市场的变化。

okex future ws can not work?

you use okex ws:
wss://real.okex.com:10440/ws/v1
badly,it can not work.

now okex ws :
wss://real.okex.com:8443/ws/v3

can u fix it ,thanks.

okex v3 公共行情频道ws 什么时候加一下呢

future ws v3 都写好了 getTablePrefix加上 现货频道就好了
想通过okexspotws 走v3接口 可以自己组合请求参数 但是卡在了 connectWs上

是不是这里加一个开关控制是否使用aws比较好呢？

REST API

https://api.huobi.pro

https://api-aws.huobi.pro

Websocket Feed（行情）

wss://api.huobi.pro/ws

wss://api-aws.huobi.pro/ws

Websocket Feed（资产和订单）

wss://api.huobi.pro/ws/v1

wss://api-aws.huobi.pro/ws/v1

http代理优化建议

spot proxy可以通过

&builder.HttpClientConfig{
		HttpTimeout:  3 * time.Second,
		Proxy:        proxy,
		MaxIdleConns: 10,
	}

去设定，但是spot_ws 代码中写死只能通过 环境变量去获取，

func NewSpotWs() *SpotWs {
	spotWs := &SpotWs{}
	logger.Debugf("proxy url: %s", os.Getenv("HTTPS_PROXY"))

	spotWs.wsBuilder = goex.NewWsBuilder().
		WsUrl("wss://stream.binance.com:9443/stream?streams=depth/miniTicker/ticker/trade").
		ProxyUrl(os.Getenv("HTTPS_PROXY")).
		ProtoHandleFunc(spotWs.handle).AutoReconnect()

	spotWs.reqId = 1

	return spotWs
}

这里硬编码可以优化一下，不然本地调试 spot和spot_ws需要创建两个实例，如果统一的代理方式，直接可以使用一个实例

builder.NewAPIBuilder2(&builder.HttpClientConfig{
		HttpTimeout:  3 * time.Second,
		Proxy:        proxy,
		MaxIdleConns: 10,
	}).APIKey(g.access).APISecretkey(g.secret).ApiPassphrase(g.passphrase)

库有错误

vendor\github.com\nntaoli-project\GoEx\builder\APIBuilder.go:151:23: cannot use huobi.NewHbdm(&goex.APIConfig literal) (type *huobi.Hbdm) as type goex.FutureRestAPI in return argument:
*huobi.Hbdm does not implement goex.FutureRestAPI (missing GetDeliveryTime method)

能不能加一下成交订单更多的信息

能不能加一下成交订单更多的信息
比如okex的账单,即包含了当前这个订单成交后,一个缀合哪些订单,手续费是多少等的信息
比如binance的成交订单里,能查到指定订单的成交信息,如手续费之类的

[SetEndPoint] 增加现货/期货SetEndPoint接口

在API interface/FutureRestAPI interface中增加修改endpoint接口

fcoin和fmex移除了?

这个交易所最近又开启了,API貌似全部移除了

websocket相关接口会考虑支持trade订阅吗？

GoEx 如何使用？

# command-line-arguments
.\HuobiPro_test.go:34:13: undefined: NewHuoBiProSpot
.\HuobiPro_test.go:61:11: undefined: NewHuoBiProPoint
.\HuobiPro_test.go:63:24: undefined: HBPOINT
.\websocket_test.go:19:8: undefined: NewWsConn

这个项目改如何使用呢？是我的环境问题？

Currency And CurrencyPair 底层术语改进

1. CurrencyA 改为 base
2. CurrencyB 改为 quote

base asset 指一个交易对的交易对象，即写在靠前部分的资产名
quote asset 指一个交易对的定价资产，即写在靠后部分资产名

希望能支持huobi杠杆api，包括ws和rest，谢谢

希望能支持huobi杠杆api，包括ws和rest，谢谢

Okex V5 exchange integration

Binance市价单接口参数错误

binance/Binance.go 中的MarketSell调用的placeOrder方法，但是placeOrder中订单类型写死了，所以还是下的限价单：
https://github.com/nntaoli-project/GoEx/blob/6ceec6c868a7ccb5c14da8bbdada9a02a0ec3ff5/binance/Binance.go#L167

下卖单时对amount进行四舍五入，报account-frozen-balance-insufficient-error(余额不足)的错误

我有 0.005 个tnb，下市价卖单时，火币api返回 account-frozen-balance-insufficient-error（余额不足），
原因是goex把 0.005 四舍五入变成了 0.01，超过了我实际拥有的tnb币的数量。

请问这种情况要如何处理呢，谢谢！

四舍五入的代码在huobi/HuobiPro.go，大约237行，placeOrder()方法里

futuresEndPoint为空的情况需加以提示

这些地方可否先判断是否设置了futuresEndPoint，如果是空，给提示panic

https://github.com/nntaoli-project/GoEx/blob/bd3235e139b85955640fe34290bfcb62a56281bc/builder/APIBuilder.go#L263

大佬可以添加代码覆盖率的 badge 吗？

虽然，100% 的代码覆盖率也说明不了什么。
但是，没有覆盖率的代码也容易出现隐患。
希望可以添加代码覆盖率的 badge。

Missing license

Which license is this under? Thx

每个交易所的 API 都会进行限速，GoEx 是如何处理交易所限速的？

在 GoEx 的代码里面，我搜索了 rate , limit 和 limiter ，都没有找到相关的代码。所以，我暂且认为 GoEx 没有进行相关的处理工作。
个人觉得，交易所 API 有必要集成限速功能。理由如下：

1. 超出限制后，交易所会返回错误码。以 binance 为例，达到限制返回 429，超过限制返回 418。不对相关错误码进行处理的 API 不是完整的 API。
2. 交易所 API 模块可以设计成单例模式，进行全局管理。

bithumb.go:9:2: cannot find package "internal/log"

https://github.com/nntaoli-project/GoEx/blob/39dddf0ee98377f56eb1a32072dd9afca6bf6c53/bithumb/bithumb.go#L9

bithumb.go:9:2: cannot find package "internal/log"

可以增加对库币KuCoin的支持吗？

库币还是比较知名的交易所，深度也不错，我在那边有手续费返利。
https://docs.kucoin.com/ 文档在这儿。谢谢。

any easy example to get latest price of exchange for example ?

Hi,

Is there any examples for this aweose lib please ?

Thank you !

Bitfinex adaptTimestamp are invalid

Hi,

It seems that Bitfinex date extraction does not return a valid timestamp (at least regarding the Ticker) :
1514294 is missing 10^3 seconds to be the valid date :

Bitfinex Ticker timestamp

Timestamp	Corresponding date	Expected date
1514294	18/1/1970 13:38:14	26/12/2017 14:13:20
1514294000	26/12/2017 14:13:20	26/12/2017 14:13:20

Best regards,

初始化 币安 报错

初始化

api := builder.DefaultAPIBuilder.BuildFuture(goex.BINANCE)
fmt.Println(api)

返回错误信息

/go/pkg/mod/github.com/nntaoli-project/[email protected]/bitmex/bitmex.go:164:3: cannot use leverRate (type int) as type float64 in field value
/go/pkg/mod/github.com/nntaoli-project/[email protected]/bitmex/bitmex.go:236:17: cannot use p.Leverage (type int) as type float64 in assignment

请问有支持btcc的 打算吗

请问有支持btcc的打算吗

Panic on OKCoin GetTicker() with certain currency pairs

Super weird, not sure why. But this will throw an error:

  okcoinAPI := okcoin.New(http.DefaultClient, okcoinAccessKey, okcoinSecretKey)
  result, err := okcoinAPI.GetTicker(goex.BTC_USD)
  if err != nil {
    log.Fatal(err)
  }
fmt.Printf("Close: %v\n", result.Last)

panic: interface conversion: interface {} is nil, not map[string]interface {}

If I change the currency pair to BTC_CNY the error goes away.

FCoin Can not Connected

cannot find module for path internal/log

cannot find module for path internal/log when run go run. https://github.com/nntaoli-project/GoEx/search?q=internal&unscoped_q=internal

ToFloat64这个方法是不是该这么写

func ToFloat64(v interface{}) float64 {
if v == nil {
return 0.0
}

switch v.(type) {
case float64:
	return v.(float64)
case string:
	vStr := v.(string)
	vF, err := strconv.ParseFloat(vStr, 64)
	if err == nil {
		return vF
	}else{
		panic("to float64 error.")
	}
default:
	panic("to float64 error.")
}

}

下一步计划

1. 统一各个平台常见错误码。

float64会出现精度丢失的问题吗？

float64会出现精度丢失的问题吗？

请问这.......

刚go get的，没做任务更改。

github.com/nntaoli-project/goex/kucoin

..\github.com\nntaoli-project\goex\kucoin\kucoin.go:105:37: cannot use params (type map[string]string) as type *kucoin.CreateOrderModel in argument to kc.service.CreateOrder
..\github.com\nntaoli-project\goex\kucoin\kucoin.go:135:37: cannot use params (type map[string]string) as type *kucoin.CreateOrderModel in argument to kc.service.CreateOrder
..\github.com\nntaoli-project\goex\kucoin\kucoin.go:165:37: cannot use params (type map[string]string) as type *kucoin.CreateOrderModel in argument to kc.service.CreateOrder
..\github.com\nntaoli-project\goex\kucoin\kucoin.go:195:37: cannot use params (type map[string]string) as type *kucoin.CreateOrderModel in argument to kc.service.CreateOrder
错误: 进程退出代码 2.

go mod 无法更新到1.0.7_1

是不是"1.0.7_1"这样的版本号不能被go识别？

support binance futures? - thanks

希望可以增加一个替换API接口地址的函数

hbdm被屏蔽了想使用备用地址 api.btcgateway.pro发现只能去修改源码

CoinFalcon support

Hi! Please add support for our exchange, CoinFalcon. API is located here: https://docs.coinfalcon.com/

火币合约签名失败

火币合约签名失败

coinbig了解一下

coinbig了解一下

支持兼容 https://github.com/valyala/fasthttp

版本直接报类型错误了。

../../../go/pkg/mod/github.com/nntaoli-project/[email protected]/bitmex/bitmex.go:164:3: cannot use leverRate (type int) as type float64 in field value
../../../go/pkg/mod/github.com/nntaoli-project/[email protected]/bitmex/bitmex.go:236:17: cannot use p.Leverage (type int) as type float64 in assignment

okex websocket

OKEX_Future_Ws的 GetDepthWithWs / GetTickerWithWs 返回是否应该为ws.Subscribe()，否则重连后无法重新订阅

请问什么时候能支持一下biki.com的api？

biki最近排名一直在飙升，简易支持一下～

GoEx开发者QQ交流群：574829125

增加trades接口

行情API中建议增加trades接口及实现

订单结构，下单接口的修改以适应FAK，IOC等不同类型的订单

部分交易所支持了FAK， IOC，maker only等订单，比如okex
在下单中会额外有一个指定订单类型的字段，用fak等订单可以很大程度优化某些策略下单逻辑的执行速度，希望能考虑支持。
工程量确实比较大,需要的改动有:

type Order struct {
	Price      float64
	Amount     float64
	AvgPrice   float64
	DealAmount float64
	Fee        float64
	Cid        string //客户端自定义ID
	OrderID2   string
	OrderID    int //deprecated
	OrderTime  int
	Status     TradeStatus
	Currency   CurrencyPair
	Side       TradeSide

        OrderType int //新增的订单类型字段
}

PlaceFutureOrder2(currencyPair CurrencyPair, contractType, price, amount string, orderType, openType, matchPrice, leverRate int) (Order, error)

PlaceFutureOrder2和原来的接口区分开以向下兼容，
参数中加入订单类型字段OrderType int，
下单应该返回一个订单的状态，而不单单是订单ID，

能否作为一个大的版本迭代的计划,可以先支持几个主流交易所，然后一步步开始升级迭代，支持更多交易所，社区也可以贡献代码

交易所API更新这边是否会及时更新？

比如某交易所那边API弃用，新增，接口请求或返回参数修改的话，这里会及时更新么

btcbox.co.jp 有没有kline的接口？

btcbox.co.jp 有没有kline的接口？