Beauty & Personal Care · x402 · early usage

Inline every local `$ref` in an OpenAPI 3.x or Swagger 2.x document so downstream tools…

by agent402.tools · discovered, not yet claimed by its owner · updated 2026-09-30

30d calls2

30d payers2

MethodPOST

Outputjson

Mirrored from Coinbase's public x402 Bazaar. The description is the provider's own text and has not been reviewed here; the payment requirements are copied as published.

What it does

Inline every local `$ref` in an OpenAPI 3.x or Swagger 2.x document so downstream tools see a self-contained spec. Resolves `#/components/...` (OpenAPI) and `#/definitions/...` (Swagger) JSON-pointer refs anywhere in the document, including inside components themselves. Per-branch cycle detection: if A→B→A, the second A is left as a `$ref` and recorded under `circular`. External refs (http://, file://, ./other.yaml) are never fetched - they're reported under `external` and left as-is.

Tags: conversion · openapi · swagger · ref · dereference · bazaar · builder-code · payment-identifier

Call contract

Method: POST
Input: json
Output: json
Last paid call: 2026-09-30

Input example from Bazaar metadata

{
  "spec": {
    "components": {
      "parameters": {
        "UserId": {
          "in": "path",
          "name": "id",
          "required": true,
          "schema": {
            "type": "string"
          }
        }
      },
      "schemas": {
        "User": {
          "properties": {
            "id": {
              "type": "string"
            },
            "name": {
              "type": "string"
            }
          },
          "type": "object"
        }
      }
    },
    "info": {
      "title": "Demo",
      "version": "1.0.0"
    },
    "openapi": "3.0.0",
    "paths": {
      "/users/{id}": {
        "get": {
          "parameters": [
            {
              "$ref": "#/components/parameters/UserId"
            }
          ],
          "responses": {
            "200": {
              "content": {
                "application/json": {
                  "schema": {
                    "$ref": "#/components/schemas/User"
                  }
                }
              },
              "description": "ok"
            }
          }
        }
      }
    }
  }
}

Output example

{
  "circular": [],
  "external": [],
  "resolved": 2,
  "spec": {
    "components": {
      "parameters": {
        "UserId": {
          "in": "path",
          "name": "id",
          "required": true,
          "schema": {
            "type": "string"
          }
        }
      },
      "schemas": {
        "User": {
          "properties": {
            "id": {
              "type": "string"
            },
            "name": {
              "type": "string"
            }
          },
          "type": "object"
        }
      }
    },
    "info": {
      "title": "Demo",
      "version": "1.0.0"
    },
    "openapi": "3.0.0",
    "paths": {
      "/users/{id}": {
        "get": {
          "parameters": [
            {
              "in": "path",
              "name": "id",
              "required": true,
              "schema": {
                "type": "string"
              }
            }
          ],
          "responses": {
            "200": {
              "content": {
                "application/json": {
                  "schema": {
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "name": {
                        "type": "string"
                      }
                    },
                    "type": "object"
                  }
                }
              },
              "description": "ok"
            }
          }
        }
      }
    }
  },
  "unresolved": []
}

Use with an agent

Discover. Agents find this listing with GET https://bazaar.saylorinnovations.com/discovery/search?query=…, the MCP tool search_resources, or /discovery/resources.
Inspect. Fetch /resources/28297.json for the price and payment options.
Pay. Call GET https://agent402.tools/api/openapi-resolve-refs. The provider answers 402 with its payment requirements. An x402 client signs one of the options below and retries with PAYMENT-SIGNATURE.
Execute. The provider returns 200 with the data. Agent Bazaar is not in the request path and never sees your payment.

For humans

You don't need an account or an API key; you need a wallet holding a small amount of USDC on Base, Polygon, Arbitrum One, eip155:143, Avalanche, eip155:1329, Optimism, eip155:4663, eip155:42220, Solana, stellar:pubnet, and an x402-capable client (see the examples below). Call the endpoint unpaid first to see exactly what it asks for.

Pricing & payment

Price: $0.001 / request
Protocol: x402 v2
Auth: No account or API key. Pay per request.
Networks: Base, Polygon, Arbitrum One, eip155:143, Avalanche, eip155:1329, Optimism, eip155:4663, eip155:42220, Solana, stellar:pubnet
Demand: 2 calls · 2 unique payers in 30d (public x402 Bazaar data)

x402 payment requirements

Scheme	Network	Asset	Amount	Pay to	Timeout
exact	Base eip155:8453	USDC	$0.001	0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0	300s
exact	Polygon eip155:137	USDC	$0.001	0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0	300s
exact	Arbitrum One eip155:42161	USDC	$0.001	0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0	300s
exact	eip155:143 eip155:143	0x754704Bc059F8C67012fEd69BC8A327a5aafb603	1000	0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0	300s
exact	Avalanche eip155:43114	0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E	1000	0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0	300s
exact	eip155:1329 eip155:1329	0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392	1000	0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0	300s
exact	Optimism eip155:10	0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85	2000	0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0	300s
exact	eip155:4663 eip155:4663	0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168	1000	0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0	300s
exact	eip155:42220 eip155:42220	0xcebA9300f2b948710d2653dD7B07f33A8B32118C	1000	0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0	300s
upto	Base eip155:8453	USDC	$0.001	0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0	300s
exact	Solana solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp	USDC	$0.001	J7aN3PLJnTCF5qpEnvJHJsnCjcGuqC2rYtEM8Gv3xwg	300s
exact	stellar:pubnet stellar:pubnet	CCW67TSZV3SSS2HXMBQ5JFGCKJNXKZM7UQUWUZPUTHXSTZLEO7SJMI75	10000	GDNJXCKW7ZM7GEEVP674TWPU26YJNBQ2FI4ZIPRKTPTNUEJMDHFJWWRL	300s

