Markets Search

{
  "as_of": "2026-08-11T23:59:59.999Z",
  "events": [],
  "facets": {
    "categories": [],
    "tags": [
      {
        "count": 1,
        "value": "oil"
      }
    ]
  },
  "group_by": "event",
  "historical": true,
  "markets": [
    {
      "categories": [],
      "event": {
        "id": "e1",
        "slug": "hormuz-traffic",
        "title": "Strait of Hormuz traffic"
      },
      "forecast_at": "2026-08-11T20:14:03Z",
      "has_forecast": true,
      "has_published_signal": false,
      "latest_q_probability": 0.57,
      "marketKey": "polymarket:123",
      "marketUrl": "https://polymarket.com/event/hormuz-traffic",
      "market_odds": 0.42,
      "market_odds_at_forecast": 0.4,
      "nativeEventId": "e1",
      "nativeMarketId": "123",
      "published_signal_count": 0,
      "question": "Will Strait of Hormuz traffic be restored by September?",
      "quotientMarketId": "123",
      "relevance": {
        "matched_by": [
          "graph"
        ],
        "matched_fields": [
          "summary"
        ],
        "score": 0.0503
      },
      "seriesTicker": null,
      "slug": "strait-of-hormuz-traffic-restored-by-september",
      "sourceUrl": "https://gamma-api.polymarket.com/markets/123",
      "tags": [
        "oil",
        "Strait of Hormuz"
      ],
      "thesis": "Q expects traffic normalization to remain constrained through the cutoff.",
      "venue": "polymarket",
      "venue_quote": {
        "freshness": "verified",
        "market_id": "123",
        "observed_at": "2026-08-31T12:00:00Z",
        "quote_method": "midpoint",
        "schema_version": "1",
        "selected_probability": 0.42,
        "venue": "polymarket",
        "venue_timestamp": "2026-08-31T12:00:00Z",
        "yes_ask": 0.42,
        "yes_bid": 0.42,
        "yes_last": null
      }
    }
  ],
  "query": "oil supply disruption",
  "retrieval": {
    "graph": "ok",
    "semantic": "unconfigured",
    "typesense": "unconfigured"
  }
}

# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i 'https://quotient-api-gateway.onrender.com/api/v1/markets/search?group_by=event&q=oil+supply+disruption'

# x402 v2 sends the challenge base64-encoded in the PAYMENT-REQUIRED header (v1 sends it in the body).
# To read the header:
curl -sS -g -o /dev/null -D - 'https://quotient-api-gateway.onrender.com/api/v1/markets/search?group_by=event&q=oil+supply+disruption' \
  | grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 --decode

// npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

// Pays at most $0.01 per call.
const client = new x402Client().setSpendControls({ maxAmountPerPayment: "$0.01" });
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? ToolVet checks it first for $0.005. Pay for that from a separate
// client: this one is capped at $0.01 per payment. GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fquotient-api-gateway.onrender.com%2Fapi%2Fv1%2Fmarkets%2Fsearch
const res = await pay("https://quotient-api-gateway.onrender.com/api/v1/markets/search?group_by=event&q=oil+supply+disruption");
console.log(res.status, await res.text());

# pip install "x402[requests,evm]"
import os
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

# Pays at most $0.01 per call.
client = x402ClientSync().set_spend_controls({"max_amount_per_payment": "$0.01"})
register_exact_evm_client(client, EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"])))

with x402_requests(client) as session:
    res = session.get("https://quotient-api-gateway.onrender.com/api/v1/markets/search?group_by=event&q=oil+supply+disruption")
    print(res.status_code, res.text)