binance

package
v0.2.1 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jun 24, 2025 License: MIT Imports: 21 Imported by: 0

Documentation

Index

Constants

View Source 
const (
	GlobalApiBaseUrl           = "https://api.binance.com"
	UsApiBaseUrl               = "https://api.binance.us"
	JeApiBaseUrl               = "https://api.binance.je"
	ApiV3                      = GlobalApiBaseUrl + "/api/v3/"
	TickerUri                  = "ticker/24hr?symbol=%s"
	TickersUri                 = "ticker/allBookTickers"
	FeeUrl                     = GlobalApiBaseUrl + "/sapi/v1/asset/tradeFee"
	ExWithdrawUrl              = GlobalApiBaseUrl + "/sapi/v1/asset/assetDetail"
	NetworkWithdrawUrl         = GlobalApiBaseUrl + "/sapi/v1/capital/config/getall"
	DepthUri                   = "depth?symbol=%s&limit=%d"
	AccountUri                 = "account?"
	OrderUri                   = "order"
	UnfinishedOrdersInfo       = "openOrders?"
	KlineUri                   = "klines"
	ServerTimeUrl              = "time"
	FutureUsdWsBaseUrl         = "wss://fstream.binance.com/ws"
	FutureCoinWsBaseUrl        = "wss://dstream.binance.com/ws"
	TestnetSpotApiBaseUrl      = GlobalApiBaseUrl
	TestnetSpotWsBaseUrl       = "wss://stream.testnet.binance.vision/ws"
	TestnetSpotStreamBaseUrl   = "wss://stream.testnet.binance.vision/stream"
	TestnetFutureUsdBaseUrl    = "https://testnet.binancefuture.com"
	TestnetFutureUsdWsBaseUrl  = "wss://fstream.binance.com/ws"
	TestnetFutureCoinWsBaseUrl = "wss://dstream.binance.com/ws"
)
View Source 
const MaxChannelSymbols = 358
View Source 
const MaxSymbolChannels = 2

Variables

This section is empty.

Functions

This section is empty.

Types

type AccountResponse 

type AccountResponse struct {
	FeeTier  int  `json:"feeTier"`
	CanTrade bool `json:"canTrade"`
	Assets   []struct {
		Asset            string  `json:"asset"`
		WalletBalance    float64 `json:"walletBalance,string"`
		MarginBalance    float64 `json:"marginBalance,string"`
		UnrealizedProfit float64 `json:"unrealizedProfit,string"`
		MaintMargin      float64 `json:"maintMargin,string"`
	} `json:"assets"`
}

type AssetDetail 

type AssetDetail struct {
	Coin             string            `json:"coin"`
	DepositAllEnable bool              `json:"depositAllEnable"`
	Free             string            `json:"free"`
	Freeze           string            `json:"freeze"`
	Ipoable          string            `json:"ipoable"`
	Ipoing           string            `json:"ipoing"`
	IsLegalMoney     bool              `json:"isLegalMoney"`
	Locked           string            `json:"locked"`
	Name             string            `json:"name"`
	NetworkList      []NetworkWithdraw `json:"networkList"`
}

type BaseResponse 

type BaseResponse struct {
	Code int    `json:"code"`
	Msg  string `json:"msg"`
}

type Binance 

type Binance struct {
	*ExchangeInfo
	// contains filtered or unexported fields
}

func New 

func New(client *http.Client, apiKey, secretKey string) *Binance

func NewWithConfig 

func NewWithConfig(config *APIConfig) *Binance

func (*Binance) AllTicker 

func (bn *Binance) AllTicker(SymPair map[string]q.D) (*sync.Map, error)

func (*Binance) AssetDetail 

func (bn *Binance) AssetDetail() (sf map[string]AssetDetail, err error)

func (*Binance) Balances 

func (bn *Binance) Balances() (available, frozen *sync.Map, err error)

func (*Binance) CancelOrder 

func (bn *Binance) CancelOrder(orderId string, currencyPair CurrencyPair) (bool, error)

func (*Binance) ExWithdrawFee 

func (bn *Binance) ExWithdrawFee() (sf map[string]ExWithdraw, err error)

func (*Binance) Fee 

func (bn *Binance) Fee() float64

