APIHub
Back to Explore

NOWPayments API

The NOWPayments API provides programmatic access to cryptocurrency payment processing, including price and minimum‑amount estimates, creation and status tracking of payments, payout verification, sub‑partner balance and transfer management, and management of recurring payment subscriptions and plans.

Finance
none
HTTPS
CORS: Unknown
Description enriched
Visit official documentation

Latency

421ms p95

Uptime

100.0% 30d

Playground

Verified

live

Endpoints

REST · JSON
GET

/v1/estimate

Get estimated price

  • amount (query)
  • currency_from (query)
  • currency_to (query)
  • x-api-key (header)
GET

/v1/min-amount

Get the minimum payment amount

  • currency_from (query)
  • currency_to (query)
  • x-api-key (header)
GET

/v1/payment/

Get list of payments

  • limit (query, limit)
  • page (query, page)
  • sortBy (query)
  • orderBy (query)
  • dateFrom (query)
  • dateTo (query)
  • x-api-key (header)
POST

/v1/payment/{id}/update-merchant-estimate

Get/Update payment estimate

  • x-api-key (header)
GET

/v1/payment/{payment_id}

Get payment status

  • x-api-key (header)
POST

/v1/payout/{withdrawals-id}/verify

Verify payout

  • x-api-key (header)
GET

/v1/sub-partner

Get sub-partners

  • id (query) — int or array of int (optional)
  • offset (query, offset) — (optional) default 0
  • limit (query, limit) — (optional) default 10
  • order (query) — ASC / DESC (optional) default ASC
GET

/v1/sub-partner/balance/{id}

Get sub-partner balance

  • x-api-key (header)
GET

/v1/sub-partner/transfer/{id}

Get transfer

GET

/v1/sub-partner/transfers

Get all transfers

  • id (query) — int or array of int (optional)
  • status (query) — string or array of string "WAITING"/"CREATED"/"FINISHED"/"REJECTED" (optional)
  • limit (query, limit) — (optional) default 10
  • offset (query, offset) — (optional) default 0
  • order (query) — ASC / DESC (optional) default ASC
GET

/v1/subscriptions

Get many recurring payments

  • status (query) — "WAITING_PAY" / "PAID" / "PARTIALLY_PAID" / "EXPIRED"
  • subscription_plan_id (query)
  • is_active (query) — true / false
  • limit (query, limit)
  • offset (query, offset)
  • x-api-key (header)
GET

/v1/subscriptions/plans

Get many plans

  • limit (query, limit) — Number
  • offset (query, offset) — Number
  • x-api-key (header)
GET

/v1/subscriptions/plans/{plan-id}

Get one plan

  • x-api-key (header)
PATCH

/v1/subscriptions/plans/{plan-id}

Update plan

DELETE

/v1/subscriptions/{sub_id}

Delete recurring payment

GET

/v1/subscriptions/{sub_id}

Get one recurring payment

  • x-api-key (header)

16 endpoints auto-detected

curl -X GET \
  "https://api.nowpayments.io/v1/estimate"

api.nowpayments.io · HTTPS only