agorix
AirdropMarketsCollectionsLeaderboardActivity
Agorix · Decentralized Marketplace
Independent · Resilient · Community-Run

A cross-chain marketplace, run by the community.

Discover, list, and trade across Bitcoin, Ethereum, and Solana on an open, community-run network.

Marketplace
CollectionsMarketsLeaderboardActivity
Network
GovernanceExplorerAirdropDocs
Account
ProfileSettings
Legal
Terms of ServicePrivacy PolicyYour Privacy Choices
agorix.io — Lasting Access
CID: 0xA60R1X · v0.1
AirdropMarketsCollections
D
Protocol Docs
Public APISmart ContractsSecurity ModelOpen SourceRust Node CoreGetting Started (Developer)Benchmarks
Docs/Developer/Public API
Developer

Public API

REST API reference. Public marketplace endpoints, internal agent routes, gossip protocol, and node discovery via .well-known/agent.

#Public API

Every node serves a full REST API independently. The API is split into two tiers: the public marketplace API (read-only, open access) and the internal agent API (node-authenticated, protocol operations).

#Public Marketplace API

Base URL: /api/market/v1/{chain} where {chain} is BTC, ETH, or SOL.

#Collections

text
GET /api/market/v1/{chain}/collections
GET /api/market/v1/{chain}/collections/{id}
GET /api/market/v1/{chain}/collections/{id}/stats

Browse collections with metadata, floor prices, and volume stats. Stats include 24h/7d/30d volume, floor price history, and unique holder count.

#Listings (Asks)

text
GET /api/market/v1/{chain}/asks
GET /api/market/v1/{chain}/asks?status=OPEN
GET /api/market/v1/{chain}/asks?collection={id}
GET /api/market/v1/{chain}/asks?seller={address}
GET /api/market/v1/{chain}/asks?minPrice={sats|wei|lamports}
GET /api/market/v1/{chain}/asks?maxPrice={sats|wei|lamports}

Status-filtered listing queries with collection, seller, and price range filtering.

#Offers (Bids)

text
GET /api/market/v1/{chain}/bids
GET /api/market/v1/{chain}/bids?buyer={address}
GET /api/market/v1/{chain}/bids?listing={outpoint}

Buyer and listing-scoped offer queries.

#Activity

text
GET /api/market/v1/{chain}/activity
GET /api/market/v1/{chain}/activity?kind=SALE
GET /api/market/v1/{chain}/activity?collection={id}
GET /api/market/v1/{chain}/activity?address={address}

Transaction history filtered by event kind (SALE, LIST, DELIST, TRANSFER).

#Token Markets

text
GET /api/market/v1/{chain}/tokens
GET /api/market/v1/{chain}/tokens/{id}
GET /api/market/v1/{chain}/tokens/{id}/history
GET /api/market/v1/{chain}/tokens/{id}/holders

Fungible token boards, price history, and holder distribution.

#Wallets

text
GET /api/market/v1/{chain}/wallets/{address}/listings
GET /api/market/v1/{chain}/wallets/{address}/activity
GET /api/market/v1/{chain}/wallets/{address}/balances

Per-wallet marketplace data: active listings, trade history, token balances.

#Internal Agent API

These routes handle node-to-node protocol operations. All require node authentication (Ed25519 signed request headers).

#Bitcoin Agent Routes

text
POST /api/agent/btc/list          # Submit BTC listing
POST /api/agent/btc/delist        # Cancel BTC listing
POST /api/agent/btc/purchase      # Submit BTC purchase intent
POST /api/agent/btc/validate      # Validate BTC transaction

#EVM Agent Routes

text
POST /api/agent/evm/list          # Submit EVM listing
POST /api/agent/evm/delist        # Cancel EVM listing
POST /api/agent/evm/purchase      # Submit EVM purchase intent
POST /api/agent/evm/validate      # Validate EVM transaction

#Solana Agent Routes

