Users

A natural or legal person registered on the platform. Users undergo KYC
verification and can hold token balances, place market orders, and receive
notifications.

Fields

Fields on the User object.

Field	Type	Description
`id`	`ID!`	—
`createdAt`	`Time!`	—
`deletedAt`	`Time`	Soft-delete timestamp. Null when the record is active.
`type`	`UserType!`	—
`firstName`	`String`	—
`lastName`	`String`	—
`birthDate`	`Time`	—
`birthPlace`	`String`	—
`companyName`	`String`	Company name (legal persons only).
`companyNumber`	`String`	Company registration number (legal persons only).
`lei`	`String`	Legal Entity Identifier (legal persons only).
`companyCreationDate`	`Time`	—
`companyRevenue`	`UserCompanyRevenue`	—
`companyShareCapital`	`UserCompanyShareCapital`	—
`companyLegalForm`	`UserCompanyLegalForm`	—
`concat`	`String`	Regulatory CONCAT identifier.
`nationality`	`Country`	—
`birthplaceCountry`	`Country`	Country of birth.
`taxResidency`	`Country`	—
`phoneNumber`	`String`	—
`addressLine1`	`String`	—
`addressLine2`	`String`	—
`city`	`String`	—
`postalCode`	`String`	—
`gender`	`UserGender`	—
`profession`	`UserProfession`	—
`industry`	`UserIndustry`	—
`revenue`	`UserRevenue`	—
`netWorth`	`UserNetWorth`	—
`requirements`	`UserRequirements!`	Onboarding requirements for this user's own profile.
`ownerAccountRequirements`	`UserRequirements!`	Onboarding requirements from the perspective of the account owner.
`memobankIban`	`String`	Memobank virtual IBAN assigned to this user for euro deposits.
`bridgePaymentLinks`	`BridgePaymentLinkConnection!` Arguments: `first`: `Int`, `last`: `Int`, `before`: `String`, `after`: `String`	—
`country`	`Country`	Country of residence.
`availableBalanceEuro`	`Uint64!`	Available cash balance in euro cents (after pending operations).
`totalBalanceEuro`	`Uint64!`	Total cash balance in euro cents (including pending operations).
`issuer`	`Issuer`	Issuer profile if this user is a token issuer.
`uboDeclaration`	`UboDeclaration`	Current UBO declaration for legal-person users.
`userTransactions`	`UserTransactionConnection!` Arguments: `first`: `Int`, `last`: `Int`, `before`: `String`, `after`: `String`	—
`feesPercentage`	`Float!`	Trading fee percentage applied to this user's secondary market orders.
`notifications`	`NotificationConnection!` Arguments: `first`: `Int`, `last`: `Int`, `before`: `String`, `after`: `String`	—
`userEvents`	`UserEventConnection!` Arguments: `first`: `Int`, `last`: `Int`, `before`: `String`, `after`: `String`	—
`linkedAccounts`	`AccountConnection` Arguments: `first`: `Int`, `last`: `Int`, `before`: `String`, `after`: `String`	Other accounts this user is linked to.
`documents`	`DocumentConnection!` Arguments: `first`: `Int`, `last`: `Int`, `before`: `String`, `after`: `String`, `input`: `UserDocumentInput`	—
`secondaryMarketOrders`	`SecondaryMarketOrderConnection!` Arguments: `first`: `Int`, `last`: `Int`, `before`: `String`, `after`: `String`, `input`: `UserSecondaryMarketOrderInput`	—
`primaryMarketOrders`	`PrimaryMarketOrderConnection!` Arguments: `first`: `Int`, `last`: `Int`, `before`: `String`, `after`: `String`, `input`: `UserPrimaryMarketOrderInput`	—
`questionnaireUserTentative`	`QuestionnaireUserTentativeConnection!` Arguments: `first`: `Int`, `last`: `Int`, `before`: `String`, `after`: `String`	—
`beneficiaries`	`BeneficiaryConnection!` Arguments: `first`: `Int`, `last`: `Int`, `before`: `String`, `after`: `String`	—
`userTokenBalances`	`UserTokenBalanceConnection!` Arguments: `first`: `Int`, `last`: `Int`, `before`: `String`, `after`: `String`, `realizedPnlRangeInput`: `UserTokenBalanceRealizedPnlRangeInput`	—
`accountRoles`	`AccountRoleConnection!` Arguments: `first`: `Int`, `last`: `Int`, `before`: `String`, `after`: `String`	—
`userBalanceAudits`	`UserBalanceAuditConnection!` Arguments: `first`: `Int`, `last`: `Int`, `before`: `String`, `after`: `String`	—
`userWalletBalanceAtDate`	`UserWalletBalanceAtDate!` Arguments: `input`: `UserWalletBalanceAtDateInput!`	—
`userWalletSnapshots`	`[UserWalletSnapshot!]!` Arguments: `input`: `UserWalletSnapshotsInput!`	—
`alerts`	`AlertConnection!` Arguments: `first`: `Int`, `last`: `Int`, `before`: `String`, `after`: `String`	—
`risk`	`UserRisk!`	Current composite risk score and severity for this user.
`riskAssessments`	`UserRiskAssessmentConnection!` Arguments: `first`: `Int`, `last`: `Int`, `before`: `String`, `after`: `String`	—
`comments`	`CommentConnection!` Arguments: `first`: `Int`, `last`: `Int`, `before`: `String`, `after`: `String`	Compliance comments linked to this user (admin-only).
`ipRecords`	`IPRecordConnection!` Arguments: `first`: `Int`, `last`: `Int`, `before`: `String`, `after`: `String`	—
`ownerAccount`	`Account!`	The account that owns this user.