accepts[] (raw JSON)

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "1000",
    "amountUsd": 0.001,
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "eip155:137",
    "payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
    "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
    "amount": "1000",
    "amountUsd": 0.001,
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "eip155:42161",
    "payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
    "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "amount": "1000",
    "amountUsd": 0.001,
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "eip155:143",
    "payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
    "asset": "0x754704Bc059F8C67012fEd69BC8A327a5aafb603",
    "amount": "1000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "eip155:43114",
    "payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
    "asset": "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
    "amount": "1000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "eip155:1329",
    "payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
    "asset": "0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392",
    "amount": "1000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "eip155:10",
    "payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
    "asset": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
    "amount": "2000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "eip155:4663",
    "payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
    "asset": "0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168",
    "amount": "1000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "eip155:42220",
    "payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
    "asset": "0xcebA9300f2b948710d2653dD7B07f33A8B32118C",
    "amount": "1000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "upto",
    "network": "eip155:8453",
    "payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "1000",
    "amountUsd": 0.001,
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "payTo": "J7aN3PLJnTCF5qpEnvJHJsnCjcGuqC2rYtEM8Gv3xwg",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "1000",
    "amountUsd": 0.001,
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "stellar:pubnet",
    "payTo": "GDNJXCKW7ZM7GEEVP674TWPU26YJNBQ2FI4ZIPRKTPTNUEJMDHFJWWRL",
    "asset": "CCW67TSZV3SSS2HXMBQ5JFGCKJNXKZM7UQUWUZPUTHXSTZLEO7SJMI75",
    "amount": "10000",
    "maxTimeoutSeconds": 300
  }
]

Schemas

Output schema (JSON Schema)

{
  "properties": {
    "example": {
      "properties": {
        "circular": {
          "type": "array"
        },
        "external": {
          "type": "array"
        },
        "resolved": {
          "type": "integer"
        },
        "spec": {
          "properties": {
            "components": {
              "type": "object"
            },
            "info": {
              "type": "object"
            },
            "openapi": {
              "type": "string"
            },
            "paths": {
              "type": "object"
            }
          },
          "type": "object"
        },
        "unresolved": {
          "type": "array"
        }
      },
      "required": [
        "spec",
        "resolved",
        "circular",
        "unresolved",
        "external"
      ],
      "type": "object"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

Example shape — generated from the schema, not a captured live response

{
  "example": {
    "circular": [
      "value"
    ],
    "external": [
      "value"
    ],
    "resolved": 0,
    "spec": {
      "components": {},
      "info": {},
      "openapi": "string",
      "paths": {}
    },
    "unresolved": [
      "value"
    ]
  },
  "type": "string"
}

Examples

curl

curl -X POST 'https://agent402.tools/api/openapi-resolve-refs' -H 'Content-Type: application/json' --data '{"spec":{"components":{"parameters":{"UserId":{"in":"path","name":"id","required":true,"schema":{"type":"string"}}},"schemas":{"User":{"properties":{"id":{"type":"string"},"name":{"type":"string"}},"type":"object"}}},"info":{"title":"Demo","version":"1.0.0"},"openapi":"3.0.0","paths":{"/users/{id}":{"get":{"parameters":[{"$ref":"#/components/parameters/UserId"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/User"}}},"description":"ok"}}}}}}}'
# -> 402 Payment Required; read PAYMENT-REQUIRED
# retry the identical request with PAYMENT-SIGNATURE

JavaScript

const res = await fetch("https://agent402.tools/api/openapi-resolve-refs", {
  "method": "POST",
  "headers": {
    "content-type": "application/json"
  },
  "body": "{\"spec\":{\"components\":{\"parameters\":{\"UserId\":{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"schema\":{\"type\":\"string\"}}},\"schemas\":{\"User\":{\"properties\":{\"id\":{\"type\":\"string\"},\"name\":{\"type\":\"string\"}},\"type\":\"object\"}}},\"info\":{\"title\":\"Demo\",\"version\":\"1.0.0\"},\"openapi\":\"3.0.0\",\"paths\":{\"/users/{id}\":{\"get\":{\"parameters\":[{\"$ref\":\"#/components/parameters/UserId\"}],\"responses\":{\"200\":{\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/User\"}}},\"description\":\"ok\"}}}}}}}"
});
if (res.status === 402) {
  const { accepts } = await res.json();
  // pay one of accepts[] via an x402 client, then retry with the payment header
}

Python

import httpx
import json
res = httpx.request("POST", "https://agent402.tools/api/openapi-resolve-refs", json=json.loads("{\"spec\":{\"components\":{\"parameters\":{\"UserId\":{\"in\":\"path\",\"name\":\"id\",\"required\":true,\"schema\":{\"type\":\"string\"}}},\"schemas\":{\"User\":{\"properties\":{\"id\":{\"type\":\"string\"},\"name\":{\"type\":\"string\"}},\"type\":\"object\"}}},\"info\":{\"title\":\"Demo\",\"version\":\"1.0.0\"},\"openapi\":\"3.0.0\",\"paths\":{\"/users/{id}\":{\"get\":{\"parameters\":[{\"$ref\":\"#/components/parameters/UserId\"}],\"responses\":{\"200\":{\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/User\"}}},\"description\":\"ok\"}}}}}}}"))
if res.status_code == 402:
    accepts = res.json()["accepts"]
    # pay one of accepts[] via an x402 client, then retry with the payment header

Details

Provider: agent402.tools
Endpoint: https://agent402.tools/api/openapi-resolve-refs
Machine-readable: /resources/28297.json