*

  • Level 30d Trade BNB Balance Maker / Taker Maker / TakerBNB 25% off VIP 0 < 50 BTC or ≥ 0 BNB 0.1000% / 0.1000% 0.0750% / 0.0750% VIP 1 ≥ 50 BTC and ≥ 50 BNB 0.0900% / 0.1000% 0.0675% / 0.0750% VIP 2 ≥ 500 BTC and ≥ 200 BNB 0.0800% / 0.1000% 0.0600% / 0.0750% VIP 3 ≥ 1500 BTC and ≥ 500 BNB 0.0700% / 0.1000% 0.0525% / 0.0750%

func (*Binance) GetAccount 

func (bn *Binance) GetAccount() (*Account, error)

func (*Binance) GetAttr 

func (bn *Binance) GetAttr() (a q.Attr)

func (*Binance) GetDepth 

func (bn *Binance) GetDepth(size int, currencyPair CurrencyPair) (*Depth, error)

func (*Binance) GetExchangeInfo 

func (bn *Binance) GetExchangeInfo() (*ExchangeInfo, error)

func (*Binance) GetKlineRecords 

func (bn *Binance) GetKlineRecords(currency CurrencyPair, period KlinePeriod, size int, optional ...OptionalParameter) ([]Kline, error)

func (*Binance) GetOneOrder 

func (bn *Binance) GetOneOrder(orderId string, currencyPair CurrencyPair) (*q.Order, error)

func (*Binance) GetOrderHistorys 

func (bn *Binance) GetOrderHistorys(currency CurrencyPair, optional ...OptionalParameter) ([]q.Order, error)

func (*Binance) GetTicker 

func (bn *Binance) GetTicker(currency CurrencyPair) (*Ticker, error)

func (*Binance) GetTradeSymbol 

func (bn *Binance) GetTradeSymbol(currencyPair CurrencyPair) (*TradeSymbol, error)

func (*Binance) GetTrades 

func (bn *Binance) GetTrades(currencyPair CurrencyPair, since int64) ([]q.Trade, error)

非个人，整个交易所的交易记录 注意：since is fromId

func (*Binance) GetUnfinishedOrders 

func (bn *Binance) GetUnfinishedOrders(currencyPair CurrencyPair) ([]q.Order, error)

func (*Binance) LimitBuy 

func (bn *Binance) LimitBuy(amount, price string, currencyPair CurrencyPair, opt ...LimitOrderOptionalParameter) (*q.Order, error)

func (*Binance) LimitSell 

func (bn *Binance) LimitSell(amount, price string, currencyPair CurrencyPair, opt ...LimitOrderOptionalParameter) (*q.Order, error)

func (*Binance) MarketBuy 

func (bn *Binance) MarketBuy(amount, price string, currencyPair CurrencyPair) (*q.Order, error)

func (*Binance) MarketSell 

func (bn *Binance) MarketSell(amount, price string, currencyPair CurrencyPair) (*q.Order, error)

func (*Binance) OneTicker 

func (bn *Binance) OneTicker(d q.D) (ticker q.Bbo, err error)

func (*Binance) PairArray 

func (bn *Binance) PairArray() (map[string]q.D, map[q.D]q.P, error)

func (*Binance) Ping 

func (bn *Binance) Ping() bool

func (*Binance) PlaceOrders 

func (bn *Binance) PlaceOrders(places [3]q.Order) (orders [3]q.Order, err error)

func (*Binance) String 

func (bn *Binance) String() string

func (*Binance) Test 

func (bn *Binance) Test() bool

func (*Binance) TradeFee 

func (bn *Binance) TradeFee() (map[string]TradeFee, error)

func (*Binance) WithdrawFee 

func (bn *Binance) WithdrawFee() (sf []NetworkWithdraw, err error)

type BookTicker 

type BookTicker struct {
	Symbol   string  `json:"symbol"`
	BidPrice float64 `json:"bidPrice,string"`
	BidQty   float64 `json:"bidQty,string"`
	AskPrice float64 `json:"askPrice,string"`
	AskQty   float64 `json:"askQty,string"`
}

type ExWithdraw 