Related types

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

Objects

`Account`

Type: object

An account represents a tenant on the platform. It owns one or more users
and holds credentials for authentication.

Implements: Node

Fields

Field	Type	Description
`id`	`ID!`	—
`createdAt`	`Time!`	—
`status`	`AccountStatus!`	—
`credentials`	`[AccountCredential!]!`	Login credentials associated with this account.
`linkedUsers`	`UserConnection!` Arguments: `first`: `Int`, `last`: `Int`, `before`: `String`, `after`: `String`	Users linked to this account.

`AccountConnection`

Type: object

Relay connection for paginated Account results.

Fields

Field	Type	Description
`nodes`	`[Account]!`	—
`edges`	`[AccountEdge!]!`	—
`pageInfo`	`PageInfo!`	—
`totalCount`	`Int!`	—

`AccountCredential`

Type: object

A login credential attached to an account (e.g., email/password or API key).

Implements: Node

Fields

Field	Type	Description
`id`	`ID!`	—
`credentialType`	`AccountCredentialType!`	—
`login`	`String!`	Username or email used for authentication. For API keys this is the public key identifier.

`AccountEdge`

Type: object

Relay edge wrapping an Account node with its pagination cursor.

Fields

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

`AccountRole`

Type: object

A role assignment linking an actor user to a target user within an account.
Grants the actor a specific role (and its permissions) over the target.

Implements: Node

Fields

Field	Type	Description
`id`	`ID!`	—
`createdAt`	`Time!`	—
`account`	`Account!`	Account in which this role assignment exists.
`actorUser`	`User!`	User who holds the role (the one performing actions).
`targetUser`	`User!`	User over whom the role is exercised.
`role`	`Role!`	—

`AccountRoleConnection`

Type: object

Relay connection for paginated AccountRole results.

Fields

Field	Type	Description
`nodes`	`[AccountRole]!`	—
`edges`	`[AccountRoleEdge!]!`	—
`pageInfo`	`PageInfo!`	—
`totalCount`	`Int!`	—

`AccountRoleEdge`

Type: object

Relay edge wrapping an AccountRole node with its pagination cursor.

Fields

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

`Permission`

Type: object

A granular permission that can be granted to users through roles.

Implements: Node

Fields

Field	Type	Description
`id`	`ID!`	—
`name`	`String!`	—
`description`	`String!`	—

`PermissionConnection`

Type: object

