non-standard-utxos

Query revisions by module specifier, public key, limit, order, offset and list of transaction ids.

Endpoint

/v1/CHAIN/NETWORK/non-standard-utxos

Query Parameters

Parameter Type Description
mod string Optional filter.
publicKey string Optional filter by public key.
limit string Maximum number of results to return.
offset string Number of results to skip (for pagination).
order string Sort order: ASC or DESC.

Notes:

  • BCN_QUERY_LIMIT is configurable in your .env file. If set, any limit exceeding this value will throw a validation error.

Example

Requests

curl -X GET http://localhost:1031/v1/LTC/regtest/non-standard-utxos?publicKey=02e3b0...
curl -X GET http://localhost:1031/v1/LTC/regtest/non-standard-utxos?publicKey=02e3b0...&mod=af19fa7...
curl -X GET http://localhost:1031/v1/LTC/regtest/non-standard-utxos?publicKey=02e3b0...&mod=af19fa7...&limit=10
curl -X GET http://localhost:1031/v1/LTC/regtest/non-standard-utxos?ids=%5B%224446faf2ea02713580152f2355bc91e2eac3649c85e38d882e1ca795bb7b1494%3A0%22%5D

Response

Success (200)

["4446faf2ea02713580152f2355bc91e2eac3649c85e38d882e1ca795bb7b1494:0"]

Validation errors (400)

{ "error": "Can't fetch more than 1000 revs." }
{ "error": "Invalid order. Should be ASC or DESC." }

Server error (500)

{ "error": "Internal server error message" }