List Secondary Markets
Returns every token that has at least one open secondary-market listing, one row per token, cheapest first (by the lowest listing price). Each row sums the token's open listings and carries the token itself. To see the listings behind a row, use List Token Listings; for one token's row, use Get Token Secondary Market Summary.
Get Token Secondary Market Summary
Returns one token's secondary-market summary: the quantity on offer and the price range across its open listings, plus the token itself. It is a single object, not a page. The listings behind it are at List Token Listings. A token with no open listing is refused with 11001, even when the token exists.
List Token Listings
Returns the open secondary-market listings of one token, newest first, one row per listing. These are the offers behind Get Token Secondary Market Summary. Take a listing's deal_id and quantity to quote or buy it; a listing is bought whole.
List User Secondary Market Groups
Returns the user's secondary-market listings collapsed to one row per token, newest token first. total_quantity sums the quantity of every listing the user made on the token that is not still awaiting chain confirmation (open, completed and canceled listings alike). For the listings themselves, use List User Token Listings.
List User Token Listings
Returns the user's own secondary-market listings of one token, newest first, one row per listing. Listings still awaiting chain confirmation are not listed; open, completed and canceled ones are. Take the deal_id of an open listing (status = 0) to delist it.
Sell On Secondary Market
Lists quantity tokens from one of the user's wallets on the secondary market at unitprice per token. The call is **asynchronous**: it records a user transaction (type = 3, sell on secondary market) and answers with its transactionid. Poll Get User Transaction until status is 3 (done) or 4 (error); the listing shows up in List User Token Listings and List Token Listings only once it is confirmed on chain. A listing is later bought whole.
Delist From Secondary Market
Takes one of the user's own open listings off the secondary market. The listing is named by its dealid in the path (take it from List User Token Listings); there is no request body. The delist is signed by the wallet recorded on the listing, so no walletid is sent.