Relay connection for paginated Permission results.

Fields

Field	Type	Description
`nodes`	`[Permission]!`	—
`edges`	`[PermissionEdge!]!`	—
`pageInfo`	`PageInfo!`	—
`totalCount`	`Int!`	—

`PermissionEdge`

Type: object

Relay edge wrapping a Permission node with its pagination cursor.

Fields

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

`Role`

Type: object

A named role grouping a set of permissions with a defined scope.

Implements: Node

Fields

Field	Type	Description
`id`	`ID!`	—
`name`	`String!`	—
`scope`	`RoleScope!`	—
`permissions`	`PermissionConnection!` Arguments: `first`: `Int`, `last`: `Int`, `before`: `String`, `after`: `String`	Permissions granted by this role.
`accountRoles`	`AccountRoleConnection!` Arguments: `first`: `Int`, `last`: `Int`, `before`: `String`, `after`: `String`	Account role assignments that reference this role.

`UserBalanceAudit`

Type: object

Point-in-time snapshot of a user's balance captured after a balance-changing operation.

Implements: Node

Fields

Field	Type	Description
`id`	`ID!`	—
`createdAt`	`Time!`	—
`user`	`User!`	User whose balance was recorded.
`balanceEuro`	`Uint64!`	Euro cash balance at the time of the snapshot. Amount in euro cents.
`balanceSpecificToken`	`Uint64`	Token quantity held at the time of the snapshot, if a specific token is involved.
`specificToken`	`Token`	Token associated with this audit entry, when applicable.
`specificTokenPrice`	`Uint64`	Unit price of the specific token at snapshot time. Amount in euro cents.
`specificTokenTotalBalanceSupply`	`Uint64`	Total supply-side balance of the specific token at snapshot time.
`reference`	`Node!`	Domain entity that triggered this balance change.

`UserBalanceAuditConnection`

Type: object

Relay connection for paginated UserBalanceAudit results.

Fields

Field	Type	Description
`nodes`	`[UserBalanceAudit]!`	—
`edges`	`[UserBalanceAuditEdge!]!`	—
`pageInfo`	`PageInfo!`	—
`totalCount`	`Int!`	—

`UserBalanceAuditEdge`

Type: object

Relay edge wrapping a UserBalanceAudit node with its pagination cursor.

Fields

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

`UserConnection`

Type: object

Relay connection for paginated User results.

Fields

Field	Type	Description
`nodes`	`[User]!`	—
`edges`	`[UserEdge!]!`	—
`pageInfo`	`PageInfo!`	—
`totalCount`	`Int!`	—

`UserCronJob`

Type: object

A scheduled job that triggers a recurring event for a specific user.

Implements: Node

Fields

Field	Type	Description
`id`	`ID!`	—
`userID`	`ID!`	The user this cron job runs for.
`eventID`	`ID!`	The event triggered when the cron fires.
`cronExpression`	`String!`	Standard 5-field cron expression controlling when the job runs.
`email`	`String`	Optional override email the report is sent to instead of the user's account email.
`createdAt`	`Time!`	—
`event`	`Event!`	The event triggered when the cron fires, resolved from eventID.

`UserEdge`

Type: object

Relay edge wrapping a User node with its pagination cursor.

Fields

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

`UserEvent`

Type: object

Association between a user and an audit event, capturing per-user event lifecycle.

Implements: Node

Fields

Field	Type	Description
`id`	`ID!`	—
`createdAt`	`Time!`	—
`deletedAt`	`Time`	Soft-delete timestamp. Null when the record is active.
`event`	`Event!`	Audit event this user event belongs to.
`status`	`EventStatus!`	Current lifecycle status of the user event.
`user`	`User`	User who triggered or is affected by the event.
`account`	`Account`	Account associated with the user at the time of the event.

`UserEventConnection`

Type: object

Relay connection for paginated UserEvent results.

Fields

Field	Type	Description
`nodes`	`[UserEvent]!`	—
`edges`	`[UserEventEdge!]!`	—
`pageInfo`	`PageInfo!`	—
`totalCount`	`Int!`	—