type ExWithdraw struct {
	MinWithdrawAmount float64 `json:"minWithdrawAmount"`
	DepositStatus     bool    `json:"depositStatus"`
	WithdrawFee       float64 `json:"withdrawFee"`
	WithdrawStatus    bool    `json:"withdrawStatus"`
	DepositTip        string  `json:"depositTip"`
}

type ExchangeInfo 

type ExchangeInfo struct {
	Timezone        string        `json:"timezone"`
	ServerTime      int           `json:"serverTime"`
	ExchangeFilters []any         `json:"exchangeFilters,omitempty"`
	RateLimits      []RateLimit   `json:"rateLimits"`
	Symbols         []TradeSymbol `json:"symbols"`
}

type Filter 

type Filter struct {
	FilterType          string  `json:"filterType"`
	MaxPrice            float64 `json:"maxPrice,string"`
	MinPrice            float64 `json:"minPrice,string"`
	TickSize            float64 `json:"tickSize,string"`
	MultiplierUp        float64 `json:"multiplierUp,string"`
	MultiplierDown      float64 `json:"multiplierDown,string"`
	AvgPriceMins        int     `json:"avgPriceMins"`
	MinQty              float64 `json:"minQty,string"`
	MaxQty              float64 `json:"maxQty,string"`
	StepSize            float64 `json:"stepSize,string"`
	MinNotional         float64 `json:"minNotional,string"`
	ApplyToMarket       bool    `json:"applyToMarket"`
	Limit               int     `json:"limit"`
	MaxNumAlgoOrders    int     `json:"maxNumAlgoOrders"`
	MaxNumIcebergOrders int     `json:"maxNumIcebergOrders"`
	MaxNumOrders        int     `json:"maxNumOrders"`
}

type Futures 

type Futures struct {
	// contains filtered or unexported fields
}

func NewBinanceFutures 

func NewBinanceFutures(config *APIConfig) *Futures

func (*Futures) FutureCancelOrder 

func (bs *Futures) FutureCancelOrder(currencyPair CurrencyPair, contractType, orderId string) (bool, error)

func (*Futures) GetContractValue 

func (bs *Futures) GetContractValue(currencyPair CurrencyPair) (float64, error)

func (*Futures) GetDeliveryTime 

func (bs *Futures) GetDeliveryTime() (int, int, int, int)

func (*Futures) GetExchangeInfo 

func (bs *Futures) GetExchangeInfo()

func (*Futures) GetFee 

func (bs *Futures) GetFee() (float64, error)

func (*Futures) GetFutureDepth 

func (bs *Futures) GetFutureDepth(currencyPair CurrencyPair, contractType string, size int) (*Depth, error)

func (*Futures) GetFutureEstimatedPrice 

func (bs *Futures) GetFutureEstimatedPrice(currencyPair CurrencyPair) (float64, error)

func (*Futures) GetFutureIndex 

func (bs *Futures) GetFutureIndex(currencyPair CurrencyPair) (float64, error)

func (*Futures) GetFutureOrder 

func (bs *Futures) GetFutureOrder(orderId string, currencyPair CurrencyPair, contractType string) (*FutureOrder, error)

func (*Futures) GetFutureOrderHistory 

func (bs *Futures) GetFutureOrderHistory(pair CurrencyPair, contractType string, optional ...OptionalParameter) ([]FutureOrder, error)

func (*Futures) GetFutureOrders 

func (bs *Futures) GetFutureOrders(orderIds []string, currencyPair CurrencyPair, contractType string) ([]FutureOrder, error)

func (*Futures) GetFuturePosition 

func (bs *Futures) GetFuturePosition(currencyPair CurrencyPair, contractType string) ([]FuturePosition, error)

func (*Futures) GetFutureTicker 

func (bs *Futures) GetFutureTicker(currencyPair CurrencyPair, contractType string) (*Ticker, error)

func (*Futures) GetFutureUserinfo 

func (bs *Futures) GetFutureUserinfo(currencyPair ...CurrencyPair) (*FutureAccount, error)

func (*Futures) GetKlineRecords 

func (bs *Futures) GetKlineRecords(contractType string, currency CurrencyPair, period KlinePeriod, size int, opt ...OptionalParameter) ([]FutureKline, error)

