Composite-score trending markets.

Top markets by a transparent blended score (volume × recency × tightness). The component scores are returned alongside each market so a UI can render “why is this trending” copy and integrators can audit the ranking.

GET /v1/trending

Error

A valid request URL is required to generate request examples

200

{
  "markets": [
    {
      "id": 0,
      "marketAddress": "<string>",
      "question": "<string>",
      "category": "<string>",
      "tags": [
        "<string>"
      ],
      "creator": "<string>",
      "resolved": true,
      "finalOutcome": 0,
      "volume": "<string>",
      "bestBidYes": 500,
      "bestAskYes": 500,
      "bestBidNo": 500,
      "bestAskNo": 500,
      "createdAt": "<string>",
      "metadata": {},
      "trendingScore": 123,
      "scoreVolume": 123,
      "scoreRecency": 123,
      "scoreTightness": 123,
      "imageUrl": "<string>",
      "rules": "<string>",
      "resolutionSources": "<string>",
      "master": true,
      "masterQuestion": "<string>",
      "masterImage": "<string>",
      "linked": true,
      "proposalId": 0
    }
  ],
  "algorithm": {
    "description": "<string>",
    "weights": {
      "volume": 123,
      "recency": 123,
      "tightness": 123
    },
    "halfLifeSeconds": 0
  }
}

Authorizations

Authorization · string · header · required

API key obtained from POST /v1/auth/keys.

Query Parameters

category · string

Required string length: 1 - 80

limit · integer · default: 20

Required range: 1 <= x <= 200

halfLifeDays · number · default: 14

Recency half-life in days. Lower = punishes older markets harder.

Required range: 0.5 <= x <= 180

Response

200

application/json

Default Response

markets · object[] · required

Show child attributes

algorithm · object · required

Show child attributes