Skip to main content
Version: v2

Quick Start Guide

Get started with the Nexchange API in just a few minutes. This guide will walk you through the basic steps to make your first API call and create a simple exchange order.

Prerequisites

API Key is required

API Key is required to use v2 api endpoints

Websocket usage

Prefer to use websockets over polling

Order Status & Processing

Order Status Values

Status CodeStatus NameDescription
0CANCELEDDeposit not received and order expired
11INITIALOrder created, awaiting deposit
12UNCONFIRMED PAYMENTDeposit detected but not confirmed
13PAIDDeposit confirmed
14PRE-RELEASEWithdrawal transaction being created
15RELEASEDWithdrawal transaction broadcasted
16COMPLETEDWithdrawal transaction confirmed
6INITIATED REFUNDOrder refund process initiated
8REFUNDEDOrder refunded successfully
7REFUND FAILEDOrder refund failed
9PENDING KYCWaiting for additional due diligence

Typical order flow

✅ Success Flow:

INITIAL → UNCONFIRMED PAYMENT → PAID → PRE-RELEASE → RELEASED → COMPLETED

❌ Unpaid Flow:

INITIAL → CANCELED

🔍 KYC Success Flow:

INITIAL → UNCONFIRMED PAYMENT → PENDING KYC → PAID → PRE-RELEASE → RELEASED → COMPLETED

🔍 KYC Failure Flow:

INITIAL → UNCONFIRMED PAYMENT → PENDING KYC → INITIATED REFUND → REFUNDED

🔄 Refund Retry Flow:

INITIATED REFUND → REFUND FAILED → INITIATED REFUND → REFUNDED

see more in Orders - Detailed orders endpoint documentation

Next Steps

Need Help?

If you encounter any issues:

  1. Review the documentation thoroughly
  2. Review the full API Reference
  3. Contact our support team for assistance support@n.exchange

Happy trading! 🚀