DeSo Tokens Endpoints

Description of endpoints used for creating and on-chain trading of DeSo Tokens.

Note: "DAO Coins" are now referred to as "DeSo Tokens" in all public-facing documentation, but the code and API have not yet been updated to reflect this change. For endpoints to check ownership of DeSo Tokens, see Get Hodlers For Public Key and Is Hodling Public Key.

Gets All Open Orders on Order Book for a DeSo Token (DAO Coin) Market

POST /api/v0/get-dao-coin-limit-orders

There are two types of markets where DeSo Tokens can be traded on the on-chain order book exchange: 1) markets where a DeSo Token is traded for $DESO, and 2) markets where a DeSo Token is traded for another DeSo Token.

This endpoint returns all open orders given two coins that can be traded against each other. At least one of the two coins must be a DeSo Token.

See #create-dao-coin-limit-order for how to create new limit orders to trade DeSo Tokens.

Endpoint implementation in backend.

Request Body

Name	Type	Description
DAOCoin2CreatorPublicKeyBase58CheckOrUsername2*	string	Public key or username of the creator of the DAO, whose DeSo Token makes up the second side of the market. An empty string here represents $DESO as the second side of the market.
DAOCoin1CreatorPublicKeyBase58CheckOrUsername*	string	Public key or username of the creator of the Token, whose DeSo Token makes up one side of a market. An empty string here represents $DESO as one side of the market.

200: OK Successfully retrieved all open orders for a coin pair

Sample Response

{
   "Orders":[
      {
         "TransactorPublicKeyBase58Check":"tBCKVERmG9nZpHTk2AVPqknWc1Mw9HHAnqrTpW1RnXpXMQ4PsQgnmV", // public key of the creator of this order
         "BuyingDAOCoinCreatorPublicKeyBase58Check":"tBCKVERmG9nZpHTk2AVPqknWc1Mw9HHAnqrTpW1RnXpXMQ4PsQgnmV", // public key of the creator of a DAO coin
         "SellingDAOCoinCreatorPublicKeyBase58Check":"", // empty string represents $DESO
         "ExchangeRateCoinsToSellPerCoinToBuy":3.1,
         "QuantityToFill":5.2, // Denominated in number of coins (not nanos) and can have fractional values
         "OperationType":"BID",
         "OrderID":"4671f48ec7a0da7d769219efdf1689ed19cb3527ae3c1a9669dd5539c9674426" // unique identifier for this order, also equivalent to the transaction hex hash that created the order
      },
      {
         "TransactorPublicKeyBase58Check":"tBCKVERmG9nZpHTk2AVPqknWc1Mw9HHAnqrTpW1RnXpXMQ4PsQgnmV",
         "BuyingDAOCoinCreatorPublicKeyBase58Check":"tBCKVERmG9nZpHTk2AVPqknWc1Mw9HHAnqrTpW1RnXpXMQ4PsQgnmV",
         "SellingDAOCoinCreatorPublicKeyBase58Check":"",
         "ExchangeRateCoinsToSellPerCoinToBuy":0.333,
         "QuantityToFill":1.2,
         "OperationType":"BID",
         "OrderID":"a6c5ab24cde484d91a32b0f977eac2439614192311c7452d8477e4b9a821fc1c"
      },
      
   ]
}

400: Bad Request

{
    "error": "..." // Error message
}

500: Internal Server Error

{
    "error": "..." // Error message
}

Gets All Open Limit Orders Created by a Transactor

POST /api/v0/get-transactor-dao-coin-limit-orders

This endpoint returns all open orders that were created by a given transactor on the DeSo Tokens on-chain order book exchange.

Endpoint implementation in backend.

Request Body

Name	Type	Description
TransactorPublicKeyBase58CheckOrUsername*	string	Public key or username of the user whose open orders we want to retrieve.

200: OK Successfully retrieved all open orders for the transactor

Sample Response

{
   "Orders":[
      {
         "TransactorPublicKeyBase58Check":"tBCKVERmG9nZpHTk2AVPqknWc1Mw9HHAnqrTpW1RnXpXMQ4PsQgnmV", // public key of the creator of this order
         "BuyingDAOCoinCreatorPublicKeyBase58Check":"tBCKVERmG9nZpHTk2AVPqknWc1Mw9HHAnqrTpW1RnXpXMQ4PsQgnmV", // public key of the creator of a DAO coin
         "SellingDAOCoinCreatorPublicKeyBase58Check":"", // empty string represents $DESO
         "ExchangeRateCoinsToSellPerCoinToBuy":3.98734,
         "QuantityToFill":5.123457, // Denominated in number of coins (not nanos) and can have fractional values
         "OperationType":"BID",
         "OrderID":"4671f48ec7a0da7d769219efdf1689ed19cb3527ae3c1a9669dd5539c9674426" // unique identifier for this order, also equivalent to the transaction hex hash that created the order
      },
   ]
}

400: Bad Request

{
    "error": "..." // Error message
}

500: Internal Server Error

{
    "error": "..." // Error message
}