Skip to main content

Feed & Matches

GET /feed​

{
  "items": [
    {
      "did": "did:web:...",
      "avatar": {
        "primaryUrl": "https://cdn/.../hero.png",
        "variants": ["https://cdn/.../hero-2.png"],
        "provenance": { "basedOnSelfie": true, "creative": false }
      },
      "lore": ["Former guild leader", "Arcane scholar", "Tavern owner"],
      "class": "Bard",
      "traits": ["Charismatic", "Strategist"],
      "scenes": ["Main Plaza"],
      "why": ["You both explored Arcadia", "Shared love of quests"]
    }
  ],
  "nextCursor": "abc123"
}

POST /matches/start​

{ "targetDid": "did:web:..." }

Response

{ "matchId": "<uuid>", "status": "pending" }

GET /matches​

{
  "items": [
    {
      "matchId": "<uuid>",
      "targetDid": "did:web:...",
      "lastActivityAt": "2024-01-01T00:00:00Z",
      "unread": 2,
      "phase": "story"
    }
  ],
  "nextCursor": "abc123"
}