Taxonomy Stats
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 entities within a specific category/subcategory.
Path Parameters
Category (e.g., sports, politics)
Subcategory (e.g., nfl, presidential)
Query Parameters
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 groups within a subcategory (e.g., divisions, conferences).
Path Parameters
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 entities within a specific group.
Path Parameters
Query Parameters
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 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"