Services API

List / Search Services

GET /api/services

Query Parameters

Parameter	Type	Description
query	string	Full-text search keyword
category	string	Category ID filter
chain	string	Supported chain filter
status	string	verified | unverified | inactive
maxPricePerRequest	string	Max price filter
sortBy	string	price | trustScore | name
sortOrder	string	asc | desc
limit	number	Results per page (default: 20, max: 100)
offset	number	Pagination offset

Response

[
  {
    "id": "svc-neural-api-1",
    "name": "NeuralAPI",
    "description": "AI image generation via x402",
    "endpoint": "https://api.neural.example.com",
    "category": "cat-ai",
    "pricing": {
      "currency": "USD",
      "pricePerRequest": "0.003",
      "freeQuota": 10
    },
    "x402Config": {
      "paymentAddress": "0x...",
      "network": "base"
    },
    "trustScore": 85,
    "status": "verified",
    "supportedChains": ["base"],
    "createdAt": "2026-02-26T10:00:00Z",
    "updatedAt": "2026-02-26T12:00:00Z"
  }
]

---

Get Service Detail

GET /api/services/:id

Returns the full service object (same schema as list).

404 if service not found.

---

Get Service Status

GET /api/services/:id/status

Response

{
  "id": "svc-neural-api-1",
  "trustScore": 85,
  "status": "verified",
  "uptimeScore": 99.2,
  "lastChecked": "2026-02-26T12:00:00Z",
  "txCount": 142,
  "totalRevenue": 0.426
}

---

Register Service

POST /api/services
Authorization: Bearer <API_KEY>

Request Body

Field	Type	Required	Description
name	string	Yes	Service name (1-255 chars)
description	string	Yes	Description (1-2000 chars)
endpoint	string	Yes	API base URL
category	string	Yes	Category ID
pricing	object	Yes	Pricing configuration
pricing.currency	string	Yes	Currency code
pricing.pricePerRequest	string	Yes	Price per request
pricing.freeQuota	number	No	Free request quota
x402Config	object	Yes	x402 payment configuration
x402Config.paymentAddress	string	Yes	Wallet address
x402Config.network	string	Yes	Blockchain network

Response

201 Created — returns the created service object. 401 Unauthorized — missing or invalid API key.