BlockonomicsAPI Reference
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_callbackstringrequired

String used to match part of your callback URL to identify the correct wallet. Partial matches are supported — you don’t need to provide the full callback URL.

cryptostring enumdefault: "BTC"

Optional. The cryptocurrency to use. Supported values: BTC, USDT. Defaults to BTC. When set to USDT, the same payment address will always be returned for the store (address is not regenerated).

"BTC""USDT"
resetinteger enumdefault: 0

Decides whether you get a new BTC address or the same one again. - 0 (default): Creates a new BTC address by moving to the next index. - 1: Reuses the most recent BTC address without moving forward. Only 0 or 1 are valid values. Values like true/false are not accepted. For USDT, this setting is ignored because the same fixed address is always returned.

01

Responses

addressstring

Generated payment address.

cryptostring

The cryptocurrency used for the address. Defaults to BTC if omitted. When set to USDT, the same payment address will always be returned for the store (address is not regenerated).

resetinteger

Indicates if the index was reset.

accountstring

Source xPub (wallet).

You must log in to Blockonomics to send request.

match_callbackquery · stringrequired

String used to match part of your callback URL to identify the correct wallet. Partial matches are supported — you don’t need to provide the full callback URL.

cryptoquery · string

Optional. The cryptocurrency to use. Supported values: BTC, USDT. Defaults to BTC. When set to USDT, the same payment address will always be returned for the store (address is not regenerated).

resetquery · integer

Decides whether you get a new BTC address or the same one again. - 0 (default): Creates a new BTC address by moving to the next index. - 1: Reuses the most recent BTC address without moving forward. Only 0 or 1 are valid values. Values like true/false are not accepted. For USDT, this setting is ignored because the same fixed address is always returned.

Response will appear here