text
POST /api/agent/sol/list          # Submit SOL listing
POST /api/agent/sol/delist        # Cancel SOL listing
POST /api/agent/sol/purchase      # Submit SOL purchase intent
POST /api/agent/sol/validate      # Validate SOL transaction

#PSBT Share Routes

text
POST /api/agent/psbt-share/distribute    # Distribute PSBT shards to cohort
POST /api/agent/psbt-share/store         # Store a shard on this node
POST /api/agent/psbt-share/challenge     # Request reveal challenge
POST /api/agent/psbt-share/reveal        # Retrieve shard with valid challenge
POST /api/agent/psbt-share/coverage      # Query shard coverage status
POST /api/agent/psbt-share/rebalance     # Trigger shard rebalancing

#Gossip Protocol Routes

text
POST /api/gossip/push               # Push protocol events to peer
POST /api/gossip/pull               # Pull events from peer
POST /api/gossip/heartbeat          # Heartbeat exchange
POST /api/gossip/membership         # Membership change notification
POST /api/gossip/sync               # Full state sync request

#Protocol Routes

text
POST /api/protocol/events           # Submit signed protocol event
GET  /api/protocol/events/{id}      # Query event by ID
GET  /api/protocol/state            # Current protocol state snapshot
POST /api/protocol/validate         # Validate event without submitting

#Admin Routes

text
POST /api/admin/governance/propose  # Submit governance proposal
POST /api/admin/governance/vote     # Vote on proposal
POST /api/admin/strikes/issue       # Issue misbehavior strike
GET  /api/admin/health              # Node health status
GET  /api/admin/metrics             # Prometheus-compatible metrics

#Media Routes

text
GET  /api/media/{hash}              # Retrieve cached media by content hash
POST /api/media/upload              # Upload media (rate limited)
GET  /api/media/status/{hash}       # Check media availability across shards

#Node Discovery

text
GET /.well-known/agent
GET /.well-known/agent/fee-addresses?chain=BTC&context=<key>

/.well-known/agent returns the node's public identity plus its advertised capabilities.

Fee address catalogs are fetched separately from /.well-known/agent/fee-addresses so discovery stays small.

json
{
  "nodeId": "node-abc123",
  "agentPubkey": "ed25519:...",
  "foundationFeeAddress": "bc1qfoundation...",
  "capabilities": ["protocol_validate", "ui_quote_service"],
  "protocolVersion": "mvp-1",
  "validatorVersion": "1.0.0"
}

Other nodes use this endpoint during peer discovery and mesh formation.

#Response Format

All public endpoints return paginated responses:

json
{
  "data": [...],
  "pagination": {
    "offset": 0,
    "limit": 20,
    "total": 150
  }
}

#Rate Limiting

TierLimitEscalation
Anonymous60 req/minStandard
Authenticated300 req/minStandard
Abusive (tier 1)Blocked 5 minAfter repeated violations
Abusive (tier 2)Blocked 15 minContinued abuse
Abusive (tier 3)Blocked 60 minPersistent abuse
Abusive (tier 4)Blocked 24h + gossip banBan propagated to all nodes

Rate limit violations trigger escalating cooldowns. At tier 4, the ban is gossiped to all nodes in the network, effectively blocking the client from the entire mesh.

#Notes

  • Read-only public API. No write operations via the public marketplace endpoints.
  • Marketplace state. Returns protocol-computed state, not raw chain data.
  • No auth required for public endpoints. Internal routes require Ed25519 node authentication.
  • Decentralized. Every node serves the full API independently from its own database.
PreviousBurn VotingNext Smart Contracts

On this page

  • Public API
  • Public Marketplace API
  • Collections
  • Listings (Asks)
  • Offers (Bids)
  • Activity
  • Token Markets
  • Wallets
  • Internal Agent API
  • Bitcoin Agent Routes
  • EVM Agent Routes
  • Solana Agent Routes
  • PSBT Share Routes
  • Gossip Protocol Routes
  • Protocol Routes
  • Admin Routes
  • Media Routes
  • Node Discovery
  • Response Format
  • Rate Limiting
  • Notes