`UserEventEdge`

Type: object

Relay edge wrapping a UserEvent node with its pagination cursor.

Fields

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

`UserHolder`

Type: object

An immutable snapshot of a user's identity at a specific point in time.
Used in capitalization tables and transaction records to preserve historical data.

Fields

Field	Type	Description
`id`	`ID!`	—
`firstName`	`String`	—
`lastName`	`String`	—
`birthDate`	`Time`	—
`birthPlace`	`String`	—
`gender`	`UserGender`	—
`companyName`	`String`	Company name (present only for legal-person holders).
`companyNumber`	`String`	Company registration number (present only for legal-person holders).
`addressLine1`	`String`	—
`addressLine2`	`String`	—
`city`	`String`	—
`postalCode`	`String`	—
`country`	`Country`	—
`phoneNumber`	`String`	—
`type`	`UserType!`	—

`UserRequirements`

Type: object

Tracks which onboarding steps a user has completed. Used by the frontend
to display progress and enforce prerequisite checks.

Fields

Field	Type	Description
`documentCategories`	`[DocumentCategoryUser!]!`	Document categories still required from the user.
`questionnaireCategories`	`[QuestionnaireCategory!]!`	Questionnaire categories still required from the user.
`termsAndConditions`	`Boolean!`	Whether the user has accepted the terms and conditions.
`personInformation`	`Boolean!`	Whether mandatory personal information has been provided.
`uboDeclaration`	`Boolean!`	Whether the UBO declaration has been submitted (legal persons only).
`lockedByAlert`	`Boolean!`	Whether the user is locked by an active alert (e.g. failed identity verification).

`UserRisk`

Type: object

Aggregated risk profile for a user, combining all individual risk assessments into
a single composite score and severity level.

Fields

Field	Type	Description
`score`	`Int!`	Composite risk score across all assessed categories.
`severity`	`Severity!`	—

`UserRiskAssessment`

Type: object

Association between a user and a specific risk assessment, capturing the risk score
at the time the assessment was recorded.

Implements: Node, AlertReference

Fields

Field	Type	Description
`id`	`ID!`	—
`createdAt`	`Time!`	—
`snapshotScore`	`Int!`	Risk score snapshot captured when this assessment was recorded.
`riskAssessment`	`RiskAssessment!`	Underlying risk-assessment criterion.
`comments`	`CommentConnection!` Arguments: `first`: `Int`, `last`: `Int`, `before`: `String`, `after`: `String`	Paginated list of review comments on this risk assessment.

`UserRiskAssessmentConnection`

Type: object

Relay connection for paginated UserRiskAssessment results.

Fields

Field	Type	Description
`nodes`	`[UserRiskAssessment]!`	—
`edges`	`[UserRiskAssessmentEdge!]!`	—
`pageInfo`	`PageInfo!`	—
`totalCount`	`Int!`	—

`UserRiskAssessmentEdge`

Type: object

Relay edge wrapping a UserRiskAssessment node with its pagination cursor.

Fields

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

`UserTokenBalance`

Type: object

Per-user balance for a specific token. Tracks total holdings, available (unlocked) balance, and profit-and-loss figures.

Implements: Node

Fields

Field	Type	Description
`id`	`ID!`	—
`tokenID`	`ID!`	ID of the token this balance relates to.
`token`	`Token!`	Token this balance relates to.
`totalBalance`	`Uint64!`	Total number of tokens owned, including those locked in open orders.
`availableBalance`	`Uint64!`	Number of tokens available for trading or withdrawal.
`realizedPnl`	`Int!`	Cumulative realized profit or loss from closed trades. Amount in euro cents.
`unrealizedPnl`	`Int!`	Unrealized profit or loss based on current market price. Amount in euro cents.
`unrealizedPnlPercentage`	`Float`	Unrealized profit or loss as a ratio of the weighted cost basis (e.g. 0.05 = 5%). Null when no cost basis is available.

`UserTokenBalanceConnection`

Type: object

Relay connection for paginated UserTokenBalance results.

