@sifchain/gtk-api

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.

Installation

To install the @sifchain/gtk-api package, use the following command:

yarn add @sifchain/gtk-api

OR

npm install @sifchain/gtk-api

Sample Repo

Clone sample repo to use the API without having to create any boilerplate

Usage

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();

API Methods

APIClientWrapper.create

Factory method to create an instance of APIClientWrapper.

Parameters:

• wallet (DirectSecp256k1HdWallet): The wallet instance for signing transactions.
• network (NetworkEnv): The network environment to connect to.

Returns:

A promise that resolves to an APIClientWrapper instance.

Example:

const wallet = await DirectSecp256k1HdWallet.fromMnemonic("your-mnemonic");
const client = await APIClientWrapper.create(wallet, "mainnet");

placeOrder

Places a new order request and returns the transaction hash of the order request.

Parameters:

• 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.

Returns:

A promise that resolves to the transaction response or null if failed.

Example:

const response = await client.placeOrder(
  "btc",
  100,
  "uusdc",
  TradeDirectionEnum.LONG,
  2,
  50,
  150,
  null
);
console.log(response);

closeOrder

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.

Parameters:

• tradeId (number): The ID of the trade to close.

Returns:

A promise that resolves to the transaction response or null if failed.

Example:

const closedTrade = await client.closeOrder(1615);
console.log("Close Order:", closedTrade);

cancelOrder

Cancels an existing order for an existing trade from the same account.

Parameters:

• tradeId (number): The ID of the trade to cancel.

Returns:

A promise that resolves to the transaction response or null if failed.

Example:

const cancelledTrade = await client.cancelOrder(1615);
console.log("Cancel Order:", cancelledTrade);

getCurrentInterestRate

Retrieves the current interest rate for a given token.

Parameters:

• targetTokenType (string): The type of the target token.

Returns:

A promise that resolves to the current interest rate.

Example:

const interestRate = await client.getCurrentInterestRate("btc");
console.log("Current Interest Rate:", interestRate);

getTrades

Retrieves a list of trades. If both are undefined, returns all trades for your address.

Parameters:

• 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.

Returns:

A promise that resolves to an array of trades.

Example:

const trades = await client.getTrades(
  TradeDirectionEnum.LONG,
  TradeStatusEnum.ACTIVE
);
console.log("Get Trades:", trades);

getTrade

Retrieves a specific trade by its ID.

Parameters:

• tradeId (number): The ID of the trade to retrieve.

Returns:

A promise that resolves to the trade or null if not found.

Example:

const tradeDetails = await client.getTrade(123);
console.log("Get Trade:", tradeDetails);

getTopMatch

Retrieves the top match amount for a given collateral type in USD if it exists

Parameters:

• collateralType (string): The type of the collateral.
• collateralAmount (number): The amount of collateral that are looking to trade against

Returns:

A promise that resolves to the top match greater than or equal to the collateral amount or null if not found.

Example:

const topMatch = await client.getTopMatch("uusdc", 10);
console.log("Top Match:", topMatch);

getPnl

Retrieves the profit and loss (PnL) for a given type grouped by collateralType

Parameters:

• type (string): The type of the PnL (REALIZED, UNREALIZED, OVERALL).

Returns:

A promise that resolves to the PnL value grouped by collateralType

Example:

const pnl = await client.getPnl(PnlTypeEnum.REALIZED);
console.log("PnL:", pnl);

Full Example

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);