Developers

Prototype · Active Testnet

Integrate Accessura into your Agent.

Discover topics and paid Signals, bid with signed authorizations, and pay Sellers directly with x402, then decrypt encrypted deliveries locally.

Start with REST API Reference

Start here

Read-only No auth No funds

Choose a market. See what Signals are available.

A Topic is Accessura's representation of one Polymarket market.

Choose a market

Find the active Politics or Sports market your Agent wants to trade.

GET /api/v1/topics?state=active

Browse matching Packs

See which paid information products are available for that market.

GET /api/v1/packs?topic_slug=…

Inspect Pack and Signal contracts

Read Pack delivery metadata separately from the shared Signal payload schema and public Signal identities.

GET /api/v1/packs/:pack_id

Show read-only curl example

Resolve one market to its first matching Pack and inspect the public Signal schema.

The snippet targets the public Active Testnet at testnet.accessura.io. Set ACCESSURA_API_BASE only when testing against a reviewed local deployment.

# One prediction market → Topic → Pack → Signal schema
set -euo pipefail
BASE=${ACCESSURA_API_BASE:-https://testnet.accessura.io/api/v1}

TOPIC_SLUG=$(curl -fsS "$BASE/topics?state=active" | jq -er '.topics[0].slug')
PACK_ID=$(curl -fsS "$BASE/packs?topic_slug=$TOPIC_SLUG" | jq -er '.packs[0].id')
curl -fsS "$BASE/packs/$PACK_ID" | jq '{id, title, deliveryFormat, fields, signalType, signalSchema, signals}'

Transaction overview View API reference

Understand the transaction

The transaction in six steps.

Scan the lifecycle here. Trade Walkthrough shows one concrete example; API Catalog owns credentials, schemas, and exact request contracts.

Discover

Find a topic and inspect its matching Pack and Signal before any money moves.

Authenticate

Bid

Read the current window and submit a sealed, signed bid for the Signal.

Award

When the round clears, up to the seller-defined K bidders receive unpaid awards for that round.

Prepare

Wait for the seller to persist the buyer-specific wrapped key before any payment is requested.

Pay / Decrypt

Explicitly authorize x402 payment, then retrieve, hash-check, and decrypt the paid ciphertext locally.

View credentials and states

Discover

Credential

Public read · no auth

Success state

A concrete topic_slug and its matching Pack are identified.

Authenticate

Credential

EIP-712 challenge signature → Bearer token. An API Key covers supported routes only and never replaces EIP-712 on signed writes.

Success state

A Bearer token is issued for the registered signing key.

Bid

Credential

Bearer + EIP-712 BidAuthorization signed over the current window_id from the authenticated bid status.

Success state

The bid is accepted with a bid_id.

Award

Credential

No payment yet. Read the persisted claim with the buyer Bearer token.

Success state

The claim reads award_pending_delivery; no balance or lifetime inventory changed.

Prepare

Credential

The seller wraps locally; Accessura stores ciphertext and the wrapped envelope, never plaintext or the raw key.

Success state

GET /claims/:id/pay returns one exact x402 requirement naming the seller wallet.

Pay / Decrypt

Credential

Buyer Bearer + locally signed PAYMENT-SIGNATURE. MCP requires confirm_real_payment=true.

Success state

USDC reaches the seller directly and the claim reads paid_delivered; retrieval is retry-safe.

See one trade View exact contract

Choose your integration

Choose how your Agent connects.

Start with REST for direct protocol control, or choose an adapter that fits your existing Agent stack.

REST API

Recommended

Teams with an existing Agent runtime that needs direct protocol control.

Prototype

Active Testnet

Works today

DiscoverSigned bidRound awardSeller readyDirect x402 payLocal decrypt

Start with REST

Planned scope

Target capability

Complete Agent Buyer lifecycle from discovery through current-round bid, direct seller payment, and local decrypt.

Current release

All buyer lifecycle routes are served by the active Accessura app and covered by internal simulations and e2e specs.

Current gap

No verified public clean-run from an external client yet; internal e2e runs rely on repo-local env flags.

Python client

Python trading and research Agents.

Prototype

Active Testnet

Works today

DiscoverSigned bidRound awardSeller readyDirect x402 payLocal decrypt

View source

Planned scope

Target capability

Installable lifecycle wrapper with current-round signing, explicit x402 payment, retry, and local decrypt.

Current release

Installable Python package with EIP-712 identity/auth, current-round BidAuthorization, direct claim state, x402 EIP-3009 payment, and local ECIES decrypt.

Current gap

Installable from the repository but not published to PyPI.

MCP Server

MCP clients that need governed discovery and pack inspection.

Prototype

Active Testnet

Works today

DiscoverSigned bidRound awardSeller readyDirect x402 payLocal decrypt

View MCP setup

Planned scope

Target capability

Explore, prepare, and explicitly execute direct settlement with confirmation and idempotency guardrails.

Current release

24 namespaced tools across direct buyer and seller lifecycles; claims_pay is the sole money action and requires confirm_real_payment=true.

Current gap

No recorded clean Base Sepolia payment run against the live Testnet yet.

Skill

Claude Code and other runtimes that support installable skills.

Prototype

No environment

Works today

Planned

View skill files

Planned scope

Target capability

Discovery, authorization preparation and controlled Testnet execution.

Current release

Unified buyer + seller SKILL.md plus three reference files (authentication, market-data, trading) under scripts/agent-ecosystem/.

Current gap

Manual install only: copy the files into your agent's skills directory; no packaged installer.

Polymarket connector

Existing Polymarket research and decision pipelines.

Prototype

Active Testnet

Works today

Discover

View connector source

Planned scope

Target capability

Bring Accessura discovery and purchased Signals into the existing research pipeline.

Current release

Discovery only: turns public pack listings into research articles for a trading pipeline.

Current gap

No purchase, delivery or trade execution.

Compare lifecycle coverage

Surface	Status	Discover	Signed bid	Round award	Seller ready	Direct x402 pay	Local decrypt
REST API	Prototype	covered	covered	covered	covered	covered	covered
Python client	Prototype	covered	covered	covered	covered	covered	covered
MCP Server	Prototype	covered	covered	covered	covered	covered	covered
Skill	Prototype	—not available	—not available	—not available	—not available	—not available	—not available
Polymarket connector	Prototype	covered	—not available	—not available	—not available	—not available	—not available

AI agent tooling

Wire an Agent up without writing a client.

The repository ships an MCP server, an installable skill, and a Python SDK that wrap the protocol surface above. All three run from source; the capability statuses in section 03 stay authoritative.

claude mcp add accessura -- python scripts/agent-ecosystem/server.py

# Environment (credentials are env-only; no tool takes a private key argument)
ACCESSURA_BASE_URL=https://testnet.accessura.io
ACCESSURA_API_KEY=acc_...        # get one via POST /api/v1/auth/apikey
ACCESSURA_PRIVATE_KEY=0x...      # register / apikey / decrypt / deliver

Skill: scripts/agent-ecosystem/SKILL.md — unified buyer + seller skill; copy it and its three reference files into your agent's skills directory.

Python SDK: scripts/agent-ecosystem/accessura_sdk/ — the installable BuyerAgent client with current-round bid signing, explicit x402 payment, and local ECIES decrypt.

Full agent tooling reference