List Discovery Resources

curl --request GET \
  --url https://api.example.com/v1/discovery/resources

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/v1/discovery/resources",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/discovery/resources"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/v1/discovery/resources")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

GET

discovery

resources

List Discovery Resources

curl --request GET \
  --url https://api.example.com/v1/discovery/resources

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/v1/discovery/resources",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/discovery/resources"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/v1/discovery/resources")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

Public, unauthenticated endpoint that returns every offer with is_published=true and status=active on this AXON instance. Other AXON instances, x402 facilitators, and agent discovery tools poll this endpoint to build a cross-instance discovery feed.

This endpoint is deliberately public — no auth header required. It serializes to the same resource shape that AXON’s internal provider-sync.ts consumes, so the feed is immediately consumable by external facilitators.

Request

GET /v1/discovery/resources?limit=100&offset=0&sort=score

Query parameters

Param	Default	Description
`limit`	100	Max resources per page (capped at 1000)
`offset`	0	Pagination offset
`sort`	`score`	`score` ranking or `recent` (by `published_at` DESC)

Response

{
  "items": [
    {
      "resource": "https://api.axon402.com/o/market-snapshots-a1b2c3d4",
      "type": "http",
      "method": "GET",
      "x402Version": 2,
      "description": "Real-time market data for Base network tokens",
      "lastUpdated": "2026-04-11T10:30:00Z",
      "metadata": {
        "name": "Market Snapshots API",
        "description": "Real-time market data for Base network tokens",
        "category": "finance",
        "tags": ["defi", "markets"],
        "tagline": "Real-time data for agents",
        "icon_url": "https://yourservice.com/icon.png",
        "demo_url": "https://yourservice.com/demo",
        "links": [{"label": "Docs", "url": "https://yourservice.com/docs"}],
        "screenshots": ["https://yourservice.com/screenshot1.png"]
      },
      "accepts": [
        {
          "scheme": "exact",
          "network": "eip155:8453",
          "payTo": "0xabc...",
          "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
          "amount": "10000",
          "maxTimeoutSeconds": 30
        }
      ],
      "score": 0.72
    }
  ],
  "pagination": {
    "limit": 100,
    "offset": 0,
    "total": 1,
    "sort": "score"
  }
}

Response notes

resource is the paid URL buyers should call.
Proxied/BYO offers emit their configured resource_url.
type is currently http.
lastUpdated is published_at when present, otherwise updated_at.
metadata contains provider-authored listing fields.
accepts[0] describes the exact x402 payment requirement for the offer.
score is optional. When ?sort=score, unscored offers sort after scored ones.

Invalid sort values return:

{
  "code": "VALIDATION_ERROR",
  "message": "sort must be one of: score, recent",
  "recoverable": false
}

Cache headers

Responses include Cache-Control: public, max-age=30. Downstream facilitators should respect this.

Example — fetch top 5 by score

curl "https://api.axon402.com/v1/discovery/resources?limit=5&sort=score"

Example — fetch recent files only (client-side filter)

curl "https://api.axon402.com/v1/discovery/resources?limit=100&sort=recent" \
  | jq '.items[] | select(.metadata.category == "data")'

Overview

Onboarding

Core Spend

Approvals

Organizations

Treasury

Providers

Discovery

Workers & Observability

MCP Tools

Reference

List Discovery Resources

Request

Query parameters

Response

Response notes

Cache headers

Example — fetch top 5 by score

Example — fetch recent files only (client-side filter)

​Request

​Query parameters

​Response

​Response notes

​Cache headers

​Example — fetch top 5 by score

​Example — fetch recent files only (client-side filter)

Request

Query parameters

Response

Response notes

Cache headers

Example — fetch top 5 by score

Example — fetch recent files only (client-side filter)