ƒxyzƒxyz Network
Developer

REST API Reference

Complete REST API documentation for fXYZ Network services including Fixies, Bridge, Prices, and more.

REST API Reference

In addition to the GraphQL API, fXYZ Network provides REST endpoints for specific services that benefit from traditional HTTP semantics.

Base URL: https://api.fxyz.network/api

Most endpoints require authentication via Privy JWT token in the Authorization header.

Authentication

All authenticated endpoints require:

Authorization: Bearer <privy-jwt-token>

Some endpoints also support:

x-persona-id: <persona-id>  # For multi-persona users

Fixie AI Agents

AI agent management via Letta integration.

List Agents

GET /api/fixie

Response:

{
  "agents": [
    {
      "id": "agent-xxx",
      "name": "Florin",
      "tier": "standard",
      "ownerType": "network",
      "created_at": "2026-01-01T00:00:00Z"
    }
  ]
}

Create Agent

POST /api/fixie
Content-Type: application/json

{
  "name": "My Agent",
  "tier": "free|standard|premium",
  "ownerType": "member|project|network",
  "memberId": "member-id",
  "projectId": "project-id"
}

Get Agent Details

GET /api/fixie/{agentId}

Chat with Agent (Streaming)

POST /api/fixie/{agentId}/stream
Content-Type: application/json

{
  "message": "What is the current price of SOL?"
}

Returns Server-Sent Events with streaming response.

Agent Tools

GET /api/fixie/tools/graphiti-search?query=<search-query>
GET /api/fixie/tools/query-memory?agentId=<agent-id>&query=<query>
POST /api/fixie/tools/neo4j-query

Prices & Market Data

Real-time pricing from multiple sources.

Get All Prices

GET /api/prices

Response:

{
  "assets": [
    {
      "symbol": "BTC",
      "name": "Bitcoin",
      "price": 98500,
      "change24h": 2.5,
      "type": "crypto"
    }
  ],
  "lastUpdated": "2026-01-19T12:00:00Z"
}

FX Rates

GET /api/fx
GET /api/fx/bis  # Bank for International Settlements data

BIS Response includes:

  • Daily turnover data ($14.8T total)
  • Currency market shares
  • Historical trends

Real World Assets (RWA)

Tokenized asset data from RWA.xyz.

RWA Overview

GET /api/rwa/overview

Response:

{
  "total_value": 1750000000,
  "categories": {
    "stablecoins": 1350000000,
    "public_equity": 144000000,
    "treasury_bonds": 120000000
  },
  "protocols": [...],
  "lastUpdated": "2026-01-19T00:00:00Z"
}

RWA Protocols

GET /api/rwa/protocols

RWA Assets

GET /api/rwa/assets?protocol=<protocol-name>

Bridge (Fiat On/Off Ramps)

Fiat-to-crypto infrastructure via Bridge.xyz.

POST /api/bridge/kyc-links
Content-Type: application/json

{
  "full_name": "John Doe",
  "email": "[email protected]",
  "type": "individual|business",
  "personaId": "persona-id",
  "redirect_uri": "https://app.fxyz.network/kyc-complete"
}
GET /api/bridge/kyc-links?id={linkId}
GET /api/bridge/customers/{customerId}/kyc-link

Virtual Accounts

Create virtual bank accounts for receiving fiat.

GET /api/bridge/virtual-accounts
POST /api/bridge/virtual-accounts
Content-Type: application/json

{
  "bridgeCustomerId": "customer-id",
  "destinationWalletAddress": "Solana-wallet-address",
  "currency": "USD",
  "destinationPaymentRail": "solana",
  "destinationCurrency": "usdc"
}

External Accounts (Bank Linking)

GET /api/bridge/external-accounts
POST /api/bridge/external-accounts
DELETE /api/bridge/external-accounts?bridgeCustomerId=...&accountId=...

Create Bank Account:

{
  "bridgeCustomerId": "customer-id",
  "account_type": "us|iban|...",
  "currency": "USD",
  "bank_name": "Chase",
  "account_number": "...",
  "routing_number": "..."
}

Transfers (Pay-ins)

GET /api/bridge/transfers
GET /api/bridge/transfers/{transferId}
POST /api/bridge/transfers
Content-Type: application/json

{
  "bridgeCustomerId": "customer-id",
  "amount": "100.00",
  "destinationAddress": "wallet-address",
  "currency": "USD",
  "sourceRail": "ach"
}

Liquidations (Off-ramps)

GET /api/bridge/liquidations
POST /api/bridge/liquidation
Content-Type: application/json

{
  "bridgeCustomerId": "customer-id",
  "amount": "100",
  "destinationAccountId": "bank-account-id",
  "sourceCurrency": "usdc",
  "destinationCurrency": "USD"
}

Exchange Rates

GET /api/bridge/exchange-rates?from=USD&to=USDC&amount=100

Solana Blockchain

Direct Solana blockchain queries.

Wallet Balance

GET /api/solana/balance?address={walletAddress}

NFT Holdings

GET /api/solana/nfts?address={walletAddress}

Token Balances

GET /api/solana/tokens?address={walletAddress}

Membership Proof

GET /api/membership-proof?memberId={memberId}
POST /api/membership-proof/verify

Documents (R2 Storage)

Document management via Cloudflare R2.

List Documents

GET /api/documents
GET /api/documents?category=research&status=published

Get Document

GET /api/documents/{documentId}

Upload Document (Admin)

POST /api/documents/upload
Content-Type: multipart/form-data

