The @sifchain/gtk-api package provides a wrapper for the internal API client to manage and execute trade operations. This README will guide you through the installation, usage, and API methods available in the package.
To install the @sifchain/gtk-api package, use the following command:
yarn add @sifchain/gtk-api
OR
npm install @sifchain/gtk-api
Clone sample repo to use the API without having to create any boilerplate
Example Usage of APIClientWrapper The following example demonstrates how to use the APIClientWrapper to interact with the API. Note you will need to be on VPN if you are NORAM based and that currently only mainnet network is configured for API usage.
import { DirectSecp256k1HdWallet } from "@cosmjs/proto-signing";
import { APIClientWrapper } from "@sifchain/gtk-api";
async function main() {
const wallet = await DirectSecp256k1HdWallet.fromMnemonic("your-mnemonic");
const client = await APIClientWrapper.create(wallet, "mainnet");
// Place an order
const response = await client.placeOrder(
"btc",
100,
"uusdc",
TradeDirectionEnum.LONG,
2,
50,
150,
null
);
console.log(response);
}
main();Factory method to create an instance of APIClientWrapper.
- wallet (DirectSecp256k1HdWallet): The wallet instance for signing transactions.
- network (NetworkEnv): The network environment to connect to.
A promise that resolves to an APIClientWrapper instance.
const wallet = await DirectSecp256k1HdWallet.fromMnemonic("your-mnemonic");
const client = await APIClientWrapper.create(wallet, "mainnet");Places a new order request and returns the transaction hash of the order request.
- tokenType (string): The type of the token to trade.
- tokenAmount (number): The amount of the token to trade.
- targetTokenType (string): The type of the target token.
- tradeDirection (TradeDirectionEnum): The direction of the trade (LONG or SHORT).
- leverage (number): The leverage to use for the trade.
- stopLoss (number | null): The stop loss value, if any.
- takeProfit (number | null): The take profit value, if any.
- limitPrice (number | null): The limit price for the order, if any.
A promise that resolves to the transaction response or null if failed.
const response = await client.placeOrder(
"btc",
100,
"uusdc",
TradeDirectionEnum.LONG,
2,
50,
150,
null
);
console.log(response);Closes an existing order for an existing trade from the same account. Note there is a 15-minute minimum trade open window before a trade can be closed.
- tradeId (number): The ID of the trade to close.
A promise that resolves to the transaction response or null if failed.
const closedTrade = await client.closeOrder(1615);
console.log("Close Order:", closedTrade);Cancels an existing order for an existing trade from the same account.
- tradeId (number): The ID of the trade to cancel.
A promise that resolves to the transaction response or null if failed.
const cancelledTrade = await client.cancelOrder(1615);
console.log("Cancel Order:", cancelledTrade);Retrieves the current interest rate for a given token.
- targetTokenType (string): The type of the target token.
A promise that resolves to the current interest rate.
const interestRate = await client.getCurrentInterestRate("btc");
console.log("Current Interest Rate:", interestRate);Retrieves a list of trades. If both are undefined, returns all trades for your address.
- tradeType (TradeDirectionEnum | undefined): The type of the trade (LONG or SHORT), if any.
- status (TradeStatusEnum | undefined): The status of the trade (PENDING, ACTIVE, etc.), if any.
A promise that resolves to an array of trades.
const trades = await client.getTrades(
TradeDirectionEnum.LONG,
TradeStatusEnum.ACTIVE
);
console.log("Get Trades:", trades);Retrieves a specific trade by its ID.
- tradeId (number): The ID of the trade to retrieve.
A promise that resolves to the trade or null if not found.
const tradeDetails = await client.getTrade(123);
console.log("Get Trade:", tradeDetails);Retrieves the top match amount for a given collateral type in USD if it exists
- collateralType (string): The type of the collateral.
- collateralAmount (number): The amount of collateral that are looking to trade against
A promise that resolves to the top match greater than or equal to the collateral amount or null if not found.
const topMatch = await client.getTopMatch("uusdc", 10);
console.log("Top Match:", topMatch);Retrieves the profit and loss (PnL) for a given type grouped by collateralType
- type (string): The type of the PnL (REALIZED, UNREALIZED, OVERALL).
A promise that resolves to the PnL value grouped by collateralType
const pnl = await client.getPnl(PnlTypeEnum.REALIZED);
console.log("PnL:", pnl);Below is a full example demonstrating the use of all available methods in APIClientWrapper.
import {
APIClientWrapper,
PnlTypeEnum,
TradeDirectionEnum,
TradeStatusEnum,
} from "@sifchain/gtk-api";
import { DirectSecp256k1HdWallet } from "@cosmjs/proto-signing";
export async function main() {
const network = "mainnet";
const wallet: DirectSecp256k1HdWallet =
await DirectSecp256k1HdWallet.fromMnemonic("mnemonic", {
prefix: "sif",
});
const client = await APIClientWrapper.create(wallet, network);
console.log("APIClientWrapper:", client);
const trade = await client.placeOrder(
"uusdc",
0.00001,
"btc",
TradeDirectionEnum.LONG,
2,
45000,
70000,
null
);
console.log("Place Order:", trade);
const closedTrade = await client.closeOrder(1615);
console.log("Close Order:", closedTrade);
const cancelledTrade = await client.cancelOrder(1615);
console.log("Cancel Order:", cancelledTrade);
const interestRate = await client.getCurrentInterestRate("btc");
console.log("Current Interest Rate:", interestRate);
const trades = await client.getTrades(
TradeDirectionEnum.LONG,
TradeStatusEnum.ACTIVE
);
console.log("Get Trades:", trades);
const tradeDetails = await client.getTrade(123);
console.log("Get Trade:", tradeDetails);
const topMatch = await client.getTopMatch("uusdc");
console.log("Top Match:", topMatch);
const pnl = await client.getPnl(PnlTypeEnum.REALIZED);
console.log("PnL:", pnl);
}
main().catch(console.error);