Skip to main content

Taxonomy Stats

GET
Get category and subcategory counts across the entity graph.

Response

{
  "success": true,
  "stats": {
    "categories": [
      {
        "category": "sports",
        "count": 450,
        "subcategories": [
          { "name": "nfl", "count": 200 },
          { "name": "nba", "count": 150 },
          { "name": "mlb", "count": 100 }
        ]
      },
      {
        "category": "politics",
        "count": 300,
        "subcategories": [
          { "name": "us-congress", "count": 535 },
          { "name": "presidential", "count": 50 }
        ]
      }
    ]
  }
}
curl "https://api.marketmotion.xyz/api/taxonomy/stats"

List Entities in Subcategory

GET
Get entities within a specific category/subcategory.

Path Parameters

category
string
required
Category (e.g., sports, politics)
subcategory
string
required
Subcategory (e.g., nfl, presidential)

Query Parameters

type
string
Filter by entity type
tag
string
Filter by tag
group
string
Filter by group
limit
number
Maximum results

Response

{
  "success": true,
  "entities": [
    {
      "slug": "patrick-mahomes",
      "displayName": "Patrick Mahomes",
      "entityType": "person"
    }
  ],
  "count": 200
}
curl "https://api.marketmotion.xyz/api/taxonomy/sports/nfl/entities?type=person&limit=50"

List Groups

GET
Get groups within a subcategory (e.g., divisions, conferences).

Path Parameters

category
string
required
Category
subcategory
string
required
Subcategory

Response

{
  "success": true,
  "groups": [
    { "group": "AFC West", "count": 20 },
    { "group": "AFC East", "count": 18 },
    { "group": "NFC South", "count": 22 }
  ]
}
curl "https://api.marketmotion.xyz/api/taxonomy/sports/nfl/groups"

List Entities in Group

GET
Get entities within a specific group.

Path Parameters

category
string
required
Category
subcategory
string
required
Subcategory
group
string
required
Group name

Query Parameters

type
string
Filter by entity type
tag
string
Filter by tag
q
string
Search within group
limit
number
Maximum results
cursor
string
Pagination cursor

Response

{
  "success": true,
  "items": [
    {
      "slug": "patrick-mahomes",
      "displayName": "Patrick Mahomes",
      "entityType": "person"
    }
  ],
  "nextCursor": "..."
}
curl "https://api.marketmotion.xyz/api/taxonomy/sports/nfl/AFC%20West/entities?type=person"

Schemas

GET
Get snapshot schemas and attribute schemas used across the entity graph.

Response

{
  "success": true,
  "snapshotSchemas": [
    {
      "category": "sports",
      "subcategory": "nfl",
      "entityType": "person",
      "fields": ["position", "jersey_number", "injury_status", "team_slug"]
    }
  ],
  "attributeSchemas": [
    {
      "key": "injury_status",
      "type": "enum",
      "values": ["healthy", "questionable", "doubtful", "out"]
    }
  ]
}
curl "https://api.marketmotion.xyz/api/schemas"