func (*Futures) GetTrades 

func (bs *Futures) GetTrades(contractType string, currencyPair CurrencyPair, since int64) ([]Trade, error)

func (*Futures) GetUnfinishFutureOrders 

func (bs *Futures) GetUnfinishFutureOrders(currencyPair CurrencyPair, contractType string) ([]FutureOrder, error)

func (*Futures) LimitFuturesOrder 

func (bs *Futures) LimitFuturesOrder(currencyPair CurrencyPair, contractType, price, amount string, openType int, opt ...LimitOrderOptionalParameter) (*FutureOrder, error)

func (*Futures) MarketFuturesOrder 

func (bs *Futures) MarketFuturesOrder(currencyPair CurrencyPair, contractType, amount string, openType int) (*FutureOrder, error)

func (*Futures) PlaceFutureOrder 

func (bs *Futures) PlaceFutureOrder(currencyPair CurrencyPair, contractType, price, amount string, openType, matchPrice int, leverRate float64) (string, error)

func (*Futures) PlaceFutureOrder2 

func (bs *Futures) PlaceFutureOrder2(currencyPair CurrencyPair, contractType, price, amount string, openType, matchPrice int, opt ...LimitOrderOptionalParameter) (string, error)

func (*Futures) SetBaseUri 

func (bs *Futures) SetBaseUri(uri string)

func (*Futures) String 

func (bs *Futures) String() string

type FuturesWs 

type FuturesWs struct {
	// contains filtered or unexported fields
}

func NewFuturesWs 

func NewFuturesWs() *FuturesWs

func (*FuturesWs) DepthCallback 

func (s *FuturesWs) DepthCallback(f func(depth *exws.Depth))

func (*FuturesWs) SubscribeDepth 

func (s *FuturesWs) SubscribeDepth(pair cons.CurrencyPair, contractType string) error

func (*FuturesWs) SubscribeTicker 

func (s *FuturesWs) SubscribeTicker(pair cons.CurrencyPair, contractType string) error

func (*FuturesWs) SubscribeTrade 

func (s *FuturesWs) SubscribeTrade(pair cons.CurrencyPair, contractType string) error

func (*FuturesWs) TickerCallback 

func (s *FuturesWs) TickerCallback(f func(ticker *exws.FutureTicker))

func (*FuturesWs) TradeCallback 

func (s *FuturesWs) TradeCallback(f func(trade *q.Trade, contract string))

type OrderInfoResponse 

type OrderInfoResponse struct {
	BaseResponse
	Symbol        string  `json:"symbol"`
	Pair          string  `json:"pair"`
	ClientOrderId string  `json:"clientOrderId"`
	OrderId       int64   `json:"orderId"`
	AvgPrice      float64 `json:"avgPrice,string"`
	ExecutedQty   float64 `json:"executedQty,string"`
	OrigQty       float64 `json:"origQty,string"`
	Price         float64 `json:"price,string"`
	Side          string  `json:"side"`
	PositionSide  string  `json:"positionSide"`
	Status        string  `json:"status"`
	Type          string  `json:"type"`
	Time          int64   `json:"time"`
	UpdateTime    int64   `json:"updateTime"`
}

type PositionRiskResponse 

type PositionRiskResponse struct {
	Symbol           string  `json:"symbol"`
	PositionAmt      float64 `json:"positionAmt,string"`
	EntryPrice       float64 `json:"entryPrice,string"`
	UnRealizedProfit float64 `json:"unRealizedProfit,string"`
	LiquidationPrice float64 `json:"liquidationPrice,string"`
	Leverage         float64 `json:"leverage,string"`
	MarginType       string  `json:"marginType"`
	PositionSide     string  `json:"positionSide"`
}

type RateLimit 

type RateLimit struct {
	Interval      string `json:"interval"`
	IntervalNum   int64  `json:"intervalNum"`
	Limit         int64  `json:"limit"`
	RateLimitType string `json:"rateLimitType"`
}

type SpotWs 

type SpotWs struct {
	// contains filtered or unexported fields
}

func NewSpotWs 

func NewSpotWs() *SpotWs

func (*SpotWs) BBOCallback 

func (s *SpotWs) BBOCallback(f func(ticker *q.Bbo))

