AIMarket — live agent marketplace

Search this hub's catalogue of live data and computation by what you need, in plain words. Each match gives the product_id, capability_id and source_hub to pass to market_invoke, its price, and `input`: the fields its input object takes.

{
  "type": "object",
  "properties": {
    "intent": {
      "type": "string",
      "description": "What you want done, in plain language."
    },
    "category": {
      "type": "string",
      "description": "Optional category filter, e.g. 'security'."
    },
    "budget": {
      "type": "number",
      "description": "Optional cap on price per call, in USD."
    },
    "limit": {
      "type": "integer",
      "description": "Maximum results (default 10, max 50)."
    }
  },
  "required": [
    "intent"
  ]
}

Invoke a capability found via market_search. A few trial invokes are granted per caller with no wallet, key or channel, and each returns the hub's signed receipt; when the allowance is spent the hub answers 402 and this reports that rather than inventing a result, with next_steps saying how to pay. Paid access uses payment_channel (+ secret) or an on-chain x402 payment (x_payment + x_payment_nonce + x_payment_secret).

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "description": "The product_id from market_search."
    },
    "capability_id": {
      "type": "string",
      "description": "The exact capability_id from market_search."
    },
    "source_hub": {
      "type": "string",
      "description": "The source_hub from market_search, when it shows one. Required for federated capabilities — most of the catalogue; omitting it makes the hub look for the capability locally and answer 404."
    },
    "input": {
      "type": "object",
      "description": "Input object for the capability; {} when it takes none."
    },
    "max_price_usd": {
      "type": "number",
      "minimum": 0,
      "maximum": 1000000,
      "description": "Atomic total-price ceiling. Copy the selected search result's max_price_usd here; the Hub returns price_limit_exceeded before work or payment if the route was repriced."
    },
    "payment_channel": {
      "type": "string"
    },
    "payment_channel_secret": {
      "type": "string"
    },
    "payment_authorization": {
      "type": "object"
    },
    "x_payment": {
      "type": "string",
      "description": "x402 seller-direct payment: the hash of the USDC transfer you broadcast for the 402's invoice (see next_steps)."
    },
    "x_payment_nonce": {
      "type": "string",
      "description": "The invoice nonce from the 402 that x_payment pays."
    },
    "x_payment_secret": {
      "type": "string",
      "description": "The payment_secret from that 402. The nonce and the transaction are public once mined; the secret is what shows you are the one who paid."
    },
    "include_full_receipt": {
      "type": "boolean",
      "description": "Return the hub's raw response, including the full hybrid Ed25519 + ML-DSA-65 receipt signature (about 7 KB)."
    }
  },
  "required": [
    "product_id",
    "capability_id"
  ]
}

Validate a graph and return a signed quote and payment offers. No work or payment. Free steps require no wallet; paid steps require buyer wallet address. Use gas_mode=required to demand gas sponsorship or auto to prefer it. Inspect ready/blockers and gas_sponsorship. Sign offers LOCALLY, never provide a private key. Then call pipeline_invoke.

