Secondary market orders

Limit order placed on a secondary market. Represents an investor's intent to buy or sell a specific volume of tokens at a given price.

Fields

Fields on the SecondaryMarketOrder object.

Field	Type	Description
`id`	`ID!`	—
`createdAt`	`Time!`	—
`currentVolume`	`Uint64!`	Remaining number of tokens that have not yet been matched.
`initialVolume`	`Uint64!`	Original number of tokens requested when the order was placed.
`direction`	`SecondaryMarketOrderDirection!`	Whether this is a buy or sell order.
`type`	`SecondaryMarketOrderType!`	Execution type of the order.
`price`	`Uint64!`	Limit price for this order. Price in euro cents per token.
`status`	`SecondaryMarketOrderStatus!`	Current lifecycle status of the order.
`expiresAt`	`Time`	Optional expiration date after which the order can no longer be matched.
`feesPercentage`	`Float!`	Platform fee percentage applied to this order. Only visible to the order owner.
`secondaryMarket`	`SecondaryMarket!`	Secondary market this order was placed on.
`user`	`User`	User who placed this order. Null if the viewer lacks permission.

Queries

Root queries that return or operate on this object.

`secondaryMarketOrder`

Retrieve a single secondary market order by its identifier.

type Query {
  secondaryMarketOrder(id: ID!): SecondaryMarketOrder
}

Arguments

Argument	Type	Description
`id`	`ID!`	—

Returns

SecondaryMarketOrder

`secondaryMarketOrderTransaction`

Retrieve a single secondary market order transaction by its identifier.

type Query {
  secondaryMarketOrderTransaction(id: ID!): SecondaryMarketOrderTransaction
}

Arguments

Argument	Type	Description
`id`	`ID!`	—

Returns

SecondaryMarketOrderTransaction

`previewSecondaryMarketOrder`

Compute a fee and total-cost preview for a secondary market order without placing it.

type Query {
  previewSecondaryMarketOrder(input: CreateSecondaryMarketOrderInput!): PreviewSecondaryMarketOrderPayload!
}

Arguments

Argument	Type	Description
`input`	`CreateSecondaryMarketOrderInput!`	—

Returns

PreviewSecondaryMarketOrderPayload

Mutations

Root mutations that create, update, or otherwise change this object.

`createSecondaryMarketOrder`

Place a buy or sell order on a secondary market. Audit-logged.

type Mutation {
  createSecondaryMarketOrder(input: CreateSecondaryMarketOrderInput!): CreateSecondaryMarketOrderPayload!
}

Arguments

Argument	Type	Description
`input`	`CreateSecondaryMarketOrderInput!`	—

Returns

CreateSecondaryMarketOrderPayload

`cancelSecondaryMarketOrder`

Cancel an open secondary market order. Audit-logged.

type Mutation {
  cancelSecondaryMarketOrder(input: CancelSecondaryMarketOrderInput!): CancelSecondaryMarketOrderPayload!
}

Arguments

Argument	Type	Description
`input`	`CancelSecondaryMarketOrderInput!`	—

Returns

CancelSecondaryMarketOrderPayload

Related types

Supporting objects, inputs, and enums used by this page.

Objects

`CancelSecondaryMarketOrderPayload`

Type: object

Response payload for the cancelSecondaryMarketOrder mutation.

Fields

Field	Type	Description
`secondaryMarketOrder`	`SecondaryMarketOrder!`	The cancelled secondary market order.

`CreateSecondaryMarketOrderPayload`

Type: object

Response payload for the createSecondaryMarketOrder mutation.

Fields

Field	Type	Description
`secondaryMarketOrder`	`SecondaryMarketOrder!`	The newly created secondary market order.

`PreviewSecondaryMarketOrderPayload`

Type: object

Response payload for the previewSecondaryMarketOrder query. Contains fee and cost estimates.

Fields

Field	Type	Description
`feesPercentage`	`Float!`	Platform fee percentage that would be applied to the order.
`totalPriceWithFees`	`Uint64!`	Total cost including fees. Amount in euro cents.

`SecondaryMarketOrderConnection`

Type: object

Relay connection for paginated SecondaryMarketOrder results.

Fields