func (*SpotWs) DepthCallback 

func (s *SpotWs) DepthCallback(f func(depth *exws.Depth))

func (*SpotWs) SubscribeBBO 

func (s *SpotWs) SubscribeBBO(sm []string) (err error)

func (*SpotWs) SubscribeDepth 

func (s *SpotWs) SubscribeDepth(pair cons.CurrencyPair) error

func (*SpotWs) SubscribeTicker 

func (s *SpotWs) SubscribeTicker(pair cons.CurrencyPair) error

func (*SpotWs) SubscribeTrade 

func (s *SpotWs) SubscribeTrade(pair cons.CurrencyPair) error

TODO: test

func (*SpotWs) TickerCallback 

func (s *SpotWs) TickerCallback(f func(ticker *exws.Ticker))

func (*SpotWs) TradeCallback 

func (s *SpotWs) TradeCallback(f func(trade *q.Trade))

type Swap 

type Swap struct {
	Binance
	// contains filtered or unexported fields
}

func NewBinanceSwap 

func NewBinanceSwap(config *APIConfig) *Swap

func (*Swap) FutureCancelAllOrders 

func (bs *Swap) FutureCancelAllOrders(currencyPair CurrencyPair, contractType string) (bool, error)

func (*Swap) FutureCancelOrder 

func (bs *Swap) FutureCancelOrder(currencyPair CurrencyPair, contractType, orderId string) (bool, error)

func (*Swap) FutureCancelOrders 

func (bs *Swap) FutureCancelOrders(currencyPair CurrencyPair, contractType string, orderIdList []string) (bool, error)

func (*Swap) GetContractValue 

func (bs *Swap) GetContractValue(currencyPair CurrencyPair) (float64, error)

func (*Swap) GetDeliveryTime 

func (bs *Swap) GetDeliveryTime() (int, int, int, int)

func (*Swap) GetFee 

func (bs *Swap) GetFee() (float64, error)

func (*Swap) GetFutureDepth 

func (bs *Swap) GetFutureDepth(currency CurrencyPair, contractType string, size int) (*Depth, error)

func (*Swap) GetFutureEstimatedPrice 

func (bs *Swap) GetFutureEstimatedPrice(currencyPair CurrencyPair) (float64, error)

func (*Swap) GetFutureIndex 

func (bs *Swap) GetFutureIndex(currencyPair CurrencyPair) (float64, error)

func (*Swap) GetFutureOrder 

func (bs *Swap) GetFutureOrder(orderId string, currencyPair CurrencyPair, contractType string) (*FutureOrder, error)

func (*Swap) GetFutureOrderHistory 

func (bs *Swap) GetFutureOrderHistory(pair CurrencyPair, contractType string, optional ...OptionalParameter) ([]FutureOrder, error)

func (*Swap) GetFutureOrders 

func (bs *Swap) GetFutureOrders(orderIds []string, currencyPair CurrencyPair, contractType string) ([]FutureOrder, error)

func (*Swap) GetFuturePosition 

func (bs *Swap) GetFuturePosition(currencyPair CurrencyPair, contractType string) ([]FuturePosition, error)

func (*Swap) GetFutureTicker 

func (bs *Swap) GetFutureTicker(currency CurrencyPair, contractType string) (*Ticker, error)

func (*Swap) GetFutureUserinfo 

func (bs *Swap) GetFutureUserinfo(currencyPair ...CurrencyPair) (*FutureAccount, error)

func (*Swap) GetKlineRecords 

func (bs *Swap) GetKlineRecords(contractType string, currency CurrencyPair, period KlinePeriod, size int, opt ...OptionalParameter) ([]FutureKline, error)

func (*Swap) GetServerTime 

func (bs *Swap) GetServerTime() (int64, error)

func (*Swap) GetTrades 

func (bs *Swap) GetTrades(contractType string, currencyPair CurrencyPair, since int64) ([]Trade, error)

func (*Swap) GetUnfinishFutureOrders 

func (bs *Swap) GetUnfinishFutureOrders(currencyPair CurrencyPair, contractType string) ([]FutureOrder, error)

func (*Swap) LimitFuturesOrder 