Fields

Field	Type	Description
`nodes`	`[UserTokenBalance]!`	—
`edges`	`[UserTokenBalanceEdge!]!`	—
`pageInfo`	`PageInfo!`	—
`totalCount`	`Int!`	—

`UserTokenBalanceEdge`

Type: object

Relay edge wrapping a UserTokenBalance node with its pagination cursor.

Fields

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

`UserWalletBalanceAtDate`

Type: object

Aggregated wallet balance for a user on a specific date.

Fields

Field	Type	Description
`date`	`Time!`	Date of the balance snapshot.
`totalBalance`	`Uint64!`	Total wallet balance on this date. Amount in euro cents.

`UserWalletSnapshot`

Type: object

Complete wallet snapshot for a user on a given date, including cash and token positions.

Fields

Field	Type	Description
`date`	`Time!`	Date of the snapshot.
`balanceEUR`	`Uint64!`	Euro cash balance. Amount in euro cents.
`totalTokenValuationEUR`	`Uint64!`	Total valuation of all token holdings. Amount in euro cents.
`tokenBalances`	`[TokenBalance!]!`	Breakdown of individual token positions.

Inputs

`UserTokenBalanceRealizedPnlRangeInput`

Type: input

Date range for computing realized profit and loss on token holdings.

Fields

Field	Type	Description
`startingDate`	`Time!`	—
`endingDate`	`Time!`	—

`UserWalletBalanceAtDateInput`

Type: input

Input to retrieve a user's wallet balance at a specific date.

Fields

Field	Type	Description
`date`	`Time!`	—

`UserWalletSnapshotsInput`

Type: input

Input to retrieve a time series of wallet snapshots over a date range.

Fields

Field	Type	Description
`from`	`Time!`	—
`to`	`Time!`	—
`interval`	`Interval!`	—

Enums

`AccountCredentialType`

Type: enum

Authentication method used by an account credential.

Values

Value	Description
`EMAIL_PASSWORD`	Standard email and password authentication.
`API_KEY`	Programmatic access via an API key.
`SYSTEM`	Internal system account (not used for authentication).

`AccountStatus`

Type: enum

Lifecycle status of an account.

Values

Value	Description
`ACTIVE`	Account is fully operational.
`INVITATION_PENDING`	Account was created but the owner has not yet completed onboarding.
`DELETED`	Account has been soft-deleted.
`LOCKED`	Account has been locked by an administrator.

`RoleScope`

Type: enum

Determines the breadth of a role's permissions.

Values

Value	Description
`ALL`	Permissions apply to all users within the account.
`SELF`	Permissions apply only to the actor's own data.

`UserCompanyLegalForm`

Type: enum

Legal form of a legal-entity user's company.

Values

Value	Description
`LEGAL_FORM_FRENCH_ASSOCIATION`	French association (loi 1901).
`LEGAL_FORM_FRENCH_SELF_EMPLOYED`	French auto-entrepreneur / micro-entreprise.
`LEGAL_FORM_FRENCH_PUBLIC_COMPANY`	French public limited company (SA).
`LEGAL_FORM_FRENCH_PRIVATE_COMPANY`	French private limited company (SAS, SARL, etc.).
`LEGAL_FORM_FRENCH_TRUST`	French trust or fiducie.
`LEGAL_FORM_EU_COMPANY`	Company incorporated in the EU (outside France).
`LEGAL_FORM_NON_EU_COMPANY`	Company incorporated outside the EU.
`LEGAL_FORM_FRENCH_LISTED_SA`	French listed public company (SA cotée).

`UserCompanyRevenue`

Type: enum

Annual revenue bracket of a legal-entity user's company.

Values

Value	Description
`REVENUE_LOWER_THAN_100_K`
`REVENUE_BETWEEN_100_K_AND_500_K`
`REVENUE_BETWEEN_500_K_AND_2_5_M`
`REVENUE_OVER_2_5_M`

`UserCompanyShareCapital`

Type: enum

Share capital bracket of a legal-entity user's company.

Values

