Tokens

Security token registered on the platform. Represents a tokenized financial instrument issued by an issuer.

Fields

Fields on the Token object.

Field	Type	Description
`id`	`ID!`	—
`ticker`	`String!`	Unique stock-market-style symbol identifying this token.
`bloombergTicker`	`String`	Bloomberg-style ticker symbol, used for external data referencing.
`isin`	`String`	International Securities Identification Number, if assigned.
`performance`	`Float!` Arguments: `interval`: `TokenPerformanceInterval!`	Relative price change over the requested interval, as a decimal fraction.
`price`	`Uint64!`	Current market price. Price in euro cents per token.
`openPrimaryMarket`	`PrimaryMarket`	Currently open primary market offering for this token, if any.
`primaryMarkets`	`PrimaryMarketConnection!` Arguments: `first`: `Int`, `last`: `Int`, `before`: `String`, `after`: `String`	Paginated list of all primary market offerings for this token.
`secondaryMarket`	`SecondaryMarket`	Active secondary market for this token, if one exists.
`issuer`	`Issuer!`	Issuer that created and manages this token.
`viewerBalance`	`UserTokenBalance!` Arguments: `input`: `TokenViewerBalanceInput`	Balance of the authenticated viewer for this token.
`lockUp`	`Uint64!`	Amount of this token's supply that is locked up and cannot be transferred.
`totalBalanceSupply`	`Uint64!`	Total on-chain supply of this token across all holders, in base units.
`marketCapitalization`	`Uint64!`	Market capitalization in euro cents: total on-chain supply multiplied by the current price.
`publicFloat`	`Uint64!`	Public float in euro cents: (total on-chain supply minus locked-up supply) multiplied by the current price.

Queries

Root queries that return or operate on this object.

`token`

Retrieve a single token by ID or ticker.

type Query {
  token(tokenInput: TokenInput!): Token!
}

Arguments

Argument	Type	Description
`tokenInput`	`TokenInput!`	—

Returns

Token

`tokens`

Paginated list of tokens, optionally filtered by issuer or market type.

type Query {
  tokens(first: Int, last: Int, before: String, after: String, filters: TokenFilters): TokenConnection!
}

Arguments

Argument	Type	Description
`first`	`Int`	—
`last`	`Int`	—
`before`	`String`	—
`after`	`String`	—
`filters`	`TokenFilters`	—

Returns

TokenConnection

Related types

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

Objects

`TokenBalance`

Type: object

Aggregated token balance for a portfolio view. Summarizes holdings, current value, and price for a single token across all accounts.

Fields

Field	Type	Description
`tokenID`	`ID!`	Identifier of the token this balance refers to.
`token`	`Token!`	Token entity for this balance.
`balanceSpecificToken`	`Uint64!`	Number of tokens held.
`specificTokenPrice`	`Uint64!`	Current unit price of the token. Price in euro cents per token.
`totalTokenValue`	`Uint64!`	Total market value of the held tokens. Amount in euro cents.

`TokenConnection`

Type: object

Relay connection for paginated Token results.

Fields

Field	Type	Description
`edges`	`[TokenEdge!]!`	—
`nodes`	`[Token]!`	—
`pageInfo`	`PageInfo!`	—
`totalCount`	`Int!`	—

`TokenEdge`

Type: object

Relay edge wrapping a Token node with its pagination cursor.

Fields

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

Inputs

`TokenFilters`

Type: input

Filters for narrowing the tokens query results.

Fields

Field	Type	Description
`issuerMarketTypes`	`[IssuerMarketType!]`	Restrict to tokens whose issuer operates in the given market types.
`issuerID`	`ID`	Restrict to tokens issued by a specific issuer.

`TokenInput`

Type: input

Lookup input for retrieving a single token. Provide either id or ticker.

Fields

Field	Type	Description
`id`	`ID`	Token identifier.
`ticker`	`String`	Unique stock-market-style ticker symbol.

`TokenViewerBalanceInput`

Type: input

Input to retrieve the authenticated viewer's balance for this token.

Fields

Field	Type	Description
`realizedPnlRangeInput`	`UserTokenBalanceRealizedPnlRangeInput`	—

Enums

`TokenPerformanceInterval`

Type: enum

Time interval used to compute token price performance.

Values

Value	Description
`LAST_WEEK`
`LAST_MONTH`
`LAST_YEAR`
`ALL_TIME`

`TokenVisibility`

Type: enum

Controls which tokens are returned based on their market status.

Values

Value	Description
`ACTIVE`	Only tokens with an active market (open or incoming primary market, or secondary market).
`ALL`	All tokens regardless of market status. Requires issuer.update permission.