func (bs *Swap) LimitFuturesOrder(currencyPair CurrencyPair, contractType, price, amount string, openType int, opt ...LimitOrderOptionalParameter) (*FutureOrder, error)

func (*Swap) MarketFuturesOrder 

func (bs *Swap) MarketFuturesOrder(currencyPair CurrencyPair, contractType, amount string, openType int) (*FutureOrder, error)

func (*Swap) Ping 

func (bs *Swap) Ping() bool

func (*Swap) PlaceFutureOrder 

func (bs *Swap) PlaceFutureOrder(currencyPair CurrencyPair, contractType, price, amount string, openType, matchPrice int, leverRate float64) (string, error)

func (*Swap) PlaceFutureOrder2 

func (bs *Swap) PlaceFutureOrder2(currencyPair CurrencyPair, contractType, price, amount string, openType, matchPrice int, opt ...LimitOrderOptionalParameter) (*FutureOrder, error)

func (*Swap) SetBaseUri 

func (bs *Swap) SetBaseUri(uri string)

func (*Swap) String 

func (bs *Swap) String() string

func (*Swap) Transfer 

func (bs *Swap) Transfer(currency Currency, transferType int, amount float64) (int64, error)

@deprecated please call the Wallet api

type SymbolInfo 

type SymbolInfo struct {
	Symbol         string
	Pair           string
	ContractType   string `json:"contractType"`
	DeliveryDate   int64  `json:"deliveryDate"`
	ContractStatus string `json:"contractStatus"`
	ContractSize   int    `json:"contractSize"`
	PricePrecision int    `json:"pricePrecision"`
}

type TradeSymbol 

type TradeSymbol struct {
	Symbol                     string   `json:"symbol"`
	Status                     string   `json:"status"`
	BaseAsset                  string   `json:"baseAsset"`
	BaseAssetPrecision         int      `json:"baseAssetPrecision"`
	QuoteAsset                 string   `json:"quoteAsset"`
	QuotePrecision             int      `json:"quotePrecision"`
	QuoteAssetPrecision        int      `json:"quoteAssetPrecision"`
	BaseCommissionPrecision    int      `json:"baseCommissionPrecision"`
	QuoteCommissionPrecision   int      `json:"quoteCommissionPrecision"`
	Filters                    []Filter `json:"filters"`
	IcebergAllowed             bool     `json:"icebergAllowed"`
	IsMarginTradingAllowed     bool     `json:"isMarginTradingAllowed"`
	IsSpotTradingAllowed       bool     `json:"isSpotTradingAllowed"`
	OcoAllowed                 bool     `json:"ocoAllowed"`
	QuoteOrderQtyMarketAllowed bool     `json:"quoteOrderQtyMarketAllowed"`
	OrderTypes                 []string `json:"orderTypes"`
}

func (TradeSymbol) GetBaseStep 

func (ts TradeSymbol) GetBaseStep() float64

func (TradeSymbol) GetBaseStepN 

func (ts TradeSymbol) GetBaseStepN() int

func (TradeSymbol) GetMinBase 

func (ts TradeSymbol) GetMinBase() float64

func (TradeSymbol) GetMinPrice 

func (ts TradeSymbol) GetMinPrice() float64

func (TradeSymbol) GetMinQuote 

func (ts TradeSymbol) GetMinQuote() float64

func (TradeSymbol) GetPriceStep 

func (ts TradeSymbol) GetPriceStep() float64

type Wallet 

type Wallet struct {
	// contains filtered or unexported fields
}

func NewWallet 

func NewWallet(c *APIConfig) *Wallet

func (*Wallet) GetAccount 

func (w *Wallet) GetAccount() (*Account, error)

func (*Wallet) GetDepositHistory 

func (w *Wallet) GetDepositHistory(currency *Currency) ([]DepositWithdrawHistory, error)

func (*Wallet) GetWithDrawHistory 

func (w *Wallet) GetWithDrawHistory(currency *Currency) ([]DepositWithdrawHistory, error)

func (*Wallet) Transfer 

func (w *Wallet) Transfer(param TransferParameter) error

func (*Wallet) Withdrawal 

func (w *Wallet) Withdrawal(param WithdrawParameter) (withdrawId string, err error)

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.