Developers
Programmatic access to vault data, unsigned transactions, user positions, and builder-code reporting.
Neutral Trade provides a v2 REST API, a TypeScript SDK, and a Solana program IDL.
REST base URL: https://api.neutral.trade
Interactive OpenAPI: api.neutral.trade/docs
Machine-readable OpenAPI: https://api.neutral.trade/openapi.json
The running OpenAPI document is authoritative for exact parameters, response fields, and status codes. These pages explain credential boundaries, financial meaning, and integration invariants.
Start with the relevant guide
Access & authentication explains public routes, partner keys, and wallet sessions.
API conventions covers integer amounts, freshness, pagination, and transaction-builder responses.
Vault & user data explains configuration, performance, balances, and activity.
Builder-code data explains tiers, attributed users, earnings, history, and payouts.
Migrating from the legacy API maps numeric v1 vault IDs and instruction builders to v2.
Integration guide implements a strict attributed first deposit.
Reference implementation — a small Next.js app showing all three integration paths against Neutral Autopilot.
Transactions
The REST API builds unsigned deposit and withdrawal transactions:
POST /v2/vault/{vaultAddress}/tx/depositPOST /v2/vault/{vaultAddress}/tx/withdraw
Both are public, CORS-enabled, and metered by IP. The response provides an unsigned transactionBase64 and equivalent instructions[]. The server never signs or submits.
Use the TypeScript SDK when you need direct RPC state checks, program instruction composition, registration plans, or builder claim helpers.
IDL
The current Anchor IDL includes the live builder tier configuration and referred-net-deposit state. Use it to decode accounts and events or construct program interactions directly.
ntbundle.jsonis the JSON IDL.ntbundle.tsis the typed TypeScript IDL.
Support
For keys and integration help, contact @NeutralTradeWill on Telegram.
Last updated