Locus public pay-per-use API

[
  {
    "scheme": "upto",
    "network": "eip155:8453",
    "payTo": "0x3C5CBe28ECA3b96023c45D3f877da834F1C7d5fA",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "152950",
    "maxTimeoutSeconds": 1800
  }
]

{
  "bazaar": {
    "info": {
      "input": {
        "body": {
          "max_tokens": 1,
          "messages": [
            {
              "content": "Hello from x402",
              "role": "user"
            }
          ],
          "model": "sonar"
        },
        "bodyType": "json",
        "method": "POST",
        "type": "http"
      },
      "output": {
        "example": {
          "data": {},
          "payment": {
            "authorizedMaxUsdc": "0.001000",
            "scheme": "exact",
            "settledUsdc": "0.001000"
          },
          "request": {
            "id": "00000000-0000-4000-8000-000000000000",
            "statusUrl": "/requests/00000000-0000-4000-8000-000000000000"
          },
          "success": true
        },
        "type": "json"
      }
    },
    "schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "input": {
          "additionalProperties": false,
          "properties": {
            "body": {
              "additionalProperties": true,
              "properties": {
                "max_tokens": {
                  "description": "Maximum output tokens (up to 128000). Required to bound metered x402 authorization.",
                  "type": "number"
                },
                "messages": {
                  "description": "Conversation messages. Each: { role: \"system\"|\"user\"|\"assistant\", content: \"text\" } or multimodal with image_url content blocks.",
                  "items": {
                    "additionalProperties": true,
                    "type": "object"
                  },
                  "type": "array"
                },
                "model": {
                  "description": "Metered x402 Sonar model ID: 'sonar', 'sonar-pro', or 'sonar-reasoning-pro'. Deep Research is excluded because its autonomous usage cannot be safely preauthorized.",
                  "type": "string"
                },
                "reasoning_effort": {
                  "description": "Reasoning effort level (sonar-reasoning-pro only): 'minimal', 'low', 'medium', 'high'",
                  "type": "string"
                },
                "response_format": {
                  "additionalProperties": true,
                  "description": "Structured output. { type: \"json_schema\", json_schema: { name: \"...\", schema: {...} } }",
                  "type": "object"
                },
                "return_images": {
                  "description": "Include image results in the response",
                  "type": "boolean"
                },
                "return_related_questions": {
                  "description": "Include related follow-up questions in the response",
                  "type": "boolean"
                },
                "search_domain_filter": {
                  "description": "Restrict search to specific domains",
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "search_language_filter": {
                  "description": "Filter search results by language (ISO 639-1 codes)",
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "search_recency_filter": {
                  "description": "Time filter for search results: 'hour', 'day', 'week', 'month', 'year'",
                  "type": "string"
                },
                "temperature": {
                  "description": "Sampling temperature (0.0–2.0)",
                  "type": "number"
                },
                "top_p": {
                  "description": "Nucleus sampling threshold (0.0–1.0)",
                  "type": "number"
                },
                "web_search_options": {
                  "additionalProperties": true,
                  "description": "Web search configuration: { search_context_size: 'low'|'medium'|'high', search_type: 'fast', user_location: { country: '...', city: '...' } }. Metered x402 excludes pro/auto because they can trigger uncapped multi-step usage and require streaming.",
                  "type": "object"
                }
              },
              "required": [
                "model",
                "messages",
                "max_tokens"
              ],
              "type": "object"
            },
            "bodyType": {
              "enum": [
                "json",
                "form-data",
                "text"
              ],
              "type": "string"
            },
            "method": {
              "enum": [
                "POST"
              ],
              "type": "string"
            },
            "type": {
              "const": "http",
              "type": "string"
            }
          },
          "required": [
            "type",
            "method",
            "bodyType",
            "body"
          ],
          "type": "object"
        },
        "output": {
          "properties": {
            "example": {
              "type": "object"
            },
            "type": {
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "type": "object"
        }
      },
      "required": [
        "input"
      ],
      "type": "object"
    }
  },
  "eip2612GasSponsoring": {
    "info": {
      "description": "The facilitator accepts EIP-2612 gasless Permit to `Permit2` canonical contract.",
      "version": "1"
    },
    "schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "amount": {
          "description": "The amount to approve (uint256). Typically MaxUint.",
          "pattern": "^[0-9]+$",
          "type": "string"
        },
        "asset": {
          "description": "The address of the ERC-20 token contract.",
          "pattern": "^0x[a-fA-F0-9]{40}$",
          "type": "string"
        },
        "deadline": {
          "description": "The timestamp at which the signature expires.",
          "pattern": "^[0-9]+$",
          "type": "string"
        },
        "from": {
          "description": "The address of the sender.",
          "pattern": "^0x[a-fA-F0-9]{40}$",
          "type": "string"
        },
        "nonce": {
          "description": "The current nonce of the sender.",
          "pattern": "^[0-9]+$",
          "type": "string"
        },
        "signature": {
          "description": "The 65-byte concatenated signature (r, s, v) as a hex string.",
          "pattern": "^0x[a-fA-F0-9]+$",
          "type": "string"
        },
        "spender": {
          "description": "The address of the spender (Canonical Permit2).",
          "pattern": "^0x[a-fA-F0-9]{40}$",
          "type": "string"
        },
        "version": {
          "description": "Schema version identifier.",
          "pattern": "^[0-9]+(\\.[0-9]+)*$",
          "type": "string"
        }
      },
      "required": [
        "from",
        "asset",
        "spender",
        "amount",
        "nonce",
        "deadline",
        "signature",
        "version"
      ],
      "type": "object"
    }
  }
}

curl "https://perplexity.x402.paywithlocus.com/perplexity/chat"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid

const res = await fetch("https://perplexity.x402.paywithlocus.com/perplexity/chat");
if (res.status === 402) {
  const { accepts } = await res.json();
  // pay one of accepts[] via an x402 client, then retry with the payment header
}

import httpx
res = httpx.get("https://perplexity.x402.paywithlocus.com/perplexity/chat")
if res.status_code == 402:
    accepts = res.json()["accepts"]
    # pay one of accepts[] via an x402 client, then retry with the payment header