PORT66
Agent APITrust-gated · x402

Inventory, machine readable.

Agents don't browse websites. They query structured data, pay per call, and settle on-chain. PORT66 exposes its inventory the way software actually consumes it.

View live manifest OpenAPI spec

Access flow

Three steps to data.

01

Valiron trust check

Agents identify themselves with X-Agent-Id and X-Agent-Address headers. A minimum trust score of 65 is required before paid endpoints respond.

02

x402 payment

Call a paid endpoint without payment and receive a 402 challenge stating the exact amount, network and recipient. Settlement is USDC on Base.

03

API access

Retry with the payment header attached and the endpoint returns structured JSON.

Endpoints

What you can call.

Tokenized inventory reads are free and unauthenticated. Marketplace listing and market data are x402-priced.

GET

/api/agent/v1

Capability manifest: endpoints, pricing, and payment requirements.

Free
GET

/api/agent/v1/listings

Search active marketplace listings by query, brand, category, condition and price.

$0.005
GET

/api/agent/v1/listings/{slug}

Full listing detail: description, condition, images, seller, verification level, and on-chain provenance if anchored.

$0.005
GET

/api/agent/v1/market/{slug}

Market data for a product: price history and market statistics.

$0.01
GET

/api/v1/tokenized-skus

Public tokenized inventory: supply, unit price, contract reference and merchant for every active SKU.

Free
GET

/api/v1/tokenized-skus/{id}

One tokenized SKU with available quantity and its recorded inventory ledger.

Free

Example

Reading inventory.

Request

curl https://port66.xyz/api/v1/tokenized-skus \
  -G -d status=ACTIVE -d limit=2

Response shape

{
  "items": [
    {
      "id": "clx…",
      "merchantSku": "RO-RAMONES-42",
      "unitPriceUsdc": "1250.00",
      "physicalStock": 3,
      "tokenizedStock": 2,
      "chain": "BASE_MAINNET",
      "contractAddress": "0x…",
      "tokenId": "18472",
      "metadataHash": "0x…",
      "product": { "name": "…", "brand": { … } },
      "merchant": { "verified": true, … }
    }
  ],
  "total": 1, "page": 1, "limit": 2
}

Roadmap

Not available yet.

Documented so integrators can plan against them — not served today.

Ownership and transfer queries

Not yet indexed

GET ownership and transfer history require an ERC-1155 event indexer on Base. No endpoint returns holder data today.

Agent purchase actions

Not yet indexed

Agents can read inventory but cannot yet make offers or purchase on behalf of an authorized user. Listed as planned on the live manifest.

Merchant scores and delivery ETA

Not yet indexed

No merchant scoring model or fulfilment-time dataset exists. SKU Scan exposes verification status only.

Redemption status endpoint

Not yet indexed

Redemptions are recorded in the inventory ledger but have no dedicated public read route.

Building on PORT66?

The manifest is the contract. Start there, and check what SKU Scan verifies before you rely on a field.