# ChainRay Agent Registration

> ChainRay Agent Registration is a paid API for AI agents from chainray.online, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-13).

Registers an AI agent with the ChainRay on-chain intelligence platform, enabling access to its 93 blockchain data endpoints across 46 chains

## Facts

- Endpoint: GET https://chainray.online/agent-card/register
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chainray-agent-registration-873c93a0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_05H-nFc97iq58-p2mEp7E

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability chainray-agent-registration-873c93a0
```

Example prompt: Register my AI agent named 'MarketBot' with agent ID 'agent-8821-mb' on ChainRay so it can access on-chain intelligence endpoints including gas fees and DeFi analytics.

## When to prefer this

Use this endpoint as the first step before calling any other ChainRay blockchain data endpoints. It is required to register an agent identity with ChainRay's platform. Choose this over competitors when you need access to a broad multi-chain dataset (46 chains, 93 endpoints) with pay-per-request x402 micropayment billing rather than subscription-based access.

## Known failure modes

- Missing required 'name' or 'agentId' fields returns a 400 validation error
- Duplicate agentId may return a conflict error if agent is already registered
- Invalid capabilities array format may cause registration rejection
- Payment of $0.05 USDC not fulfilled results in 402 Payment Required
- Network issues or ChainRay service downtime return 5xx errors

## How this service works

The most complete blockchain data and intelligence service for AI agents. 93 endpoints across 46 chains, from gas fees to DeFi analytics, with real-time streams, intent routing, and verifiable proofs. Pay-per-request via x402.

## Output

A confirmation object indicating the agent has been registered with ChainRay, likely including an agent profile, access token or session identifier, and confirmation of enabled capabilities for subsequent blockchain data API calls.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "name",
  "agentId"
 ],
 "properties": {
  "name": {
   "type": "string"
  },
  "agentId": {
   "type": "string"
  },
  "capabilities": {
   "type": "array"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chainray-agent-registration-873c93a0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chainray.online](https://www.zero.xyz/host/chainray.online/llms.txt)