Attribution

Entity impact and causality analysis endpoints

Entity Attribution

GET

Get impact coefficients showing how an entity’s attribute changes affect market prices.

Path Parameters

slug · string · required

Entity slug (e.g., patrick-mahomes)

Response

{
  "success": true,
  "entitySlug": "patrick-mahomes",
  "coefficients": [
    {
      "marketId": "market-uuid",
      "marketTitle": "Chiefs to win Super Bowl",
      "attribute": "injury_status",
      "coefficient": -0.15,
      "significance": 0.95
    }
  ],
  "count": 5
}

cURL

curl "https://api.marketmotion.xyz/api/attribution/entity/patrick-mahomes"

---

Market Attribution

GET

Get entity attributions for a specific market — which entities most influence its price.

Path Parameters

venue · string · required

Venue: polymarket, kalshi

marketId · string · required

Market ID

Response

{
  "success": true,
  "venue": "polymarket",
  "marketId": "market-uuid",
  "entities": [
    {
      "slug": "patrick-mahomes",
      "displayName": "Patrick Mahomes",
      "coefficient": -0.15,
      "attribute": "injury_status"
    }
  ],
  "count": 3
}

cURL

curl "https://api.marketmotion.xyz/api/attribution/market/polymarket/market-uuid"

---

Top Movers

GET

Get entities with the largest recent market impact.

Query Parameters

hours · number

Lookback window in hours

limit · number

Maximum results

Response

{
  "success": true,
  "movers": [
    {
      "entitySlug": "patrick-mahomes",
      "displayName": "Patrick Mahomes",
      "attributeChanged": "injury_status",
      "marketImpact": 0.15,
      "affectedMarkets": 5
    }
  ],
  "count": 10
}

cURL

curl "https://api.marketmotion.xyz/api/attribution/top-movers?hours=24&limit=10"

---

Predict Impact

GET

Predict the market impact of a hypothetical attribute change.

Query Parameters

entity · string · required

Entity slug

attribute · string · required

Attribute key (e.g., injury_status)

value · string · required

Hypothetical new value (e.g., out)

Response

{
  "success": true,
  "entity": "patrick-mahomes",
  "attribute": "injury_status",
  "predictions": [
    {
      "marketId": "market-uuid",
      "marketTitle": "Chiefs to win Super Bowl",
      "currentPrice": 0.35,
      "predictedPrice": 0.20,
      "priceChange": -0.15
    }
  ],
  "count": 5
}

cURL

curl "https://api.marketmotion.xyz/api/attribution/predict?entity=patrick-mahomes&attribute=injury_status&value=out"

---

Causality

GET

Get causal relationships for an entity — which other entities it influences and is influenced by.

Path Parameters

slug · string · required

Entity slug

Response

{
  "success": true,
  "entitySlug": "patrick-mahomes",
  "causality": [
    {
      "targetEntity": "kansas-city-chiefs",
      "direction": "causes",
      "strength": 0.85,
      "mechanism": "player_performance"
    }
  ],
  "count": 3
}

cURL

curl "https://api.marketmotion.xyz/api/attribution/causality/patrick-mahomes"

---

Top Causal

GET

Get entities with the strongest causal influence across the graph.

Query Parameters

limit · number

Maximum results

Response

{
  "success": true,
  "results": [
    {
      "entitySlug": "jerome-powell",
      "displayName": "Jerome Powell",
      "causalStrength": 0.92,
      "affectedEntities": 15,
      "affectedMarkets": 45
    }
  ],
  "count": 10
}

cURL

curl "https://api.marketmotion.xyz/api/attribution/top-causal?limit=10"