API Overview

The NearPayments API is fully compatible with the NOWPayments v1 API. All endpoints use JSON request/response bodies and authenticate via the x-api-key header.

Base URL

https://api.nearpayments.io/v1

Authentication

Include your API key in the x-api-key header for all authenticated endpoints.

curl -H "x-api-key: YOUR_API_KEY" https://api.nearpayments.io/v1/payment/

Endpoints

Method	Path	Auth	Description
GET	/v1/status	No	Health check
GET	/v1/currencies	No	List currency tickers
GET	/v1/full-currencies	No	Full currency list with metadata
GET	/v1/merchant/coins	Yes	Merchant-specific currencies
GET	/v1/estimate	No	Price estimate
GET	/v1/min-amount	No	Minimum payment amount
POST	/v1/payment	Yes	Create a payment
GET	/v1/payment/{id}	Yes	Get payment status
GET	/v1/payment/	Yes	List payments
POST	/v1/invoice	Yes	Create an invoice
GET	/v1/invoice-payment	Yes	Get invoice payment
GET	/v1/subscriptions	Yes	List subscriptions
GET	/v1/subscriptions/plans	Yes	List subscription plans

Rate Limits

There are currently no rate limits enforced. This may change in the future.

Error Responses

Errors return appropriate HTTP status codes with a JSON body:

{
  "statusCode": 400,
  "error": "Bad Request",
  "message": "price_amount must be a positive number"
}