// SIGNALBOUND / API

On-chain agent data for builders.

The Signalbound API provides readable access to reveal state, token identity, ERC-8004 registration files, and holder-gated tool routes built around the collection.

Base URL https://api.signalbound.art

Network Ethereum Mainnet

Collection Signalbound ERC-721

Modes Public + gated tool reads

Public routes are open for token and agent discovery. Tool routes may enforce NFT ownership, reveal state, and clearance gating before returning mission or utility data.

Quick Start

Use the API root for documentation, then call the endpoint you need directly.

curl https://api.signalbound.art/healthz

curl https://api.signalbound.art/agents/info/1

curl https://api.signalbound.art/agents/1/binding

curl "https://api.signalbound.art/intel?tokenId=1"

Core Endpoints

GET /healthz application/json

Simple health check for uptime and deployment monitoring.

{
  "ok": true,
  "service": "api"
}

GET /agents/info/:tokenId application/json

Returns the public identity record for a revealed agent, including on-chain trait labels, rarity context, and registration-aware metadata.

curl https://api.signalbound.art/agents/info/1

GET /.well-known/agents/:tokenId.json application/json

ERC-8004 registration file for a token-bound agent. This route is designed for wallet, registry, and agent discovery flows.

curl https://api.signalbound.art/.well-known/agents/1.json

GET /agents/:tokenId/binding application/json

Live ERC-8217 / Adapter8004 binding status for a Signalbound token. The register page uses this route after wallet transactions so binding state survives refreshes and deploys.

curl https://api.signalbound.art/agents/1/binding

Tool Routes

These routes are tied to Signalbound’s tool surface. Some are open reads, some are intended to respect clearance and ownership checks in the runtime path.

GET /intel application/json

Returns identity and mission-facing summary data for a token.

curl "https://api.signalbound.art/intel?tokenId=1"

GET /drop-radar application/json

Drop-facing route for collection status, reveal timing, and event context.

GET /portfolio application/json

Holder-side route for token grouping, arena context, and account summary.

GET /allowlist-scan application/json

Allowlist lookup surface intended for higher-clearance holder workflows.

GET /offer-radar application/json

Offer-oriented route for live market and token-level opportunity views.

GET /dispatch application/json

Mission or action queue route for post-reveal arena and operator flows.

Response Rules

Public reads return JSON by default.
Unknown routes return a standard 404 JSON response.
Restricted tool routes may return gating errors when ownership or clearance is missing.
API consumers should treat on-chain reveal state as the source of truth.

Service Surface

Route family	Purpose
`/agents/*`	Agent identity, registration, and profile surfaces.
`/.well-known/agents/*`	Machine-readable ERC-8004 registration files.
`/intel`, `/drop-radar`, `/portfolio`	Baseline holder tool routes.
`/allowlist-scan`, `/offer-radar`, `/dispatch`	Higher-clearance tool routes and mission surfaces.