01-exchange-skill(not official)

AI-powered 01.xyz exchange development skill for monitoring, trading strategies, and N1 blockchain integration. Covers REST API (FTX-inspired), Nord.ts SDK (@n1xyz/nord-ts), non-custodial trading patterns, and market making on Solana.

Audits

Pending

ClawScanPass

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPending

Multi-engine malware detections and file reputation.

Install

openclaw skills install 01-exchange-kill

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 stats
- ACCOUNT — Position/balance queries
- TRADING — Order placement, strategy execution
- RISK — 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:

File	Read When	Safety Level
safety-first.md	FIRST — before anything else	⚠️ Mandatory
monitoring-guide.md	Getting market data, checking prices	✅ Safe
risk-management.md	Managing leverage, liquidation risk	✅ Read-only
trading-basics.md	Understanding order types, markets	⚠️ Gated
sdk-reference.md	Setting up Nord.ts SDK	✅ Documentation
README.md	Project overview, installation	✅ General

Examples Directory

Working code samples in examples/:

monitor-wallet.js — Read-only wallet monitoring
check-funding-rates.js — Market analysis
simple-order.js — Basic order placement (requires local API)

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

01.xyz: https://01.xyz
Developer Docs: https://docs.01.xyz
API Reference: https://api.01.xyz
N1 Blockchain: https://docs.n1.xyz

SDKs & Tools

Nord TypeScript: npm install @n1xyz/nord-ts
Nord Python: pip install n1-sdk
GitHub: https://github.com/n1-exchange

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.