Files
gocryptotrader/exchanges/exmo/exmo.go
Adrian Gallagher 7ebc392532 build/linters: Bump Go to v1.25 and golangci-lint to v2.4.0 (#2005)
* build/linters: Bump Go to v1.25 and golangci-lint to v2.4.0

* refactor: Update TODO comments for net.Listen and net.DialTimeout; improve variable naming in websocket and exchange methods

* refactor: Rename massageMissingData to backfillMissingData for clarity and update references in RSI and MFI calculations

* fix: Correct typo in TODO comment for net.Listen in RPC server
2025-08-20 11:55:15 +10:00

517 lines
16 KiB
Go

package exmo
import (
"context"
"encoding/hex"
"fmt"
"net/http"
"net/url"
"strconv"
"strings"
"time"
"github.com/thrasher-corp/gocryptotrader/common"
"github.com/thrasher-corp/gocryptotrader/common/crypto"
"github.com/thrasher-corp/gocryptotrader/currency"
exchange "github.com/thrasher-corp/gocryptotrader/exchanges"
"github.com/thrasher-corp/gocryptotrader/exchanges/nonce"
"github.com/thrasher-corp/gocryptotrader/exchanges/request"
)
const (
exmoAPIURL = "https://api.exmo.com"
exmoAPIVersion = "1"
tradeBaseURL = "https://exmo.com/trade/pro/"
exmoTrades = "trades"
exmoOrderbook = "order_book"
exmoTicker = "ticker"
exmoPairSettings = "pair_settings"
exmoCurrency = "currency"
exmoUserInfo = "user_info"
exmoOrderCreate = "order_create"
exmoOrderCancel = "order_cancel"
exmoOpenOrders = "user_open_orders"
exmoUserTrades = "user_trades"
exmoCancelledOrders = "user_cancelled_orders"
exmoOrderTrades = "order_trades"
exmoRequiredAmount = "required_amount"
exmoDepositAddress = "deposit_address"
exmoWithdrawCrypt = "withdraw_crypt"
exmoGetWithdrawTXID = "withdraw_get_txid"
exmoExcodeCreate = "excode_create"
exmoExcodeLoad = "excode_load"
exmoWalletHistory = "wallet_history"
exmoCryptoPaymentProviderList = "payments/providers/crypto/list"
// Rate limit: 180 per/minute
exmoRateInterval = time.Minute
exmoRequestRate = 180
)
// Exchange implements exchange.IBotExchange and contains additional specific api methods for interacting with EXMO
type Exchange struct {
exchange.Base
}
// GetTrades returns the trades for a symbol or symbols
func (e *Exchange) GetTrades(ctx context.Context, symbol string) (map[string][]Trades, error) {
v := url.Values{}
v.Set("pair", symbol)
result := make(map[string][]Trades)
urlPath := fmt.Sprintf("/v%s/%s", exmoAPIVersion, exmoTrades)
return result, e.SendHTTPRequest(ctx, exchange.RestSpot, common.EncodeURLValues(urlPath, v), &result)
}
// GetOrderbook returns the orderbook for a symbol or symbols
func (e *Exchange) GetOrderbook(ctx context.Context, symbol string) (map[string]Orderbook, error) {
v := url.Values{}
v.Set("pair", symbol)
result := make(map[string]Orderbook)
urlPath := fmt.Sprintf("/v%s/%s", exmoAPIVersion, exmoOrderbook)
return result, e.SendHTTPRequest(ctx, exchange.RestSpot, common.EncodeURLValues(urlPath, v), &result)
}
// GetTicker returns the ticker for a symbol or symbols
func (e *Exchange) GetTicker(ctx context.Context) (map[string]Ticker, error) {
v := url.Values{}
result := make(map[string]Ticker)
urlPath := fmt.Sprintf("/v%s/%s", exmoAPIVersion, exmoTicker)
return result, e.SendHTTPRequest(ctx, exchange.RestSpot, common.EncodeURLValues(urlPath, v), &result)
}
// GetPairSettings returns the pair settings for a symbol or symbols
func (e *Exchange) GetPairSettings(ctx context.Context) (map[string]PairSettings, error) {
result := make(map[string]PairSettings)
urlPath := fmt.Sprintf("/v%s/%s", exmoAPIVersion, exmoPairSettings)
return result, e.SendHTTPRequest(ctx, exchange.RestSpot, urlPath, &result)
}
// GetCurrency returns a list of currencies
func (e *Exchange) GetCurrency(ctx context.Context) ([]string, error) {
var result []string
urlPath := fmt.Sprintf("/v%s/%s", exmoAPIVersion, exmoCurrency)
return result, e.SendHTTPRequest(ctx, exchange.RestSpot, urlPath, &result)
}
// GetUserInfo returns the user info
func (e *Exchange) GetUserInfo(ctx context.Context) (UserInfo, error) {
var result UserInfo
return result, e.SendAuthenticatedHTTPRequest(ctx, exchange.RestSpot, http.MethodPost, exmoUserInfo, url.Values{}, &result)
}
// CreateOrder creates an order
// Params: pair, quantity, price and type
// Type can be buy, sell, market_buy, market_sell, market_buy_total and market_sell_total
func (e *Exchange) CreateOrder(ctx context.Context, pair, orderType string, price, amount float64) (int64, error) {
type response struct {
OrderID int64 `json:"order_id"`
Result bool `json:"result"`
Error string `json:"error"`
}
v := url.Values{}
v.Set("pair", pair)
v.Set("type", orderType)
v.Set("price", strconv.FormatFloat(price, 'f', -1, 64))
v.Set("quantity", strconv.FormatFloat(amount, 'f', -1, 64))
var resp response
return resp.OrderID, e.SendAuthenticatedHTTPRequest(ctx, exchange.RestSpot, http.MethodPost, exmoOrderCreate, v, &resp)
}
// CancelExistingOrder cancels an order by the orderID
func (e *Exchange) CancelExistingOrder(ctx context.Context, orderID int64) error {
v := url.Values{}
v.Set("order_id", strconv.FormatInt(orderID, 10))
type response struct {
Result bool `json:"result"`
Error string `json:"error"`
}
var resp response
return e.SendAuthenticatedHTTPRequest(ctx, exchange.RestSpot, http.MethodPost, exmoOrderCancel, v, &resp)
}
// GetOpenOrders returns the users open orders
func (e *Exchange) GetOpenOrders(ctx context.Context) (map[string]OpenOrders, error) {
result := make(map[string]OpenOrders)
return result, e.SendAuthenticatedHTTPRequest(ctx, exchange.RestSpot, http.MethodPost, exmoOpenOrders, url.Values{}, &result)
}
// GetUserTrades returns the user trades
func (e *Exchange) GetUserTrades(ctx context.Context, pair, offset, limit string) (map[string][]UserTrades, error) {
result := make(map[string][]UserTrades)
v := url.Values{}
v.Set("pair", pair)
if offset != "" {
v.Set("offset", offset)
}
if limit != "" {
v.Set("limit", limit)
}
return result, e.SendAuthenticatedHTTPRequest(ctx, exchange.RestSpot, http.MethodPost, exmoUserTrades, v, &result)
}
// GetCancelledOrders returns a list of cancelled orders
func (e *Exchange) GetCancelledOrders(ctx context.Context, offset, limit string) ([]CancelledOrder, error) {
var result []CancelledOrder
v := url.Values{}
if offset != "" {
v.Set("offset", offset)
}
if limit != "" {
v.Set("limit", limit)
}
return result, e.SendAuthenticatedHTTPRequest(ctx, exchange.RestSpot, http.MethodPost, exmoCancelledOrders, v, &result)
}
// GetOrderTrades returns a history of order trade details for the specific orderID
func (e *Exchange) GetOrderTrades(ctx context.Context, orderID int64) (OrderTrades, error) {
var result OrderTrades
v := url.Values{}
v.Set("order_id", strconv.FormatInt(orderID, 10))
return result, e.SendAuthenticatedHTTPRequest(ctx, exchange.RestSpot, http.MethodPost, exmoOrderTrades, v, &result)
}
// GetRequiredAmount calculates the sum of buying a certain amount of currency
// for the particular currency pair
func (e *Exchange) GetRequiredAmount(ctx context.Context, pair string, amount float64) (RequiredAmount, error) {
v := url.Values{}
v.Set("pair", pair)
v.Set("quantity", strconv.FormatFloat(amount, 'f', -1, 64))
var result RequiredAmount
return result, e.SendAuthenticatedHTTPRequest(ctx, exchange.RestSpot, http.MethodPost, exmoRequiredAmount, v, &result)
}
// GetCryptoDepositAddress returns a list of addresses for cryptocurrency deposits
func (e *Exchange) GetCryptoDepositAddress(ctx context.Context) (map[string]string, error) {
var result any
err := e.SendAuthenticatedHTTPRequest(ctx, exchange.RestSpot, http.MethodPost, exmoDepositAddress, url.Values{}, &result)
if err != nil {
return nil, err
}
switch r := result.(type) {
case map[string]any:
mapString := make(map[string]string)
for key, value := range r {
if key == "error" {
if strVal, ok := value.(string); ok && strVal != "" {
return nil, fmt.Errorf("%w %s", request.ErrAuthRequestFailed, strVal)
}
}
mapString[key] = fmt.Sprintf("%v", value)
}
return mapString, nil
default:
return nil, fmt.Errorf("%w no addresses found, generate via website", request.ErrAuthRequestFailed)
}
}
// WithdrawCryptocurrency withdraws a cryptocurrency from the exchange to the desired address
// NOTE: This API function is available only after request to their tech support team
func (e *Exchange) WithdrawCryptocurrency(ctx context.Context, ccy, address, invoice, transport string, amount float64) (int64, error) {
type response struct {
TaskID int64 `json:"task_id,string"`
Result bool `json:"result"`
Error string `json:"error"`
Success int64 `json:"success"`
}
v := url.Values{}
v.Set("currency", ccy)
v.Set("address", address)
if invoice != "" {
v.Set("invoice", invoice)
}
if transport != "" {
v.Set("transport", strings.ToUpper(transport))
}
v.Set("amount", strconv.FormatFloat(amount, 'f', -1, 64))
var resp response
return resp.TaskID, e.SendAuthenticatedHTTPRequest(ctx, exchange.RestSpot, http.MethodPost, exmoWithdrawCrypt, v, &resp)
}
// GetWithdrawTXID gets the result of a withdrawal request
func (e *Exchange) GetWithdrawTXID(ctx context.Context, taskID int64) (string, error) {
type response struct {
Status bool `json:"status"`
TXID string `json:"txid"`
}
v := url.Values{}
v.Set("task_id", strconv.FormatInt(taskID, 10))
var result response
return result.TXID, e.SendAuthenticatedHTTPRequest(ctx, exchange.RestSpot, http.MethodPost, exmoGetWithdrawTXID, v, &result)
}
// ExcodeCreate creates an EXMO coupon
func (e *Exchange) ExcodeCreate(ctx context.Context, ccy string, amount float64) (ExcodeCreate, error) {
v := url.Values{}
v.Set("currency", ccy)
v.Set("amount", strconv.FormatFloat(amount, 'f', -1, 64))
var result ExcodeCreate
return result, e.SendAuthenticatedHTTPRequest(ctx, exchange.RestSpot, http.MethodPost, exmoExcodeCreate, v, &result)
}
// ExcodeLoad loads an EXMO coupon
func (e *Exchange) ExcodeLoad(ctx context.Context, excode string) (ExcodeLoad, error) {
v := url.Values{}
v.Set("code", excode)
var result ExcodeLoad
return result, e.SendAuthenticatedHTTPRequest(ctx, exchange.RestSpot, http.MethodPost, exmoExcodeLoad, v, &result)
}
// GetWalletHistory returns the users deposit/withdrawal history
func (e *Exchange) GetWalletHistory(ctx context.Context, date int64) (WalletHistory, error) {
v := url.Values{}
v.Set("date", strconv.FormatInt(date, 10))
var result WalletHistory
return result, e.SendAuthenticatedHTTPRequest(ctx, exchange.RestSpot, http.MethodPost, exmoWalletHistory, v, &result)
}
// SendHTTPRequest sends an unauthenticated HTTP request
func (e *Exchange) SendHTTPRequest(ctx context.Context, endpoint exchange.URL, path string, result any) error {
urlPath, err := e.API.Endpoints.GetURL(endpoint)
if err != nil {
return err
}
item := &request.Item{
Method: http.MethodGet,
Path: urlPath + path,
Result: result,
Verbose: e.Verbose,
HTTPDebugging: e.HTTPDebugging,
HTTPRecording: e.HTTPRecording,
}
return e.SendPayload(ctx, request.Unset, func() (*request.Item, error) {
return item, nil
}, request.UnauthenticatedRequest)
}
// SendAuthenticatedHTTPRequest sends an authenticated HTTP request
func (e *Exchange) SendAuthenticatedHTTPRequest(ctx context.Context, epath exchange.URL, method, endpoint string, vals url.Values, result any) error {
creds, err := e.GetCredentials(ctx)
if err != nil {
return err
}
urlPath, err := e.API.Endpoints.GetURL(epath)
if err != nil {
return err
}
path := urlPath + fmt.Sprintf("/v%s/%s", exmoAPIVersion, endpoint)
return e.SendPayload(ctx, request.Unset, func() (*request.Item, error) {
n := e.Requester.GetNonce(nonce.UnixNano).String()
vals.Set("nonce", n)
payload := vals.Encode()
hash, err := crypto.GetHMAC(crypto.HashSHA512, []byte(payload), []byte(creds.Secret))
if err != nil {
return nil, err
}
headers := make(map[string]string)
headers["Key"] = creds.Key
headers["Sign"] = hex.EncodeToString(hash)
headers["Content-Type"] = "application/x-www-form-urlencoded"
return &request.Item{
Method: method,
Path: path,
Headers: headers,
Body: strings.NewReader(payload),
Result: result,
NonceEnabled: true,
Verbose: e.Verbose,
HTTPDebugging: e.HTTPDebugging,
HTTPRecording: e.HTTPRecording,
}, nil
}, request.AuthenticatedRequest)
}
// GetFee returns an estimate of fee based on type of transaction
func (e *Exchange) GetFee(feeBuilder *exchange.FeeBuilder) (float64, error) {
var fee float64
switch feeBuilder.FeeType {
case exchange.CryptocurrencyTradeFee:
fee = calculateTradingFee(feeBuilder.PurchasePrice, feeBuilder.Amount)
case exchange.CryptocurrencyWithdrawalFee:
fee = getCryptocurrencyWithdrawalFee(feeBuilder.Pair.Base)
case exchange.InternationalBankWithdrawalFee:
fee = getInternationalBankWithdrawalFee(feeBuilder.FiatCurrency,
feeBuilder.Amount,
feeBuilder.BankTransactionType)
case exchange.InternationalBankDepositFee:
fee = getInternationalBankDepositFee(feeBuilder.FiatCurrency,
feeBuilder.Amount,
feeBuilder.BankTransactionType)
case exchange.OfflineTradeFee:
fee = calculateTradingFee(feeBuilder.PurchasePrice, feeBuilder.Amount)
}
if fee < 0 {
fee = 0
}
return fee, nil
}
func getCryptocurrencyWithdrawalFee(c currency.Code) float64 {
return WithdrawalFees[c]
}
func calculateTradingFee(price, amount float64) float64 {
return 0.002 * price * amount
}
func getInternationalBankWithdrawalFee(c currency.Code, amount float64, bankTransactionType exchange.InternationalBankTransactionType) float64 {
var fee float64
switch bankTransactionType {
case exchange.WireTransfer:
switch c {
case currency.RUB:
fee = 3200
case currency.PLN:
fee = 125
case currency.TRY:
fee = 0
}
case exchange.PerfectMoney:
switch c {
case currency.USD:
fee = 0.01 * amount
case currency.EUR:
fee = 0.0195 * amount
}
case exchange.Neteller:
switch c {
case currency.USD:
fee = 0.0195 * amount
case currency.EUR:
fee = 0.0195 * amount
}
case exchange.AdvCash:
switch c {
case currency.USD:
fee = 0.0295 * amount
case currency.EUR:
fee = 0.03 * amount
case currency.RUB:
fee = 0.0195 * amount
case currency.UAH:
fee = 0.0495 * amount
}
case exchange.Payeer:
switch c {
case currency.USD:
fee = 0.0395 * amount
case currency.EUR:
fee = 0.01 * amount
case currency.RUB:
fee = 0.0595 * amount
}
case exchange.Skrill:
switch c {
case currency.USD:
fee = 0.0145 * amount
case currency.EUR:
fee = 0.03 * amount
case currency.TRY:
fee = 0
}
case exchange.VisaMastercard:
switch c {
case currency.USD:
fee = 0.06 * amount
case currency.EUR:
fee = 0.06 * amount
case currency.PLN:
fee = 0.06 * amount
}
}
return fee
}
func getInternationalBankDepositFee(c currency.Code, amount float64, bankTransactionType exchange.InternationalBankTransactionType) float64 {
var fee float64
switch bankTransactionType {
case exchange.WireTransfer:
switch c {
case currency.RUB:
fee = 1600
case currency.PLN:
fee = 30
case currency.TRY:
fee = 0
}
case exchange.Neteller:
switch c {
case currency.USD:
fee = (0.035 * amount) + 0.29
case currency.EUR:
fee = (0.035 * amount) + 0.25
}
case exchange.AdvCash:
switch c {
case currency.USD:
fee = 0.0295 * amount
case currency.EUR:
fee = 0.01 * amount
case currency.RUB:
fee = 0.0495 * amount
case currency.UAH:
fee = 0.01 * amount
}
case exchange.Payeer:
switch c {
case currency.USD:
fee = 0.0195 * amount
case currency.EUR:
fee = 0.0295 * amount
case currency.RUB:
fee = 0.0345 * amount
}
case exchange.Skrill:
switch c {
case currency.USD:
fee = (0.0495 * amount) + 0.36
case currency.EUR:
fee = (0.0295 * amount) + 0.29
case currency.PLN:
fee = (0.035 * amount) + 1.21
case currency.TRY:
fee = 0
}
}
return fee
}
// GetCryptoPaymentProvidersList returns a map of all the supported cryptocurrency transfer settings
func (e *Exchange) GetCryptoPaymentProvidersList(ctx context.Context) (map[string][]CryptoPaymentProvider, error) {
var result map[string][]CryptoPaymentProvider
path := "/v" + exmoAPIVersion + "/" + exmoCryptoPaymentProviderList
return result, e.SendHTTPRequest(ctx, exchange.RestSpot, path, &result)
}