ƒxyz Network API

GraphQL-first API for the ƒxyz Network ecosystem

🟢 API Status

Status: Online

Runtime: Next.js Edge

Last Updated: 2025-12-07T22:34:24.074Z

Health Check: /health

📚 Documentation

API documentation and resources:

🚀 GraphQL API PRIMARY

All core functionality is available through our unified GraphQL endpoint with real-time subscriptions:

POST /graphql

Unified GraphQL endpoint for all data operations, subscriptions, and mutations

→ Open GraphQL Playground

🔍 Query Operations

neo4jStatusQuery

Database connection and health status

networkGraphQuery

Network visualization data with nodes and relationships

networkDataQuery

Comprehensive network information

holacracyDataQuery

Organizational structure and governance data

locationsQuery

Geographic locations and member distribution

userBalanceQuery

Encrypted user balance information

userVouchersQuery

User voucher data

voucherByCodeQuery

Get voucher by redemption code

allVouchersQuery

All vouchers (admin only)

vouchersQuery

All vouchers with filtering

allInvitesQuery

All invites (admin only)

invitesQuery

All invites with filtering

tokensQuery

Available token information

isAdminQuery

Admin status check

executeCypherQuery

Raw Cypher query execution (admin only)

cypherQueryQuery

Execute parameterized Cypher queries

investmentDataQuery

Current investment round and token metrics

getPersonasQuery

List user personas

getPersonaQuery

Get specific persona by ID

getActivePersonaQuery

Get user's currently active persona

getUserPersonaContextQuery

Get complete user context with persona, legal entity, and Bridge status

getLegalEntitiesQuery

List legal entities

getLegalEntityQuery

Get specific legal entity by ID

getBridgeCustomersQuery

List Bridge customers

getBridgeCustomerQuery

Get specific Bridge customer by ID

✏️ Mutation Operations

createVoucherMutation

Create new vouchers

updateVoucherMutation

Update existing voucher

claimVoucherMutation

Claim vouchers by code

redeemVoucherMutation

Redeem vouchers for tokens

issueVoucherMutation

Issue voucher with amount and recipient

createInviteMutation

Create new invites

updateInviteMutation

Update existing invite

mintConfidentialFLRMutation

Mint confidential Florin tokens

fixVoucherRelationshipsMutation

Fix missing voucher relationships

createBridgeCustomerMutation

Create Bridge customer for KYC verification

initiateFiatInvestmentMutation

Initiate fiat-to-stablecoin investment via Bridge

createPersonaMutation

Create new persona for identity context

updatePersonaMutation

Update existing persona

deletePersonaMutation

Delete persona

setActivePersonaMutation

Set active persona for user

createLegalEntityMutation

Create legal entity

updateLegalEntityMutation

Update legal entity information

deleteLegalEntityMutation

Delete legal entity

🔄 Subscription Operations

Real-time Updates: WebSocket connections for live data streaming

networkUpdatedSubscription

Real-time network graph changes

nodeCreatedSubscription

New nodes added to the network

nodeUpdatedSubscription

Existing nodes modified

relationshipCreatedSubscription

New relationships formed

voucherCreatedSubscription

New vouchers issued

voucherRedeemedSubscription

Vouchers redeemed

dataUpdatedSubscription

General data change notifications

🔗 Legacy REST Endpoints LEGACY

/healthGET

Health check and system status

⚙️ System & Webhooks

/webhooks/privyPOST

Privy authentication webhook

/webhooks/heliusPOST

Helius blockchain webhook

/webhooks/bridgePOST

Bridge.xyz payment and KYC webhook

/cron/keep-aliveGET

Keep-alive cron job

/invites/*GET

Invite management pages