Add warnings field to token-info, collectibles, and defi-positions endpoints

[shaneauerbach]

Summary

• Adds Warning schema and warnings field to the OpenAPI specs for Token Info, Collectibles, and DeFi Positions endpoints
• Extends the unsupported chain ID warnings (introduced in Chain id warnings infrastructure #136 for Balances) to all EVM endpoints for consistency
• When users request data for unsupported chain IDs, responses now include a warnings array with helpful information

Changes

The following OpenAPI specs were updated:

• evm/openapi/token-info.json - Added Warning schema and warnings field to TokensResponse
• evm/openapi/collectibles.json - Added Warning schema and warnings field to CollectiblesResponse
• evm/openapi/defi-positions.json - Added Warning schema and warnings field to DefiPositionsResponse

Warning Structure

{
  "warnings": [
    {
      "code": "UNSUPPORTED_CHAIN_IDS",
      "message": "Some chain_ids are not supported.",
      "chain_ids": [9999, 77777777777],
      "docs_url": "https://docs.sim.dune.com/evm/supported-chains"
    }
  ]
}

Related

• Follows up on backend changes in Echo repo branch api-3754/unsupported-tokens
• Extends documentation pattern from Chain id warnings infrastructure #136

Test plan

• Verify OpenAPI specs are valid JSON
• Verify warning schema matches the Balances endpoint pattern
• Review rendered documentation in Mintlify preview

[cursor]

PR Summary

Introduces non-fatal warning support across key EVM endpoints.

• Adds reusable Warning schema (code, message, optional chain_ids, docs_url)
• Adds warnings array to TokensResponse, CollectiblesResponse, and DefiPositionsResponse

^{Written by Cursor Bugbot for commit 4855ce3. Configure here.}