Skip to content

Order

Place an order

Place an order on Reddio.

Parameters


*stark_key string

A unique key that identifies the user in the off-chain state


*amount string

The amount you wish to buy/sell.


*amount_buy string

The amount you wish to buy/sell, for buyer it's the token you wish to buy, for seller it's the price you want to sell.


*amount_sell string

The amount you wish to buy/sell, for buyer it's the currency you wish to give for the token.


*token_buy string

For buyer, it's token you wish to buy, for seller it's the amount currency you wish to sell.


*token_sell string

For seller, it's token you wish to sell, for buyer it's the amount currency you wish to give for the token.


*base_token string

For seller it's the currency used for selling the token.


*vault_id_buy string

For buyers, it’s the vault ID used to pay.


*vault_id_sell string

For sellers, it’s the vault ID used to sell.


*expiration_timestamp int64

Expiration timestamp.


*nonce int64

The nonce for account_id.


*signature struct

The signature for the transaction, can be calculated by https://github.com/reddio-com/red-py-sdk.


*account_id string

The account_id.


*direction int

The direction for transaction, 0 is for ASK, 1 is for BID.


*fee_info struct

The currency used for order.

jsx
POST /v1/order

Seller example

cURL Example

sh
curl https://api-dev.reddio.com/v1/order -H 'content-type: application/json' -d \
'{
   "amount":"1",
   "amount_buy":"1000",
   "amount_sell":"1",
   "stark_key":"0x38cae143fe6d2b8bdb7051f211744017d98f7e6a67e45a5dfc08759c119cf3c",
   "token_buy":"0x352f9ffd821a525051de2d71126113505a7b0a73d98dbc0ac0ff343cfbdef5e",
   "price":"1000",
   "token_sell":"0x400fcfa0889b788c49ecdbe90b494b4dc692532467466b88c1179779096a163",
   "quote_token":"0x400fcfa0889b788c49ecdbe90b494b4dc692532467466b88c1179779096a163",
   "base_token":"0x352f9ffd821a525051de2d71126113505a7b0a73d98dbc0ac0ff343cfbdef5e",
   "vault_id_buy":"21535787",
   "vault_id_sell":"21639066",
   "expiration_timestamp":4194303,
   "nonce":52,
   "signature":{
      "r":"0x54a0add087576b75244236dc2d53befdaacd5e5bb01dd988f7b34d7349844e7",
      "s":"0x38c262afd2a0132759cd3c7eb37c52107bf29aa0438a7832c5be7cdbc7a9849"
   },
   "account_id":"0x13b314ccfe334151abc7e1ab50c4c5d77f8941777d1616cb381d9d9b2273bdb",
   "direction":0,
   "fee_info":{
      "fee_limit":5,
      "token_id":"0x352f9ffd821a525051de2d71126113505a7b0a73d98dbc0ac0ff343cfbdef5e",
      "source_vault_id":21535787
   }
}'

Example response

json
{
	"status": "OK",
	"error": "",
	"error_code": 0,
	"data": {
		"sequence_id": 302120
	}
}

Buyer example

cURL Example

jsx
curl https://api-dev.reddio.com/v1/order -H 'content-type: application/json' -d \
'{
   "amount":"1",
   "amount_buy":"1",
   "amount_sell":"1000",
   "stark_key":"0x38cae143fe6d2b8bdb7051f211744017d98f7e6a67e45a5dfc08759c119cf3c",
   "token_buy":"0x400fcfa0889b788c49ecdbe90b494b4dc692532467466b88c1179779096a163",
   "price":"1000",
   "token_sell":"0x352f9ffd821a525051de2d71126113505a7b0a73d98dbc0ac0ff343cfbdef5e",
   "quote_token":"0x400fcfa0889b788c49ecdbe90b494b4dc692532467466b88c1179779096a163",
   "base_token":"0x352f9ffd821a525051de2d71126113505a7b0a73d98dbc0ac0ff343cfbdef5e",
   "vault_id_buy":"21648107",
   "vault_id_sell":"21433994",
   "expiration_timestamp":4194303,
   "nonce":52,
   "signature":{
      "r":"0x4d308e89375fb3d6eaea836aa6615f6e52a4842da3b2d2de73b53996da7e082",
      "s":"0x2d532e42c43756a179496245c124acf082418081f0b3f94522e9bc5fc0f914"
   },
   "account_id":"0x3d2161b60487fb223760e586efaf70004ddc018b53b8cdb39cb75ef4b4e25f7",
   "direction":1,
   "fee_info":{
      "fee_limit":5,
      "token_id":"0x352f9ffd821a525051de2d71126113505a7b0a73d98dbc0ac0ff343cfbdef5e",
      "source_vault_id":21433994
	}
}'

Example response

json
{
	"status": "OK",
	"error": "",
	"error_code": 0,
	"data": {
		"sequence_id": 302124
	}
}

List orders

List orders.

Parameters


limit string

Limit entries for query records.


page string

Page for records.


contract_address string

Contract address.


direction int

The direction for transaction, 0 is for ASK, 1 is for BID.


token_ids string

Comma seperated ids, e,g: 165,152.

jsx
GET /v1/orders

cURL Example

sh
curl -v https://api-dev.reddio.com/v1/orders?contract_address=0x941661bd1134dc7cc3d107bf006b8631f6e65ad5&token_ids=165,152 -H 'content-type: application/json'

Example response

json
{
  "status": "OK",
  "error": "",
  "error_code": 0,
  "data": {
    "list": [
      {
        "order_id": 302539,
        "stark_key": "0x74ee2029ebbb9051e165d6628a4389f8f4f46c76352b47b45336ea3c760c841",
        "price": "1000",
        "direction": 0,
        "amount": "1",
        "un_filled": "1",
        "symbol": {
          "base_token_asset_id": "0x352f9ffd821a525051de2d71126113505a7b0a73d98dbc0ac0ff343cfbdef5e",
          "quote_token_asset_id": "0xfad619eb58897729c9817e1cc05e824b6b501ab29f2e937ef06b8ac5e98cb2",
          "base_token_contract_addr": "eth",
          "quote_token_contract_addr": "0x941661bd1134dc7cc3d107bf006b8631f6e65ad5",
          "base_token_name": "ETH",
          "quote_token_name": "REDDIO721"
        },
        "fee_rate": "200",
        "token_type": "ERC721",
        "token_id": "152",
        "display_price": "0.001"
      }
    ],
    "total": 1
  }
}

Cancel an order

Cancel an existing order.

Parameters


*stark_key string

A unique key that identifies the user in the off-chain state


*signature string

The signature for the transaction, can be calculated by https://github.com/reddio-com/red-py-sdk.

jsx
POST /v1/orders/:orderID/cancel

Example payload

json
{
    "stark_key": "0x38cae143fe6d2b8bdb7051f211744017d98f7e6a67e45a5dfc08759c119cf3c",
    "signature":{
      "r":"0x4d308e89375fb3d6eaea836aa6615f6e52a4842da3b2d2de73b53996da7e082",
      "s":"0x2d532e42c43756a179496245c124acf082418081f0b3f94522e9bc5fc0f914"
   },
}

Example response

json
{
	"status": "OK",
	"error": "",
	"error_code": 0,
	"data": {
		"sequence_id": 302124
	}
}