Field	Type	Description
`nodes`	`[SecondaryMarketOrder]!`	—
`edges`	`[SecondaryMarketOrderEdge!]!`	—
`pageInfo`	`PageInfo!`	—
`totalCount`	`Int!`	—

`SecondaryMarketOrderEdge`

Type: object

Relay edge wrapping a SecondaryMarketOrder node with its pagination cursor.

Fields

Field	Type	Description
`cursor`	`String!`	—
`node`	`SecondaryMarketOrder!`	—

`SecondaryMarketOrderTransaction`

Type: object

Executed trade on a secondary market. Created when a buy order matches a sell order, recording the settlement details for both parties.

Implements: Node, NotificationReference

Fields

Field	Type	Description
`id`	`ID!`	—
`createdAt`	`Time!`	—
`volumeToken`	`Uint64!`	Number of tokens exchanged in this trade.
`volumeEuroToken`	`Uint64!`	Euro-token amount exchanged. Amount in euro cents.
`price`	`Uint64!`	Execution price of the trade. Price in euro cents per token.
`realizedPnl`	`Int!`	Realized profit or loss resulting from this trade. Amount in euro cents.
`secondaryMarketOrderBuy`	`SecondaryMarketOrder!`	Buy-side order that participated in this trade.
`secondaryMarketOrderSell`	`SecondaryMarketOrder!`	Sell-side order that participated in this trade.
`taker`	`User!`	User who triggered the match (taker).
`maker`	`User!`	User whose resting order was matched (maker).
`transaction`	`Transaction!`	Parent transaction record for this trade.
`secondaryMarket`	`SecondaryMarket!`	Secondary market where this trade was executed.

`SecondaryMarketOrderTransactionConnection`

Type: object

Relay connection for paginated SecondaryMarketOrderTransaction results.

Fields

Field	Type	Description
`nodes`	`[SecondaryMarketOrderTransaction]!`	—
`edges`	`[SecondaryMarketOrderTransactionEdge!]!`	—
`pageInfo`	`PageInfo!`	—
`totalCount`	`Int!`	—

`SecondaryMarketOrderTransactionEdge`

Type: object

Relay edge wrapping a SecondaryMarketOrderTransaction node with its pagination cursor.

Fields

Field	Type	Description
`cursor`	`String!`	—
`node`	`SecondaryMarketOrderTransaction!`	—

Inputs

`CancelSecondaryMarketOrderInput`

Type: input

Input for cancelling a secondary market order.

Fields

Field	Type	Description
`SecondaryMarketOrderID`	`ID!`	Identifier of the order to cancel.

`CreateSecondaryMarketOrderInput`

Type: input

Input for placing an order on a secondary market.

Fields

Field	Type	Description
`Direction`	`SecondaryMarketOrderDirection!`	Whether to buy or sell tokens.
`Type`	`SecondaryMarketOrderType!`	Execution type of the order.
`Volume`	`Uint64!`	Number of tokens to trade.
`Price`	`Uint64!`	Limit price for the order. Price in euro cents per token.
`SecondaryMarketID`	`String!`	Identifier of the secondary market to place the order on.
`UserID`	`String!`	Identifier of the user placing the order.
`ExpiresAt`	`Time`	Optional expiration date for the order. If set, the order will not be matchable after this date.

`UserSecondaryMarketOrderInput`

Type: input

Filter for listing a user's secondary market orders.

Fields

Field	Type	Description
`status`	`SecondaryMarketOrderStatus`	—

Enums

`SecondaryMarketOrderDirection`

Type: enum

Direction of a secondary market order: buying or selling tokens.

Values

Value	Description
`BUY`	Order to purchase tokens.
`SELL`	Order to sell tokens.

`SecondaryMarketOrderStatus`

Type: enum

Lifecycle status of a secondary market order.

Values

Value	Description
`PROCESSING`	Order is being validated and submitted.
`OPEN`	Order is live on the order book and awaiting a match.
`CLOSED`	Order has been fully filled.
`CANCELLED`	Order was cancelled before being fully filled.
`EXPIRED`	Order has expired and can no longer be matched.

`SecondaryMarketOrderType`

Type: enum

Execution type of a secondary market order.

Values

Value	Description
`LIMIT`	Order placed at a specific price; executes only at that price or better.