Kortex

Return the full machine-readable manifest of Kortex: every operation, its price in USD, its input schema and how to pay. Free. When to use: Call this first if you have never used Kortex and want to know what it can do and what it costs. Price: Free.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Turn a wallet address into a permanent Kortex identity and an API token. Free, and grants a small trial credit. When to use: Call this once, before anything else. You need the returned token for every other call. No account, no email, no human. Price: Free.

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "Your EVM wallet address. This is your permanent identity."
    },
    "signature": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]+$",
      "description": "EIP-191 personal_sign of the message field, proving you control the wallet."
    },
    "message": {
      "type": "string",
      "minLength": 8,
      "maxLength": 200,
      "description": "Must contain your wallet address and a timestamp within the last 10 minutes."
    },
    "label": {
      "description": "A name for your own reference.",
      "type": "string",
      "maxLength": 64
    }
  },
  "required": [
    "wallet",
    "signature",
    "message"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Your handle, wallet, balance and usage. Free. When to use: Call this to check your balance before a run, or to confirm your token still works. Price: Free.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Buy Kortex credit with USDC on Base over x402. One on-chain settlement, then every call is debited off-chain. When to use: Call when your balance is low. Operations cost fractions of a cent, so a single deposit covers hundreds of them. Price: Free.

{
  "type": "object",
  "properties": {
    "amount_usd": {
      "description": "One of 1, 5 or 20. Defaults to 1.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Describe what you need in plain language and get back x402 services ranked by evidence: how much of the time they have been up, whether they answer with a valid 402, and how many distinct wallets have actually paid them on-chain. One entry per operator, not per URL. When to use: Call this before paying a service you have not used, and instead of taking the first result from a directory. Of the services listed as x402 today, measured across 1,015 of them, only 25% actually answer with a payment requirement — the rest are up but sell nothing. Price: US$0.005000 per call.

{
  "type": "object",
  "properties": {
    "need": {
      "type": "string",
      "minLength": 3,
      "maxLength": 200,
      "description": "What you want done, in plain language. Example: scrape a web page and return clean text."
    },
    "limit": {
      "default": 5,
      "description": "How many candidates to return.",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    },
    "max_price_usd": {
      "description": "Skip anything that quotes more than this per call.",
      "type": "string"
    },
    "require_paid": {
      "default": true,
      "description": "Only return services with at least one on-chain settlement. Turn off to see untested ones too.",
      "type": "boolean"
    }
  },
  "required": [
    "need"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Everything Kortex knows about a single resource URL: whether it is up, whether its 402 is well formed, what it quotes, and whether its payout address has ever been paid on-chain. Returns a verdict, not just data. When to use: Call this when you already have a URL and want to know whether sending money to it is a good idea. Worth it above roughly US$0.05 a call; below that the check costs more than the risk. Price: US$0.002000 per call.

{
  "type": "object",
  "properties": {
    "resource": {
      "type": "string",
      "maxLength": 2048,
      "format": "uri",
      "description": "The exact URL you are about to pay, including the path."
    },
    "probe_now": {
      "default": false,
      "description": "Hit the endpoint live instead of using the most recent scheduled probe.",
      "type": "boolean"
    }
  },
  "required": [
    "resource"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Score two or more resource URLs side by side on the same evidence, and say which one to pay. When to use: Call this when you already have a shortlist and need to pick. Cheaper than calling check once per URL. Price: US$0.003000 per call.

{
  "type": "object",
  "properties": {
    "resources": {
      "minItems": 2,
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 2048,
        "format": "uri",
        "description": "The exact URL you are about to pay, including the path."
      },
      "description": "The URLs to rank."
    }
  },
  "required": [
    "resources"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The full time series behind a score: every probe outcome, every price and payout-address change, and the on-chain settlement history of the address it pays to. When to use: Call this when a verdict surprises you, or before committing to a service you plan to depend on. This is the evidence itself rather than the summary. Price: US$0.002000 per call.

{
  "type": "object",
  "properties": {
    "resource": {
      "type": "string",
      "maxLength": 2048,
      "format": "uri",
      "description": "The exact URL you are about to pay, including the path."
    },
    "days": {
      "default": 30,
      "description": "How far back to look.",
      "type": "integer",
      "minimum": 1,
      "maximum": 90
    }
  },
  "required": [
    "resource"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Register interest in a service. Kortex records a watch and reports what has changed — price, payout address, or availability — the next time you ask. When to use: Call this for a service you depend on. A payout address that moves is the strongest warning signal there is, and you will not notice it by yourself. Price: US$0.005000 per call.

{
  "type": "object",
  "properties": {
    "resource": {
      "type": "string",
      "maxLength": 2048,
      "format": "uri",
      "description": "The exact URL you are about to pay, including the path."
    },
    "callback_url": {
      "description": "Optional. If set, Kortex POSTs here when something changes.",
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "resource"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Tell Kortex that you paid a service and what you got. Free, and only counted once the payment is found on-chain — so a report costs at least the price of the call it describes. When to use: Call this after any paid call that went wrong, and after ones that went right. It is free, it makes every later verdict better, and the evidence it adds is the kind no probe can produce. Price: Free.

{
  "type": "object",
  "properties": {
    "resource": {
      "type": "string",
      "maxLength": 2048,
      "format": "uri",
      "description": "The exact URL you are about to pay, including the path."
    },
    "outcome": {
      "type": "string",
      "enum": [
        "ok",
        "no_response",
        "wrong_output",
        "overcharged",
        "never_delivered"
      ],
      "description": "What actually happened after you paid."
    },
    "detail": {
      "description": "What happened, in your own words.",
      "type": "string",
      "maxLength": 500
    },
    "tx_hash": {
      "description": "The settlement transaction, if you have it. Speeds up verification.",
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{64}$"
    }
  },
  "required": [
    "resource",
    "outcome"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}