Taxonomy

Taxonomy and schema API endpoints

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

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

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

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

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

curl "https://api.marketmotion.xyz/api/schemas"