Command-line Usage

Create and broadcast an order message

• –source = the source address
• –get-quantity = the quantity of GET_ASSET that the source would like to receive
• –get-asset = the asset that you would like to buy
• –give-quantity = the quantity of GIVE_ASSET that the source is willing to give
• –give-asset = the asset that the source would like to sell
• –expiration = the number of blocks for which the order should be valid
• –fee-fraction-required = the miners’ fee required for an order to match
• –fee = the exact GASP fee to be paid to miners

To make a trade that involves GASP, the order function requires an extra parameter, and a second step (gasppay) is needed. If [address_1] is trading [give_quantity_1] of GASP in exchange for [get_quantity_1] of [asset].

order --source=[address_1] --give-asset=GASP --give-quantity=[give_quantity_1] \
--get-asset=[asset] --get-quantity=[get_quantity_1] --fee-provided=[fee_provided] \
--expiration=[expiration_1]

If [address_2] is trading [give_quantity_2] of [asset] for [get_quantity_2] of GASP:

order --source=[address_2] --give-asset=[asset] --give-quantity=[give_quantity_2] \
--get-asset=GASP --get-quantity=[get_quantity_2] --fee-required=[fee_required] \
--expiration=[expiration_2]

[asset] is debited immediately from [address_2] and is held in the Aspire protocol’s escrow. [address_1] then must complete the trade using gasppay before 10 blocks have passed (or the lesser of the two expiration periods has passed, if the latter is less than 10 blocks from the time of match). After the payment transaction has received enough confirmations, the asset will be automatically released to the GASP seller by the Aspire protocol.

The command for a gasppay is:

gasppay --source=[source_address] -–order-match-id=[txhash1]+[txhash2]


order --source=mtQheFaSfWELRB2MyMBaiWjdDm6ux9Ezns --get-quantity=10 \
--get-asset=GASP --give-quantity=20 --give-asset=ASP --expiration=10 \
--fee_required=0.0002


order --source=mtQheFaSfWELRB2MyMBaiWjdDm6ux9Ezns --get-quantity=10 \
--get-asset=BBBC --give-quantity=20 --give-asset=GASP --expiration=10 \
--fee_provided=0.0002

For orders that do not involve GASP buy or sell, GASPpay is not required. For Sally to receive [get_quantity_1] of [get_asset_1] in exchange for [give_quantity_1] of [give_asset_1], the command is the following:

order --source=[sallys_address] --give-asset=[give_asset_1] \
--give-quantity=[give_quantity_1] --get-asset=[get_asset_1] \
--get-quantity=[get_quantity_1] --expiration=expiration_1

In order for Alice to receive [get_quantity_2] of Sally’s [give_asset_1] in exchange for [give_quantity_2] of [get_asset_2], the command is:

order --source=[alices_address] --give-asset=[give_asset_2] \
--give-quantity=[give_quantity_2] --get-asset=[get_asset_2] \
--get-quantity=[get_quantity_2] --expiration=expiration_2

For example, Alice wants to sell 20 BBBC for 10 ASP within (expiration) 720 gAsp blocks (approximately 720 * 2 min = 24 hours):

order --source=mtQheFaSfWELRB2MyMBaiWjdDm6ux9Ezns --get-quantity=10 \
--get-asset=ASP --give-quantity=20 --give-asset=BBBC --expiration=720

Note that orders can be partially matched.