CLI Reference
Create a market for trading assets.
Usage
create-market [base-denom] [quote-denom]
Argument | Description |
base-denom | denom of the base coin for the market |
quote-denom | denom of the quote coin for the market |
Example
# Create a pool
crescentd tx exchange create-market uatom uusd \
--chain-id localnet \
--from alice
#
# Tips
#
# You can query markets using the following command
crescentd q exchange markets -o json | jq
Place a limit order to markets. This order will be placed in sequential matching stage.
For buy orders, it allows orders up to 10% above the current price, and for sell orders, it allows orders up to 10% below the current price. This is to prevent users from incurring large financial losses due to simple mistakes.
Usage
place-limit-order [market-id] [is-buy] [price] [quantity] [lifespan]
Argument | Description |
market-id | market id |
is-buy | if this is true, the order is placed to buy base coin |
price | order price; the exchange ratio is the amount of quote coin over the amount of base coin |
quantity | amount of base coin that the orderer is willing to buy or sell |
lifespan | duration that the order lives until it is expired |
Example
# Place a limit order
crescentd tx exchange place-limit-order 1 true 15 100000 1h \
--chain-id localnet \
--from alice
#
# Tips
#
# You can query orders by using the following command
# Query all orders
crescentd q exchange orders -o json | jq
# Query all orders in particular market
crescentd q exchange orders --makret-id 1 -o json | jq
# Query all orders of particular orderer
crescentd q exchange orders --orderer cre1zaavvzxez0elundtn32qnk9lkm8kmcszxclz6p -o json | jq
Place a batch limit order. Batch orders are matched prior to normal orders in a batch matching stage.
For buy orders, it allows orders up to 10% above the current price, and for sell orders, it allows orders up to 10% below the current price. This is to prevent users from incurring large financial losses due to simple mistakes.
Usage
place-batch-limit-order [market-id] [is-buy] [price] [quantity] [lifespan]
Argument | Description |
market-id | market id |
is-buy | if this is true, the order is placed to buy base coin |
price | order price; the exchange ratio is the amount of quote coin over the amount of base coin |
quantity | amount of base coin that the orderer is willing to buy or sell |
lifespan | duration that the order lives until it is expired |
Example
# Place a batch limit order
crescentd tx exchange place-batch-limit-order 1 true 15 100000 1h \
--chain-id localnet \
--from alice
#
# Tips
#
# You can query orders by using the following command
# Query all orders
crescentd q exchange orders -o json | jq
# Query all orders in particular market
crescentd q exchange orders --makret-id 1 -o json | jq
# Query all orders of particular orderer
crescentd q exchange orders --orderer cre1zaavvzxez0elundtn32qnk9lkm8kmcszxclz6p -o json | jq
Place a market maker limit order.
For buy orders, it allows orders up to 10% above the current price, and for sell orders, it allows orders up to 10% below the current price. This is to prevent users from incurring large financial losses due to simple mistakes.
Usage
place-mm-limit-order [market-id] [is-buy] [price] [quantity] [lifespan]
Argument | Description |
market-id | market id |
is-buy | if this is true, the order is placed to buy base coin |
price | order price; the exchange ratio is the amount of quote coin over the amount of base coin |
quantity | amount of base coin that the orderer is willing to buy or sell |
lifespan | duration that the order lives until it is expired |
Example
# Place a market maker limit order
crescentd tx exchange place-mm-limit-order 1 true 15 100000 1h \
--chain-id localnet \
--from alice
#
# Tips
#
# You can query orders by using the following command
# Query all orders
crescentd q exchange orders -o json | jq
# Query all orders in particular market
crescentd q exchange orders --makret-id 1 -o json | jq
# Query all orders of particular orderer
crescentd q exchange orders --orderer cre1zaavvzxez0elundtn32qnk9lkm8kmcszxclz6p -o json | jq
Place a market maker batch limit order. Batch orders are matched prior to normal orders in a batch matching stage.
For buy orders, it allows orders up to 10% above the current price, and for sell orders, it allows orders up to 10% below the current price. This is to prevent users from incurring large financial losses due to simple mistakes.
Usage
place-mm-batch-limit-order [market-id] [is-buy] [price] [quantity] [lifespan]
Argument | Description |
market-id | market id |
is-buy | if this is true, the order is placed to buy base coin |
price | order price; the exchange ratio is the amount of quote coin over the amount of base coin |
quantity | amount of base coin that the orderer is willing to buy or sell |
lifespan | duration that the order lives until it is expired |
Example
# Place a market maker batch limit order
crescentd tx exchange place-mm-batch-limit-order 1 true 15 100000 1h \
--chain-id localnet \
--from alice
#
# Tips
#
# You can query orders by using the following command
# Query all orders
crescentd q exchange orders -o json | jq
# Query all orders in particular market
crescentd q exchange orders --makret-id 1 -o json | jq
# Query all orders of particular orderer
crescentd q exchange orders --orderer cre1zaavvzxez0elundtn32qnk9lkm8kmcszxclz6p -o json | jq
Place a market order.
Usage
place-market-order [market-id] [is-buy] [quantity]
Argument | Description |
market-id | market id |
is-buy | if this is true, the order is placed to buy base coin |
quantity | amount of base coin that the orderer is willing to buy or sell |
Example
# Place a market order
crescentd tx exchange place-market-order 1 false 100000 \
--chain-id localnet \
--from alice
Cancel an existing order.
Usage
cancel-order [order-id]
Argument | Description |
order-id | order id |
Example
# Place a market order
crescentd tx exchange cancel-order 1 \
--chain-id localnet \
--from alice
Cancel all orders in a market placed by the sender
Usage
cancel-all-orders [market-id]
Argument | Description |
market-id | market id |
Example
# Place a market order
crescentd tx exchange cancel-all-orders 1 \
--chain-id localnet \
--from alice
Swap with exact input amount.
User need to specify swap routes from input to output. If the result of the swap falls short of user's desired output, the request will be reverted.
Usage
swap-exact-amount-in [routes] [input] [min-output]
Argument | Description |
routes | sequential swap routes |
input | input token denom and amount |
min-output | The denom and minimum amount of the user's desired output token |
Example
# Place a market order
crescentd tx exchange swap-exact-amount-in 1,2,3 1000000uusd 98000uatom \
--chain-id localnet \
--from alice
Query the current exchange parameters information
Usage
params
Example
crescentd q exchange params -o json | jq
Query for all markets
Usage
markets
Example
crescentd q exchange markets -o json | jq
Query details for the particular market
Usage
market [market-id]
Example
crescentd q exchange market 1 -o json | jq
Query for all orders
Usage
orders
Example
# Query all orders
crescentd q exchange orders -o json | jq
# Query all orders in particular market
crescentd q exchange orders --makret-id 1 -o json | jq
# Query all orders of particular orderer
crescentd q exchange orders --orderer cre1zaavvzxez0elundtn32qnk9lkm8kmcszxclz6p -o json | jq
Query details for the particular order
Usage
order [order-id]
Example
crescentd q exchange order 1 -o json | jq
Query for the route that can be swapped at the best price given the input token denom and volume, and the denom of the output token.
Usage
best-swap-exact-amount-in-routes [input] [output-denom]
Example
crescentd q exchange best-swap-exact-amount-in-routes 1000000uusd uatom -o json | jq
Query orderbook of particular market from exisiting orders
Usage
order-book [market-id]
Example
crescentd q exchange order-book 1 -o json | jq
Last modified 24d ago