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.