Skip to main content

​
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 "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 "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 "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 "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 "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 "https://api.marketmotion.xyz/api/attribution/top-causal?limit=10"