Xpectrum: own what lives on-chain

Everything on Xpectrum is on-chain and publicly readable. You do not need an API key, an SDK, or the Xpectrum frontend to query a collection, a listing, or a provenance hash. This page covers the view calls you will reach for most.

Endpoints

Network	RPC	Explorer
Mainnet	`https://octra.network/rpc`	`https://octrascan.io`

Xpectrum runs on Octra mainnet.

Calling a view function

View functions are read through contract_call, with the contract address, the method name, an argument array, and a caller address:

curl -X POST https://octra.network/rpc \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "contract_call",
    "params": ["<contract_address>", "get_contract_info", [], "<caller_address>"],
    "id": 1
  }'

Reading raw storage

octra_contractStorage reads a single storage key without calling a function, which is often cheaper and always available:

curl -X POST https://octra.network/rpc \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "octra_contractStorage",
    "params": ["<contract_address>", "total_minted"],
    "id": 1
  }'

Map keys are mapname:key, and nested maps are mapname:k1:k2. So a holder’s balance is balances:<address>.

Mainnet rejects requests that do not look like they came from a browser. Send an Origin and a User-Agent header, or you will get an HTML error page rather than JSON. Check the status code before parsing.

Collection (Xcollection)

The table below is Xcollection v4.0.0. XpectrumGenesis, which Xpectra runs, predates the burn work: its get_contract_info returns seven fields ending at revealed, and it has no total_minted, burned, is_burned or xholder_* views. Check which contract you are reading before you index into a pipe split.

Method	Args	Returns
`get_contract_info`	none	`name\|symbol\|total_supply\|max_supply\|royalty_bps\|owner\|revealed\|burned`
`owner_of`	`token_id`	owner address
`get_token_info`	`token_id`	pipe-delimited token detail
`token_uri`	`token_id`	metadata URI
`royalty_of`	`token_id`	royalty bps
`get_current_phase`	none	active mint phase
`get_phase_info`	none	all three phases, plus `injection_cap` and `xholder_minted_count`
`get_xholder_status`	none	`xholder_minted_count\|injection_cap\|xpectra_contract\|injection_swept`
`has_claimed_xholder`	`wallet`	`1` if that wallet has used its Xholder claim
`total_minted`	none	ids ever minted, monotonic
`burned`	none	count burned
`is_burned`	`token_id`	`1` if burned
`get_provenance_hash`	none	64-char hash, or `""` if unset
`get_holders_page`	`offset, limit`	page of current holders
`get_pending_proceeds`	`addr`	claimable balance

Marketplace (Xmarket)

Method	Args	Returns
`get_market_info`	none	market-level stats
`get_token_listing`	`contract, token_id`	active listing for one token
`get_listings_for_collection`	`contract`	active listings in a collection
`get_listings_page`	`offset, limit`	paginated active listings
`get_offer`	`offer_id`	offer detail, including `offer_is_collection`
`get_total_volume`	none	lifetime settled volume

Verifying a collection

Reading get_provenance_hash() and recomputing it from the collection’s published metadata is enough to confirm a frozen collection was not altered after mint. The xpress CLI automates this end to end (xpress verify <collection_address>). See Provenance for the algorithm.

All contract state is public. A non-empty get_provenance_hash() plus a matching recomputation plus mutability == "frozen_by_provenance" is the full trust basis. You verify it yourself; you do not take our word for it.

Overview

Network

Standards

Contracts

Platform

Developers

Resources

RPC Reference

Endpoints

Calling a view function

Reading raw storage

Collection (Xcollection)

Marketplace (Xmarket)

Verifying a collection

​Endpoints

​Calling a view function

​Reading raw storage

​Collection (Xcollection)

​Marketplace (Xmarket)

​Verifying a collection

Endpoints

Calling a view function

Reading raw storage

Collection (Xcollection)

Marketplace (Xmarket)

Verifying a collection