POST/new_addressAuth required

Create or Get Payment Address

Generates a new payment address to receive payment on your store.

Requires Bearer token authentication. Include Authorization: Bearer YOUR_API_KEY in the request header.

Query Parameters

match_callbackstring

String to match part of your store's callback URL. Used to identify the correct store when you have multiple. Partial matches are supported — you don’t need to provide the full callback URL.

cryptostring enumdefault: "BTC"

Cryptocurrency to use. When USDT, the same address is always returned.

"BTC""USDT"

resetinteger enumdefault: 0

Controls address generation for BTC. 0 (default) = new address, 1 = reuse last address. Ignored for USDT.

01

Responses

Returns a payment-address object

Fetch cryptocurrency price

GET /price

match_callbackquery · string

String to match part of your store's callback URL. Used to identify the correct store when you have multiple. Partial matches are supported — you don’t need to provide the full callback URL.

cryptoquery · string

Cryptocurrency to use. When USDT, the same address is always returned.

resetquery · integer

Controls address generation for BTC. `0` (default) = new address, `1` = reuse last address. Ignored for USDT.

Response will appear here

Request

curl -X POST \
  "https://www.blockonomics.co/api/new_address" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://www.blockonomics.co/api/new_address', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
})

const data = await response.json()
console.log(data)

import requests

headers = {
        "Authorization": "Bearer YOUR_API_KEY"
    }

response = requests.post(
    "https://www.blockonomics.co/api/new_address",
    headers=headers
)

print(response.json())

Response

{
  "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
  "crypto": "BTC",
  "reset": 0,
  "account": "btc_xpub_wallet"
}