Skip to main content

List Orders

GET 
/v1/trade/orders

List your orders.

Requires authentication.

Request​

Query Parameters

    status string

    Possible values: [CANCELED, CANCELED_PENDING_BALANCE, FILLED, OPEN, PARTIALLY_FILLED, PENDING_BALANCE, PENDING_CANCELING, SUBMITTING]

    A stage of the order life cycle.

    market string

    Market identification.

    created_at string

    Timestamp of when this object was created.

    updated_at string

    Timestamp of when this object was updated.

    cursor string

    A reference to the server indicating the next set of objects to be returned. It is sent back in every response were the number of objects returned is bigger than the limit.

    limit integer

    Possible values: non-empty and <= 200 characters, >= 1 and <= 200

    Default value: 20

    Max number of objects to be returned as result of request.

Responses​

OK

Schema
    result object[]
  • Array [
    • id string

    Order Id.

    market string

    Market ID.

    side string

    Possible values: [BUY, SELL]

    If is a selling or buyer order.

    type string

    Possible values: [LIMIT, MARKET]

    A Limit order has a limit price (maximum to buy or minimum to sell). A Market one executes using the current prices on top of the book.

    status string

    Possible values: [CANCELED, FILLED, OPEN, PARTIALLY_FILLED, PENDING_CANCELING, SUBMITTING]

    A stage of the order life cycle:

    • SUBMITTING: Order being sent or during general validation.
    • OPEN: Order created waiting to be matched.
    • PARTIALLY_FILLED: Order partially matched.
    • FILLED: Order filled / completed.
    • PENDING_CANCELING: User asks to cancel the order and the canceling is being processed.
    • CANCELED: Order canceled.
    time_in_force string

    Possible values: [FOK, GTC, IOC]

    Define the how the order will be executed:

    • Fill-Or-Kill (FOK) will be immediately totally executed at the price or better, otherwise, it will be completely cancelled; It can be used with types: MARKET and LIMIT;
    • Good-'Til-Canceled (GTC) will be remaining active until it were fully executed or canceled; It can be used with type: LIMIT;
    • Immediate-Or-Cancel (IOC) will be immediately executed at the price or better, even if partially, and canceled if not fully executed; It can be used with types: MARKET and LIMIT;
    price string

    Value being offered or asked. It is used in LIMIT orders.

    size string

    Amount of asset being offered or asked.

    fee string

    Fee charged when this order matched. When it is a buy order, the currency of this fee is the currency of the base side of the traded pair. When it is sell, the currency is the same of the quote side of the pair.

    fee_currency string

    Currency in which the fee is being charged.

    filled string

    An order can match partially with one or more other orders until completely fill the order size. This field is the amount filled until the moment or until the order were finished (canceled or filled).

    filled_weighted_price string

    Weighted average price of the filled amount.

    custom_id string

    A unique identification send by customer. Can be used to retrieve the order in place of the order id.

    cancel_readon

    Possible values: [USER_REQUESTED, EXPIRED, REJECTED, SELF_TRADE]

    When status canceled, return the reason:

    • USER_REQUESTED: Requested by customer.
    • EXPIRED: Not filled FOK orders.
    • REJECTED: System problems.
    • SELF_TRADE: When already there is a oposite order on the book from the same customer, the old one is canceled.
    created_at created_at (integer)

    Timestamp of when this object was created.

    updated_at updated_at (integer)

    Timestamp of when this object was updated.

  • ]
Loading...