curl "https://api.metastreams.io/v1/trades?identity=kol&limit=50" \
  -H "Authorization: Bearer $API_KEY"

curl "https://api.metastreams.io/v1/trades?identity=fomoscan&chains=solana,base" \
  -H "Authorization: Bearer $API_KEY"

const url = new URL("https://api.metastreams.io/v1/trades");
url.searchParams.set("identity", "kol");
url.searchParams.set("chains", "solana,base");

const response = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const { trades, nextCursor, hasMore } = await response.json();

{
  "trades": [
    {
      "id": "4xQmVb8e2kT1nR7pZcW3sLdHfA9jEuY6gVnX1oB5iC0wQ2rT8yU3iO7pA1sD4fG6h:2",
      "chain": "solana",
      "token": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
      "name": "Bonk",
      "symbol": "Bonk",
      "trader": "7YttLkHDoNj9wyDur5pM1ejNaAvT9X4eqaYcHQqtj2G5",
      "transactionHash": "4xQmVb8e2kT1nR7pZcW3sLdHfA9jEuY6gVnX1oB5iC0wQ2rT8yU3iO7pA1sD4fG6h",
      "side": "buy",
      "amount": "12500000",
      "price": { "native": "0.000000121", "usd": "0.0000216" },
      "volume": { "native": "1.51", "usd": "270.12" },
      "marketCap": { "native": "10741962.1", "usd": "1917440000" },
      "identities": [
        {
          "source": "fomoscan",
          "handle": "degenspartan",
          "displayName": "Degen Spartan",
          "avatar": "https://cdn.example.com/avatars/degenspartan.png",
          "twitter": "degenspartan",
          "telegram": null,
          "farcaster": null
        }
      ],
      "timestamp": 1789632015120
    }
  ],
  "nextCursor": null,
  "hasMore": false
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "One or more parameters are invalid.",
    "details": [{ "field": "identity", "message": "Must be one of: kol, fomoscan." }]
  }
}