01.xyz Exchange Developer Skill
Non-custodial perpetual futures on Solana. Built by traders, for traders.
What this Skill is for
Use this Skill when the user asks for:
- Market Monitoring: Orderbook depth, mark prices, funding rates, 24h stats
- Account Tracking: Position monitoring, margin health, liquidation risk
- Trading Strategies: Market making, DCA, grid trading, trend following
- SDK Integration: Setting up Nord.ts (@n1xyz/nord-ts) for TypeScript/Python
- API Development: Building on the FTX-inspired REST API
- Risk Management: Position sizing, circuit breakers, margin calculations
- N1 Protocol: Understanding the N1 blockchain and ZO protocol architecture
Overview
01.xyz is a non-custodial perpetual futures exchange built on the N1 blockchain (evolution of the ZO protocol). It enables fully self-custodied derivatives trading with up to 20x leverage on major crypto assets.
Key Design Principles
| Feature | Description |
|---|
| Non-custodial | Your private keys never leave your machine. No central counterparty risk. |
| FTX-inspired API | Familiar REST patterns for easy migration from centralized exchanges. |
| Local Signing | Users run a local API that signs transactions — funds remain under user control. |
| High Performance | Sub-second finality on N1 blockchain with Solana settlement. |
| Deep Liquidity | Professional market makers and tight spreads on major pairs. |
Architecture Flow
┌─────────────────────────────────────────────────────────────┐
│ User/Developer │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ AI Agent │ │ Local API │ │ Browser │ │
│ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ │
└─────────┼─────────────────┼─────────────────┼──────────────┘
│ │ (signed txs) │
│ ▼ │
│ ┌──────────────┐ │
│ │ N1 Network │ │
│ │ (L2 chain) │ │
│ └──────┬───────┘ │
│ │ │
│ ┌──────────▼──────────┐ │
└────► zo-mainnet.n1.xyz ◄────────┘
│ REST/WebSocket │
└──────────┬───────────┘
│
┌──────────▼──────────┐
│ Solana L1 │
│ (settlement) │
└─────────────────────┘
Network Endpoints
| Network | Base URL | Purpose | Status |
|---|
| Mainnet | https://zo-mainnet.n1.xyz | Live trading, real funds | Production |
| Devnet | https://zo-devnet.n1.xyz | Testing, dev work | Development |
Default Stack Decisions
These are opinionated defaults. Adjust for your specific use case.
1. Data Access Pattern
| Use Case | Recommended Approach | Auth Required |
|---|
| Market data (prices, orderbook) | Direct HTTP to public endpoints | ❌ No |
| Account data (positions, balances) | Local API or Nord SDK | ✅ Yes |
| Order placement | Local API with user confirmation | ✅ Yes |
2. SDK Selection
| Language | Package | Use When |
|---|
| TypeScript | @n1xyz/nord-ts | Full-featured trading, complex strategies |
| Python | n1-sdk (pip) | Quant research, ML models, backtesting |
| Raw HTTP | Direct REST calls | Simple monitoring, language-agnostic |
3. Security Model
- AI only reads public data — Never expose private keys to AI systems
- Local signing mandatory — All transactions signed by user's local instance
- Explicit confirmation — Trading actions require human approval
- Testnet first — Always validate on devnet before mainnet
4. Development Priority
- Read-only monitoring ✅ — Start here, safe for all users
- Account health tracking ✅ — Requires wallet address only
- Paper trading simulation ⚠️ — Test strategies without real funds
- Live trading ⚠️ — Requires local API + explicit user consent
Operating Procedure
When working with 01.xyz integration:
Phase 1: Discovery
-
Identify the task type:
MONITORING — Market data, public statsACCOUNT — Position/balance queriesTRADING — Order placement, strategy executionRISK — Health checks, liquidation analysis
-
Determine authentication needs:
- Public endpoints: No auth needed
- Account data: Wallet address sufficient
- Trading: Local API with signing required
Phase 2: Data Collection
-
For market data:
// Direct HTTP — no auth required
const markets = await fetch('https://zo-mainnet.n1.xyz/info').json();
-
For account data:
// Via local API or SDK
const account = await nord.getAccount(walletAddress);
Phase 3: Safety Validation
- Before any trading action:
- ☐ Verify account health (margin fraction > 10%)
- ☐ Check open orders for conflicts
- ☐ Calculate position impact on margin
- ☐ Confirm funding rate direction
- ☐ Get explicit user confirmation
Phase 4: Execution
- Execute with monitoring:
- Submit order via local API
- Track fill status
- Update position state
- Log all actions
Progressive Disclosure
Read these files when the topic comes up:
Examples Directory
Working code samples in examples/:
Quick Reference
Market IDs Reference
01.xyz uses numeric market IDs (not symbols):
| ID | Market | Max Leverage | Tick Size |
|---|
| 0 | BTCUSD | 20x | $0.50 |
| 1 | ETHUSD | 20x | $0.10 |
| 2 | SOLUSD | 20x | $0.01 |
| 3 | HYPEUSD | 10x | $0.01 |
| ... | See /info endpoint | | |
HTTP Endpoints
Public (no auth):
GET /info # All markets
GET /market/{id}/orderbook # L2 orderbook
GET /market/{id}/stats # 24h stats, funding
GET /trades # Recent trades
Private (requires local API):
GET /account/{address} # Positions, balances
POST /action # Submit orders
Common SDK Operations
import { Nord } from '@n1xyz/nord-ts';
// Initialize
const nord = await Nord.new({
app: 'zoau54n5U24GHNKqyoziVaVxgsiQYnPMx33fKmLLCT5',
solanaConnection: connection,
webServerUrl: 'https://zo-mainnet.n1.xyz',
});
// Get markets
const markets = await nord.getMarkets();
// Get orderbook
const orderbook = await nord.getOrderbook(2); // SOLUSD
// Place order (requires auth)
const order = await nord.placeOrder({
marketId: 2,
side: 'buy',
size: 1.0,
price: 150.00,
orderType: 'limit',
});
Safety & Risk Checklist
Pre-Trading Checklist
☐ Read safety-first.md — Non-custodial reality check
☐ Verify on devnet first — Test all logic with fake funds
☐ Check account health — Margin fraction > 10% (ideally > 20%)
☐ Review funding rates — Can flip PnL significantly
☐ Calculate liquidation price — Know your liquidation level
☐ Set stop-losses — Use trigger orders for downside protection
☐ Confirm market ID — Numeric IDs, not symbols
In-Flight Monitoring
☐ Monitor margin fraction — Alert if < 15%
☐ Track funding payments — Every 8 hours
☐ Watch for liquidations — Cascading effects in volatile markets
☐ Log all operations — Audit trail for debugging
Emergency Procedures
- Approaching liquidation: Reduce position size immediately or add collateral
- API unresponsive: Check local API status, verify network connectivity
- Unexpected fills: Review order history, check for stale orders
- Wrong market ID: Cancel all pending orders, verify symbol mapping
Resources
Official Documentation
SDKs & Tools
Community
- Discord: N1 Exchange Community
- Twitter/X: @01_exchange
Updates
- Version: 1.0.0
- Last Updated: 2026-02-04
- API Version: 2026-01
- Compatibility: N1 Mainnet, Devnet
This Skill follows the OpenClaw Skill Specification. For more information on creating Skills, see the Skill documentation.
