# Agent Internet Runtime Registry Discovery

> Agent Internet Runtime Registry Discovery is a paid API for AI agents from api.agentinternetruntime.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Discovers agents and capabilities in the Agent Internet Runtime registry matching a natural language intent

## Facts

- Endpoint: POST https://api.agentinternetruntime.com/v1/registry/discover
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-agentinternetruntime-com-5ce88f11
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YhMnN-dPICbCx4yeufngS

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 api-agentinternetruntime-com-5ce88f11 -d '<json body>'
```

Example prompt: Search the Agent Internet Runtime registry for up to 10 agents that can handle real-time cryptocurrency price lookups, sorted by best_value, in the finance domain.

## When to prefer this

Use this endpoint when an AI agent needs to dynamically discover other agents or capabilities at runtime based on a natural language intent, especially when the right downstream service is not known in advance. Prefer this over hardcoded service lookups when the agent ecosystem is dynamic or when cost/speed/reliability tradeoffs need to be made at query time.

## Known failure modes

- Invalid sort enum value returns 400 validation error
- limit exceeding 50 returns 400 bad request
- Missing or empty intent results in low-relevance or empty agent list
- Payment failure (402) if no valid x402 session ticket or direct payment provided
- Network timeout if registry is slow to respond
- No agents found returns empty agents array with count 0

## How this service works

Agent Registry discovery ($0.01/request direct, or $0.003/request via Session Ticket at /v1/billing/tickets)

## Output

Returns a success flag and a data object containing: a count of matched agents, an array of agent objects each with id, name, score, payment details, reputation metadata, and description; plus a list of capabilities_without_agents showing domain, source, capability name, confidence, description, trust score, and execution tier for unagented capabilities.

## Example request

```json
{
 "sort": "best_value",
 "limit": 10,
 "intent": "Find agents that can help with weather forecasting and climate data analysis",
 "domain_hint": "weather"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "enum": [
    "best_value",
    "cheapest",
    "fastest",
    "most_reliable"
   ],
   "type": "string",
   "default": "best_value"
  },
  "limit": {
   "type": "number",
   "default": 10,
   "maximum": 50
  },
  "intent": {
   "type": "string",
   "description": "Natural language description of what you need"
  },
  "domain_hint": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "http",
 "schema": {
  "type": "object",
  "properties": {
   "data": {
    "type": "object",
    "properties": {
     "count": {
      "type": "number"
     },
     "agents": {
      "type": "array",
      "items": {
       "type": "object",
       "properties": {
        "id": {
         "type": "string"
        },
        "name": {
         "type": "string"
        },
        "score": {
         "type": "number"
        },
        "payment": {
         "type": "object"
        },
        "reputation": {
         "type": "object"
        },
        "description": {
         "type": "string"
        }
       }
      }
     },
     "capabilities_without_agents": {
      "type": "array",
      "items": {
       "type": "object",
       "properties": {
        "domain": {
         "type": "string"
        },
        "source": {
         "type": "string"
        },
        "capability": {
         "type": "string"
        },
        "confidence": {
         "type": "number"
        },
        "description": {
         "type": "string"
        },
        "trust_score": {
         "type": "number"
        },
        "execution_tier": {
         "type": "string"
        }
       }
      }
     }
    }
   },
   "success": {
    "type": "boolean"
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-agentinternetruntime-com-5ce88f11/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentinternetruntime.com](https://www.zero.xyz/host/api.agentinternetruntime.com/llms.txt)