Value	Description
`SHARE_CAPITAL_LOWER_THAN_10_K`
`SHARE_CAPITAL_BETWEEN_10_K_AND_100_K`
`SHARE_CAPITAL_OVER_100_K`

`UserGender`

Type: enum

Gender of a natural-person user.

Values

Value	Description
`MALE`
`FEMALE`
`OTHER`

`UserIndustry`

Type: enum

Industry sector of a legal-entity user, used for KYC risk scoring. High-risk industries receive elevated scrutiny.

Values

Value	Description
`INDUSTRY_CORRESPONDENT_BANKS`
`INDUSTRY_WEAPONS_DEFENSE`
`INDUSTRY_NUCLEAR_ENERGY`
`INDUSTRY_EXTRACTIVE_INDUSTRIES`
`INDUSTRY_PRECIOUS_METALS`
`INDUSTRY_ASSOCIATIONS_FOUNDATIONS`
`INDUSTRY_NGOS`
`INDUSTRY_VIRTUAL_CURRENCIES`
`INDUSTRY_GAMBLING`
`INDUSTRY_PAYMENT_INSTITUTIONS`
`INDUSTRY_MONEY_TRANSFER_SERVICES`
`INDUSTRY_ADULT_ENTERTAINMENT`
`INDUSTRY_TOBACCO_CANNABIS`
`INDUSTRY_EMBASSIES_CONSULATES`
`INDUSTRY_OTHER`
`INDUSTRY_AGRICULTURE_AGRIFOOD`
`INDUSTRY_INSURANCE`
`INDUSTRY_AUTOMOTIVE`
`INDUSTRY_CONSTRUCTION_REAL_ESTATE`
`INDUSTRY_RETAIL_TRADE`
`INDUSTRY_CULTURE_MEDIA`
`INDUSTRY_EDUCATION_TRAINING`
`INDUSTRY_ENERGY_ENVIRONMENT`
`INDUSTRY_FINANCE_INVESTMENT`
`INDUSTRY_HOSPITALITY_CATERING`
`INDUSTRY_MANUFACTURING`
`INDUSTRY_IT_TECHNOLOGY`
`INDUSTRY_LOGISTICS_TRANSPORT`
`INDUSTRY_LUXURY`
`INDUSTRY_PHARMACY_HEALTH`
`INDUSTRY_BUSINESS_SERVICES`
`INDUSTRY_TELECOMMUNICATIONS`
`INDUSTRY_TOURISM`

`UserNetWorth`

Type: enum

Personal net worth bracket of a natural-person user.

Values

Value	Description
`NET_WORTH_LOWER_THAN_OR_EQUAL_200_K`
`NET_WORTH_BETWEEN_200_K_AND_1_M`
`NET_WORTH_OVER_1_M`

`UserProfession`

Type: enum

Profession of a natural-person user, used for KYC risk scoring.

Values

Value	Description
`PROFESSION_LAWYER`
`PROFESSION_AUCTIONEER`
`PROFESSION_AMBASSADOR`
`PROFESSION_NET_WORTH_MANAGER`	Wealth or asset manager.
`PROFESSION_MERCHANT`
`PROFESSION_BUSINESS_OWNER`
`PROFESSION_LIBERAL_PROFESSION`
`PROFESSION_SENIOR_CIVIL_SERVANT`
`PROFESSION_EXECUTIVE`
`PROFESSION_EMPLOYEE`
`PROFESSION_WORKER`
`PROFESSION_FARMER`
`PROFESSION_RETIRED`
`PROFESSION_OTHER`

`UserRevenue`

Type: enum

Annual personal income bracket of a natural-person user.

Values

Value	Description
`REVENUE_LOWER_THAN_OR_EQUAL_50_K`
`REVENUE_BETWEEN_50_K_AND_150_K`
`REVENUE_BETWEEN_150_K_AND_200_K`
`REVENUE_OVER_200_K`

`UserType`

Type: enum

Distinguishes natural persons from legal entities.

Values

Value	Description
`LEGAL`	Company or other legal entity.
`NATURAL`	Individual (physical person).