Secondary markets

Secondary market for a token. Provides a continuous trading venue where investors can place buy and sell orders after the primary offering.

Fields

Fields on the SecondaryMarket object.

Field	Type	Description
`id`	`ID!`	—
`createdAt`	`Time!`	—
`percentageFee`	`Int!`	Platform fee charged on each trade, as an integer percentage.
`fixedFee`	`Int!`	Fixed platform fee charged on each trade. Amount in euro cents.
`isPublished`	`Boolean!`	Whether this secondary market is published and visible to investors.
`activeFreeze`	`SecondaryMarketFreeze`	The freeze period currently halting trading on this market (circuit breaker or manual), or null if trading is open.
`freezes`	`[SecondaryMarketFreeze!]!`	All freeze periods recorded for this market, most recent first.
`token`	`Token!`	Token traded on this secondary market.
`issuer`	`Issuer!`	Issuer of the token traded on this secondary market.
`openOrders`	`SecondaryMarketOrderConnection!` Arguments: `first`: `Int`, `last`: `Int`, `before`: `String`, `after`: `String`	Paginated list of currently open orders on this market.
`ohlcv`	`[OHLCV!]!` Arguments: `from`: `Time!`, `to`: `Time!`, `interval`: `Interval!`	OHLCV candlestick data for the requested time range and interval.
`volumeEur`	`Uint64!` Arguments: `from`: `Time!`, `to`: `Time!`	Total trade volume in euro cents executed on this market between from and to.
`orderTransactions`	`SecondaryMarketOrderTransactionConnection!` Arguments: `first`: `Int`, `last`: `Int`, `before`: `String`, `after`: `String`, `from`: `Time`, `to`: `Time`	Paginated list of executed trade transactions on this market.
`userOrders`	`SecondaryMarketOrderConnection!` Arguments: `userID`: `ID!`, `first`: `Int`, `last`: `Int`, `before`: `String`, `after`: `String`, `input`: `UserSecondaryMarketOrderInput`	Paginated list of orders placed by a specific user on this market.

Queries

Root queries that return or operate on this object.

`secondaryMarket`

Retrieve a single secondary market by its identifier or by token ticker.

type Query {
  secondaryMarket(id: ID, ticker: String): SecondaryMarket
}

Arguments

Argument	Type	Description
`id`	`ID`	—
`ticker`	`String`	—

Returns

SecondaryMarket

`secondaryMarkets`

Retrieve a paginated list of secondary markets.

type Query {
  secondaryMarkets(first: Int, last: Int, before: String, after: String, visibility: SecondaryMarketVisibility): SecondaryMarketConnection!
}

Arguments

Argument	Type	Description
`first`	`Int`	—
`last`	`Int`	—
`before`	`String`	—
`after`	`String`	—
`visibility`	`SecondaryMarketVisibility`	—

Returns

SecondaryMarketConnection

Related types

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

Objects

`OHLCV`

Type: object

OHLCV candlestick data point for secondary market price charts. Contains open, high, low, close prices and trade volume for one time interval.

Fields

Field	Type	Description
`timestamp`	`Time!`	—
`open`	`Uint64!`	Opening price for the interval. Price in euro cents per token.
`high`	`Uint64!`	Highest price during the interval. Price in euro cents per token.
`low`	`Uint64!`	Lowest price during the interval. Price in euro cents per token.
`close`	`Uint64!`	Closing price for the interval. Price in euro cents per token.
`volume`	`Uint64!`	Number of tokens traded during the interval.

`SecondaryMarketConnection`

Type: object

Relay connection for paginated SecondaryMarket results.

Fields

Field	Type	Description
`edges`	`[SecondaryMarketEdge!]!`	—
`nodes`	`[SecondaryMarket]!`	—
`pageInfo`	`PageInfo!`	—
`totalCount`	`Int!`	—

`SecondaryMarketEdge`

Type: object

Relay edge wrapping a SecondaryMarket node with its pagination cursor.

Fields

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

`SecondaryMarketFreeze`

Type: object

A period during which trading on a secondary market was (or is) frozen.

Fields

Field	Type	Description
`id`	`ID!`	—
`createdAt`	`Time!`	—
`startingDate`	`Time!`	When the freeze period starts.
`endingDate`	`Time!`	When the freeze period ends.
`type`	`SecondaryMarketFreezeType!`	How the freeze was created.
`referenceID`	`ID`	Identifier of what triggered the freeze (the order transaction id for an automatic freeze). Null for manual freezes.
`comments`	`CommentConnection!` Arguments: `first`: `Int`, `last`: `Int`, `before`: `String`, `after`: `String`	Comments attached to this freeze, e.g. the operator's justification for a manual freeze.

Enums

`Interval`

Type: enum

Time interval granularity used for OHLCV charts and wallet snapshots.

Values

Value	Description
`ONE_MINUTE`
`FIVE_MINUTES`
`FIFTEEN_MINUTES`
`THIRTY_MINUTES`
`ONE_HOUR`
`FOUR_HOURS`
`ONE_DAY`
`ONE_WEEK`
`ONE_MONTH`
`ONE_YEAR`

`SecondaryMarketFreezeType`

Type: enum

Describes how a secondary market freeze period was created.

Values

Value	Description
`MANUAL`	Freeze created manually (e.g. by an operator).
`AUTOMATIC`	Freeze triggered automatically by the price circuit breaker.

`SecondaryMarketVisibility`

Type: enum

Controls which secondary markets are returned based on their publication status.

Values

Value	Description
`PUBLISHED`	Only published secondary markets visible to investors.
`ALL`	All secondary markets regardless of publication status.