---
title: "Find task-matched x402 tools before payment"
method: POST
path: "/api/tools/x402-tool-router"
tags: ["x402-discovery", "agent-tools", "pre-payment"]
---

# Find task-matched x402 tools before payment

`POST /api/tools/x402-tool-router`

Search fresh strict-ready Ontario paid profiles, Agentic Market, and Coinbase CDP Bazaar. Rank credential-free endpoint metadata by task relevance plus bounded source-reported activity; paid Ontario publication adds no ranking score. Optional network and USDC budget filters fail closed. Candidates are not safety certifications; run preflight before payment.

## Request body

- object
  - `active_only` boolean — Require recent source-reported activity or fresh strict-ready Ontario profile evidence.
  - `limit` integer
  - `max_usdc` string
  - `network` string
  - `query` string, required

## Response `200`

Ranked candidate metadata and preflight instructions

## Other responses

- `400` — Invalid public task or filter
- `502` — Public marketplace source unavailable

---

[API](https://skmtc.net/ontarioprotocol/apis/ontario-protocol-x402-api.md) · [All operations](https://skmtc.net/ontarioprotocol/apis/ontario-protocol-x402-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ontarioprotocol/ontario-protocol-x402-api/revisions/54384a1c4bf3/schema)