# Nowpayments — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Accept cryptocurrency payments and create invoices with real-time price estimation across multiple currencies. Check payment status, retrieve transaction details, and query account balances through a single integration.

**Category:** Web3 & Onchain | **Website:** [nowpayments.io/](https://nowpayments.io/) | **Docs:** [parse.bot/marketplace/6330b7d0-1fe7-49bb-bc4a-9bdd910223d2/nowpayments-io-api](https://parse.bot/marketplace/6330b7d0-1fe7-49bb-bc4a-9bdd910223d2/nowpayments-io-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-nowpayments-io-api-6330b7d0/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### create_invoice

Create a payment link/invoice for customers. Requires API key.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `api_key` | string | Yes | NOWPayments API key |
| `order_description` | string | No | Order description |
| `order_id` | string | No | Order identifier from the calling system |
| `pay_currency` | string | No | Cryptocurrency to pay with |
| `price_amount` | number | Yes | Invoice amount |
| `price_currency` | string | Yes | Price currency code (e.g., 'usd') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nowpayments-io-api-6330b7d0/create_invoice \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api_key":"<string>","order_description":"<string>","order_id":"<string>","pay_currency":"<string>","price_amount":"<number>","price_currency":"<string>"}'
```

### create_payment

Create a new cryptocurrency payment. Requires API key.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `api_key` | string | Yes | NOWPayments API key |
| `customer_email` | string | No | Customer email address |
| `order_description` | string | No | Order description |
| `order_id` | string | No | Order identifier from the calling system |
| `pay_currency` | string | No | Cryptocurrency to pay with |
| `price_amount` | number | Yes | Payment amount |
| `price_currency` | string | Yes | Price currency code (e.g., 'usd') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nowpayments-io-api-6330b7d0/create_payment \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api_key":"<string>","customer_email":"<string>","order_description":"<string>","order_id":"<string>","pay_currency":"<string>","price_amount":"<number>","price_currency":"<string>"}'
```

### get_api_status

Check NOWPayments API availability and health. Returns a message indicating the API is operational. No parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nowpayments-io-api-6330b7d0/get_api_status \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_available_currencies

Get a list of all available cryptocurrency ticker symbols supported by NOWPayments for payments. Returns an array of lowercase currency code strings. No authentication required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nowpayments-io-api-6330b7d0/get_available_currencies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_estimated_price

Get estimated conversion rate for a given amount between two currencies. Requires API key.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `amount` | number | Yes | Amount to convert |
| `api_key` | string | Yes | NOWPayments API key |
| `currency_from` | string | Yes | Source currency code |
| `currency_to` | string | Yes | Destination currency code |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nowpayments-io-api-6330b7d0/get_estimated_price \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount":"<number>","api_key":"<string>","currency_from":"<string>","currency_to":"<string>"}'
```

### get_full_currencies

Get detailed information about available cryptocurrencies, including limits and logos. Requires API key.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `api_key` | string | Yes | NOWPayments API key |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nowpayments-io-api-6330b7d0/get_full_currencies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api_key":"<string>"}'
```

### get_minimum_payment_amount

Get the minimum payment amount for a specific currency pair. Requires API key.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `api_key` | string | Yes | NOWPayments API key |
| `currency_from` | string | Yes | Source currency code (e.g., 'btc') |
| `currency_to` | string | Yes | Destination currency code (e.g., 'eth') |
| `fiat_equivalent` | string | No | Fiat currency for equivalent |
| `is_fee_paid_by_user` | string | No | Whether fee is paid by user (true/false) |
| `is_fixed_rate` | string | No | Whether to use fixed rate (true/false) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nowpayments-io-api-6330b7d0/get_minimum_payment_amount \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api_key":"<string>","currency_from":"<string>","currency_to":"<string>","fiat_equivalent":"<string>","is_fee_paid_by_user":"<string>","is_fixed_rate":"<string>"}'
```

### get_payment_status

Get current status and details of a specific payment. Requires API key.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `api_key` | string | Yes | NOWPayments API key |
| `payment_id` | string | Yes | Payment ID to check |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nowpayments-io-api-6330b7d0/get_payment_status \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api_key":"<string>","payment_id":"<string>"}'
```