Assine canais públicos OKX v5 (tickers, candles, trades, books) e canais privados autenticados (account, positions, orders) com assinatura HMAC.
Resposta rápida: TsgcWSAPI_OKX é o componente do sgcWebSockets que conecta aplicativos Delphi e C++ Builder à OKX. Ele assina os canais WebSocket públicos do OKX v5 e, após um login assinado por HMAC, os canais autenticados de account, position e order.
Cliente WebSocket OKX v5 — tickers, candles, trades, books, instruments e streams privados assinados para account, positions e orders.
TsgcWSAPI_OKX
Windows, macOS, Linux, iOS, Android
Standard / Professional / Enterprise
Vincule a um TsgcWebSocketClient, defina OKX.ApiKey / OKX.ApiSecret / OKX.Passphrase para canais assinados e inscreva-se em streams públicos ou privados.
uses
sgcWebSocket, sgcWebSocket_API_OKX;
var
WSClient: TsgcWebSocketClient;
OKX: TsgcWSAPI_OKX;
begin
WSClient := TsgcWebSocketClient.Create(nil);
OKX := TsgcWSAPI_OKX.Create(nil);
OKX.Client := WSClient;
OKX.OKX.ApiKey := 'your-api-key';
OKX.OKX.ApiSecret := 'your-api-secret';
OKX.OKX.Passphrase := 'your-passphrase';
WSClient.Active := True;
OKX.SubscribeTickers('BTC-USDT');
OKX.SubscribeCandle('BTC-USDT', oxi5m);
OKX.SubscribeBooks('BTC-USDT');
end;// uses: sgcWebSocket, sgcWebSocket_API_OKX
TsgcWebSocketClient *WSClient = new TsgcWebSocketClient(this);
TsgcWSAPI_OKX *OKX = new TsgcWSAPI_OKX(this);
OKX->Client = WSClient;
WSClient->Active = true;
OKX->SubscribeTickers("BTC-USDT");
OKX->SubscribeCandle("BTC-USDT", oxi5m);Streams públicos de mercado, streams privados assinados e um roteador tipado que entrega cada canal como seu próprio evento.
SubscribeTickers, SubscribeCandle, SubscribeTrades, SubscribeBooks, SubscribeBooks5, SubscribeBooksL2-TBT, SubscribeInstruments mapeiam todos os canais públicos OKX v5.
A OKX exige um login por conexão com HMAC sobre timestamp+method+requestPath. O componente gerencia o login e o relogin ao reconectar.
SubscribeAccount, SubscribePositions, SubscribeOrders, SubscribeBalanceAndPosition abrem canais autenticados após o login.
A OKX expõe verbos de trading (place-order, cancel-order, amend-order, mass-cancel) pelo mesmo WebSocket autenticado — métodos tipados cobrem cada um.
O demo trading da OKX usa o endpoint wspap.okx.com com o cabeçalho x-simulated-trading; alterne OKX.DemoTrading para trocar de endpoint.
A OKX exige um "ping" de texto a cada 25-30 segundos; o componente os envia automaticamente e redefine o temporizador a cada frame recebido.
Fontes autoritativas das APIs que este componente implementa.
Acesse direto a referência do componente, baixe o projeto de demonstração pronto para rodar e baixe a versão de avaliação.
| Ajuda online — API_OKX Referência completa de propriedades, métodos e eventos deste componente. | Abrir | |
| Projeto de demonstração — Demos\05.Crypto\12.OKX Projeto de exemplo pronto para rodar. Acompanha o pacote sgcWebSockets — baixe a versão de avaliação abaixo. | Abrir | |
| Documento técnico (PDF) Recursos, início rápido, exemplos de código para Delphi & C++ Builder e referências de fontes primárias — somente deste componente. | Abrir | |
| Manual do usuário (PDF) Manual abrangente cobrindo todos os componentes da biblioteca. | Abrir |
Dúvidas comuns sobre o componente da API OKX para Delphi e C++ Builder.
TsgcWebSocketClient e um TsgcWSAPI_OKX no seu formulário, atribua o client à propriedade Client do componente da API, defina OKX.ApiKey, OKX.ApiSecret e OKX.Passphrase se você precisar de canais privados e, em seguida, defina WSClient.Active := True e chame métodos de subscrição como SubscribeTickers ou SubscribeBooks.TsgcWSAPI_OKX foca na API WebSocket do OKX v5. Ele abrange os canais públicos de mercado, os canais privados assinados (account, positions, orders) e os verbos de trading (place-order, cancel-order, amend-order, mass-cancel) que a OKX expõe sobre a mesma conexão WebSocket autenticada.OKX.ApiKey, OKX.ApiSecret e OKX.Passphrase e o componente realiza o login HMAC por conexão (e refaz o login na reconexão).