file: <file>
title: "Document Title"
category: "research|legal|technical"
authors: ["Author 1", "Author 2"]
year: 2026

Update Document

PATCH /api/documents/{documentId}
Content-Type: application/json

{
  "title": "Updated Title",
  "status": "published"
}

Seed Bibliography

POST /api/documents/seed-bibliography

Telegram Integration

Telegram bot webhook and management.

Webhook Handler

POST /api/telegram/webhook
X-Telegram-Bot-Api-Secret-Token: <webhook-secret>

{
  "message": {...},
  "callback_query": {...}
}

Setup Webhook

POST /api/telegram/setup
Content-Type: application/json

{
  "action": "set|delete|info",
  "url": "https://api.fxyz.network/api/telegram/webhook"
}

Bot Commands

  • /start - Initialize bot conversation
  • /help - Show available commands
  • /agents - List available Fixie agents
  • /agent <id> - Select an agent to chat with

Neo4j Graph Database

Direct graph queries and stats.

Database Stats

GET /api/neo4j/stats

Response:

{
  "nodeCount": 4277,
  "relationshipCount": 10946,
  "nodeTypes": {
    "Member": 150,
    "Persona": 320,
    "Party": 450,
    "Circle": 12
  }
}

Webhooks

The API receives webhooks from external services.

Helius (Solana)

POST /api/webhooks/helius
Authorization: <helius-webhook-secret>

Handles:

  • Transaction confirmations
  • NFT mints
  • Token transfers

Bridge (Payments)

POST /api/webhooks/bridge
X-Webhook-Signature: <signature>

Handles:

  • Payment status updates
  • KYC completion events
  • Transfer confirmations

Privy (Authentication)

POST /api/webhooks/privy

Handles:

  • User creation events
  • Account linking

Cron Jobs

Scheduled data synchronization (internal).

EndpointSchedulePurpose
/api/cron/rwa-syncDaily 00:00Sync RWA.xyz data
/api/cron/fx-ratesHourlyUpdate FX rates
/api/cron/bis-dataDailyBIS market data
/api/cron/crypto-pricesEvery 5 minCrypto prices
/api/cron/defillamaDailyDeFi protocols
/api/cron/keepaliveEvery 5 minHealth check

Error Responses

All endpoints return consistent error format:

{
  "error": "Error message",
  "code": "ERROR_CODE",
  "details": {}
}

Common Status Codes

CodeMeaning
200Success
201Created
400Bad Request
401Unauthorized
403Forbidden
404Not Found
429Rate Limited
500Server Error

Rate Limits

Endpoint TypeLimit
Authenticated1000/hour
Unauthenticated100/hour
Streaming100/hour
WebhooksNo limit

CORS Configuration

The API allows requests from:

  • https://app.fxyz.network
  • https://fxyz.network
  • https://docs.fxyz.network
  • http://localhost:* (development)

Environment Variables

For local development, configure:

# Required
PRIVY_APP_ID=your-app-id
PRIVY_APP_SECRET=your-secret
NEO4J_URI=bolt://localhost:7687
NEO4J_USER=neo4j
NEO4J_PASSWORD=password

# Optional services
BRIDGE_API_KEY=bridge-key
LETTA_BASE_URL=http://localhost:8283
HELIUS_API_KEY=helius-key
R2_ACCESS_KEY_ID=r2-key
R2_SECRET_ACCESS_KEY=r2-secret

SDK Examples

Fetch Prices (JavaScript)

const response = await fetch('https://api.fxyz.network/api/prices');
const { assets } = await response.json();

const btcPrice = assets.find(a => a.symbol === 'BTC')?.price;

Create Fixie Agent (TypeScript)

const response = await fetch('https://api.fxyz.network/api/fixie', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    name: 'My Assistant',
    tier: 'free',
    ownerType: 'member',
    memberId: 'my-member-id',
  }),
});

const { agent } = await response.json();

Stream Chat Response

const eventSource = new EventSource(
  `https://api.fxyz.network/api/fixie/${agentId}/stream?message=${encodeURIComponent(message)}`,
  { headers: { 'Authorization': `Bearer ${token}` } }
);

eventSource.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log(data.content);
};

Deployment Guide

Deploy fXYZ Network applications using Coolify self-hosted infrastructure

GraphQL API Migration Summary

Complete migration to GraphQL API with real-time subscriptions

On this page

REST API ReferenceAuthenticationFixie AI AgentsList AgentsCreate AgentGet Agent DetailsChat with Agent (Streaming)Agent ToolsPrices & Market DataGet All PricesFX RatesReal World Assets (RWA)RWA OverviewRWA ProtocolsRWA AssetsBridge (Fiat On/Off Ramps)KYC LinksVirtual AccountsExternal Accounts (Bank Linking)Transfers (Pay-ins)Liquidations (Off-ramps)Exchange RatesSolana BlockchainWallet BalanceNFT HoldingsToken BalancesMembership ProofDocuments (R2 Storage)List DocumentsGet DocumentUpload Document (Admin)Update DocumentSeed BibliographyTelegram IntegrationWebhook HandlerSetup WebhookBot CommandsNeo4j Graph DatabaseDatabase StatsWebhooksHelius (Solana)Bridge (Payments)Privy (Authentication)Cron JobsError ResponsesCommon Status CodesRate LimitsCORS ConfigurationEnvironment VariablesSDK ExamplesFetch Prices (JavaScript)Create Fixie Agent (TypeScript)Stream Chat Response