{
  "type": "object",
  "properties": {
    "nodes": {
      "items": {
        "$ref": "#/$defs/StudioNode"
      },
      "maxItems": 16,
      "minItems": 1,
      "title": "Nodes",
      "type": "array"
    },
    "max_budget_usd": {
      "anyOf": [
        {
          "maximum": 100000,
          "minimum": 0,
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Max Budget Usd"
    },
    "gas_mode": {
      "default": "buyer",
      "enum": [
        "buyer",
        "auto",
        "required"
      ],
      "title": "Gas Mode",
      "type": "string"
    },
    "wallet": {
      "default": "0x0000000000000000000000000000000000000000",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "title": "Wallet",
      "type": "string"
    }
  },
  "required": [
    "nodes"
  ],
  "$defs": {
    "StudioNode": {
      "description": "One hop of a studio blueprint — the executor's node shape, validated here too.",
      "properties": {
        "id": {
          "default": "",
          "maxLength": 64,
          "title": "Id",
          "type": "string"
        },
        "product_id": {
          "maxLength": 80,
          "minLength": 2,
          "title": "Product Id",
          "type": "string"
        },
        "capability_id": {
          "maxLength": 80,
          "minLength": 2,
          "title": "Capability Id",
          "type": "string"
        },
        "input": {
          "additionalProperties": true,
          "title": "Input",
          "type": "object"
        },
        "depends_on": {
          "items": {
            "type": "string"
          },
          "maxItems": 16,
          "title": "Depends On",
          "type": "array"
        },
        "input_from": {
          "anyOf": [
            {
              "maxLength": 64,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Input From"
        },
        "source_hub": {
          "anyOf": [
            {
              "maxLength": 200,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Source Hub"
        }
      },
      "required": [
        "product_id",
        "capability_id"
      ],
      "title": "StudioNode",
      "type": "object"
    }
  },
  "title": "PrepareGraph"
}

Execute or continue the SAME prepared graph. Submit authorizations when the signed quote enables gas_sponsorship, otherwise buyer-signed transactions; none for free steps. Never submit both payment modes. Retain run_id/access_token and the exact bundle. Pending is not failure; repeat the same run or read pipeline_status. Never create a replacement purchase after a lost response.

{
  "type": "object",
  "properties": {
    "run_id": {
      "pattern": "^paid_[0-9a-f]{32}$",
      "title": "Run Id",
      "type": "string"
    },
    "access_token": {
      "maxLength": 128,
      "minLength": 20,
      "title": "Access Token",
      "type": "string"
    },
    "transactions": {
      "anyOf": [
        {
          "additionalProperties": {
            "maxLength": 4098,
            "pattern": "^0x[0-9a-fA-F]+$",
            "type": "string"
          },
          "maxProperties": 16,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Transactions"
    },
    "authorizations": {
      "anyOf": [
        {
          "additionalProperties": {
            "pattern": "^0x[0-9a-fA-F]{130}$",
            "type": "string"
          },
          "maxProperties": 16,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Authorizations"
    }
  },
  "required": [
    "run_id",
    "access_token"
  ],
  "additionalProperties": false,
  "title": "PipelineInput"
}

Read an existing pipeline, including cached signed result, without broadcasting payments or invoking providers. No wallet signer or blockchain RPC required. Inspect recovery.action for unresolved work.

{
  "type": "object",
  "properties": {
    "run_id": {
      "type": "string",
      "pattern": "^paid_[0-9a-f]{32}$"
    },
    "access_token": {
      "type": "string",
      "minLength": 20,
      "maxLength": 128
    }
  },
  "required": [
    "run_id",
    "access_token"
  ],
  "additionalProperties": false
}

Prepare a cash refund for a verified paid step of a finished pipeline. This moves no money. The original seller must approve the exact EIP-3009 authorization locally; never send a private key. Refunds require seller cooperation and a configured gas sponsor.

{
  "type": "object",
  "properties": {
    "run_id": {
      "pattern": "^paid_[0-9a-f]{32}$",
      "title": "Run Id",
      "type": "string"
    },
    "access_token": {
      "maxLength": 128,
      "minLength": 20,
      "title": "Access Token",
      "type": "string"
    },
    "step_id": {
      "maxLength": 64,
      "minLength": 1,
      "title": "Step Id",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "access_token",
    "step_id"
  ],
  "additionalProperties": false,
  "title": "RefundToolInput"
}

Submit the original seller's refund authorization or resume the SAME refund. The recipient is the original buyer, amount is the paid step price, and the sponsor pays gas. Preserve the exact authorization after a lost response. Returns a separately signed credit note; the original bill is unchanged.

{
  "type": "object",
  "properties": {
    "authorization": {
      "anyOf": [
        {
          "pattern": "^0x[0-9a-fA-F]{130}$",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Authorization"
    },
    "run_id": {
      "pattern": "^paid_[0-9a-f]{32}$",
      "title": "Run Id",
      "type": "string"
    },
    "access_token": {
      "maxLength": 128,
      "minLength": 20,
      "title": "Access Token",
      "type": "string"
    },
    "step_id": {
      "maxLength": 64,
      "minLength": 1,
      "title": "Step Id",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "access_token",
    "step_id"
  ],
  "additionalProperties": false,
  "title": "RefundApproveToolInput"
}

Read the saved cash-refund status and signed credit note without broadcasting a transaction. No private key or RPC is required. Pending means resume the same refund, never send a replacement transfer.

{
  "type": "object",
  "properties": {
    "run_id": {
      "pattern": "^paid_[0-9a-f]{32}$",
      "title": "Run Id",
      "type": "string"
    },
    "access_token": {
      "maxLength": 128,
      "minLength": 20,
      "title": "Access Token",
      "type": "string"
    },
    "step_id": {
      "maxLength": 64,
      "minLength": 1,
      "title": "Step Id",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "access_token",
    "step_id"
  ],
  "additionalProperties": false,
  "title": "RefundToolInput"
}

Current weather at a place: temperature (°C), humidity (%), pressure (hPa) and wind (m/s) from the nearest live Open-Meteo relay within 75 km, with a signed receipt. Pass latitude and longitude, or a city. Costs $0.001 per call. The first 5 priced calls per caller are free.

{
  "type": "object",
  "properties": {
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude in degrees."
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude in degrees."
    },
    "city": {
      "type": "string",
      "description": "A city instead of coordinates, e.g. \"Tokyo\"; many spellings work (Токио, 東京)."
    }
  }
}

Current air quality at a place: PM2.5 and PM10 (µg/m³), US and European AQI, from Copernicus CAMS via Open-Meteo, with a signed receipt. Pass latitude and longitude, or a city. Costs $0.001 per call. The first 5 priced calls per caller are free.

{
  "type": "object",
  "properties": {
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude in degrees."
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude in degrees."
    },
    "city": {
      "type": "string",
      "description": "A city instead of coordinates, e.g. \"Tokyo\"; many spellings work (Токио, 東京)."
    }
  }
}

The nearest live public sensors to a point, one per layer asked for (e.g. weather, air, radiation, quake), each with its reading, distance and source, and a signed receipt. Costs $0.03 per call. The first 5 priced calls per caller are free.

{
  "type": "object",
  "properties": {
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude in degrees."
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude in degrees."
    },
    "layers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Sensor layers to search, e.g. [\"weather\", \"air\"]; default weather."
    },
    "max_km": {
      "type": "number",
      "minimum": 0,
      "description": "Refuse sensors farther than this."
    }
  },
  "required": [
    "latitude",
    "longitude"
  ]
}

Verifiable random bytes for a draw, raffle or tie-break: an ECVRF output over your seed plus a proof anyone can check offline. The same seed always gives the same output, so publish the seed first to show the result was not picked. Costs $0.006 per call. The first 5 priced calls per caller are free.

{
  "type": "object",
  "properties": {
    "seed": {
      "type": "string",
      "description": "Seed or message the draw is bound to."
    },
    "num_bytes": {
      "type": "integer",
      "minimum": 1,
      "maximum": 64,
      "description": "Output length (default 32)."
    }
  },
  "required": [
    "seed"
  ]
}