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 and .
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 for how to create new limit orders to trade DeSo Tokens.
Endpoint implementation in .
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.
{
"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"
},
]
}
{
"error": "..." // Error message
}
{
"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.
Request Body
Name
Type
Description
TransactorPublicKeyBase58CheckOrUsername*
string
Public key or username of the user whose open orders we want to retrieve.
{
"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
},
]
}
