Pricing & Rates

Get real-time pricing and rate information for trading pairs on Nexchange.

Fetch Rates for Trading Pairs (RFQ - Recommended)

The bulk rates endpoint provides optimized rates for trading pairs and is the recommended method for rate fetching.

Request

GET /info/bulk/

Query Parameters:

Parameter	Type	Required	Description
pairs	string	No	Comma-separated list of trading pairs (e.g., BTCETH,BTCEUR). Returns all pairs if omitted

Headers:

Header	Required	Description
x-referral-token	No	Referral token for identification

Response

Returns an array of rate objects with comprehensive pricing information.

Response Fields:

Field	Type	Description
pair	string	Trading pair name
rate_id	string	Unique rate identifier for order creation
from	string	Source currency
to	string	Target currency
rate	string	Base rate excluding payment method fees
withdrawal_fee	string	Withdrawal fee amount
max_amount	string	Maximum tradeable amount
min_amount	string	Minimum tradeable amount
max_receive_amount	string	Maximum amount you can receive
min_receive_amount	string	Minimum amount you can receive
max_deposit_amount	string	Maximum deposit amount
min_deposit_amount	string	Minimum deposit amount
expiration_time_unix	integer	Expiration time in Unix timestamp
allowed_historic_price_variance	boolean	Whether historical price variance is allowed
allowed_historic_price_age	boolean	Whether historical price age is considered

Example Response:

[
  {
    "pair": "XVGUSD",
    "rate_id": "PWKQ1KG",
    "from": "USD",
    "to": "XVG",
    "rate": "0.00597474",
    "withdrawal_fee": "1.00",
    "max_amount": "30000.0",
    "min_amount": "1170.599099",
    "max_receive_amount": "30000.0",
    "min_receive_amount": "1170.599099",
    "max_deposit_amount": "5000",
    "min_deposit_amount": "50"
  },
  {
    "pair": "BTCUSD",
    "rate_id": "PH7KAQ3",
    "from": "USD",
    "to": "BTC",
    "rate": "9636.68",
    "withdrawal_fee": "0.0002",
    "max_amount": "0.9748937",
    "min_amount": "0.001",
    "max_receive_amount": "0.9748937",
    "min_receive_amount": "0.001",
    "max_deposit_amount": "5000",
    "min_deposit_amount": "50"
  }
]

Fetch Current Price for a Given Amount and Pair

Get detailed pricing for a specific amount and trading pair.

Request

GET /get_price/{pair}/

Path Parameters:

Parameter	Type	Required	Description
pair	string	Yes	Trading pair (e.g., BTCEUR, BTCETH)

Query Parameters:

Parameter	Type	Required	Description
amount_base	number	No*	Base amount for calculation
amount_quote	number	No*	Quote amount for calculation

*One of amount_base or amount_quote is required.

Headers:

Header	Required	Description
x-referral-token	No	Referral token for identification

Response

Returns detailed pricing information for the specified amount.

Response Fields:

Field	Type	Description
amount_base	number	Amount of base currency user gets
amount_quote	number	Amount of quote currency user sends
timestamp	number	Unix timestamp
price	number	Price (amount_quote / amount_base)
pair	object	Pair object with base and quote properties
max_amount_base	number	Maximum base amount user can get
max_amount_quote	number	Maximum quote amount user can send
min_amount_base	number	Minimum base amount user can get
min_amount_quote	number	Minimum quote amount user can send

Example Response:

{
  "amount_base": 1.06935074,
  "amount_quote": 100.0,
  "timestamp": 1532432055.609627,
  "price": 93.52884297,
  "pair": {
    "base": "BTC",
    "quote": "LTC"
  },
  "max_amount_base": 3.20049466,
  "max_amount_quote": 300.0,
  "min_amount_base": 0.001,
  "min_amount_quote": 0.14019423
}

Get Latest Price

Get the latest market price data for a trading pair.

Request

GET /price/{pair}/latest/

Path Parameters:

Parameter	Type	Required	Description
pair	string	Yes	Trading pair name (e.g., BTCLTC)

Query Parameters:

Parameter	Type	Required	Description
market_code	string	No	Price market code. Default is "nex"

Response

Returns latest price data.

Example Response:

[
  {
    "created_on": "2017-08-15T12:45:01.443265Z",
    "unix_time": "1502801101",
    "ticker": {
      "ask": "97.06196063",
      "bid": "96.33558341"
    },
    "market": {
      "name": "n.exchange",
      "code": "nex"
    }
  }
]

Error Responses

400 Bad Request

Returned for invalid or empty pairs parameter.

Example:

{
  "detail": "Invalid pairs parameter"
}

401 Unauthorized

Example:

{
  "detail": "Authentication credentials were not provided"
}

404 Not Found

Returned when no pairs are found or pair doesn't exist.

Example:

{
  "detail": "No trading pairs found"
}

Pair not found:

{
  "detail": "pair does not exist"
}

Next Steps

• Orders - Create orders using rate information
• Trading Pairs - Learn about available pairs
• Currencies - Understand individual currencies