---
title: "Find a live x402 API for a task"
method: POST
path: "/api/x402/find-api"
---

# Find a live x402 API for a task

`POST /api/x402/find-api`

## Request

- Base URL: `https://ontarioprotocol.com`
- URL: `https://ontarioprotocol.com/api/x402/find-api`
- Auth: none required

Live API finder for one task: up to 5 paid x402 APIs that answered a fresh unpaid probe with a valid Base USDC 402, ranked by task fit, price and Bazaar-reported repeat buyers, each with live price, network and a ready-to-call request. Provider calls are paid separately. 0.005 USDC on Base; the search runs before settlement, and no live match means no charge.

## Request body

- object
  - `limit` integer
  - `max_usdc` string
  - `task` string, required

## Response `200`

Live-verified APIs for the task; the payment settled

- object
  - `count` integer, required
  - `funnel` object, required
  - `results` object[], required
    - `buyer_signal` object, required
    - `endpoint` string, required
    - `how_to_call` object, required
    - `live_check` object, required
    - `method` string, required
    - `price_usdc` string, required
    - `rank` integer, required
  - `schema` 'ontario.x402_api_finder.v1', required
  - `status` 'ok', required
  - `trust_boundary` string, required

## Other responses

- `400`: Signed request refused before settlement; no payment taken
- `402`: x402 payment challenge
- `404`: No live match found; payment not settled

## Changes

- **2026-10-25** `c4bb7fd32b2f`: 1 info
  - added the media type `application/json` for the response with the status `200`
- **2026-10-18** `cda9f4b69af0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ontarioprotocol/apis/ontario-protocol-x402-api/changes/api/x402/find-api/post.md)

---

[API](https://skmtc.dev/ontarioprotocol/apis/ontario-protocol-x402-api.md) - [All operations](https://skmtc.dev/ontarioprotocol/apis/ontario-protocol-x402-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ontarioprotocol/apis/ontario-protocol-x402-api/revisions/c4bb7fd32b2f?raw)