Skip to content

Conversation

@dune-eng
Copy link

This is an automated pull request to update the OpenAPI definition.

@cursor
Copy link

cursor bot commented Dec 16, 2025

PR Summary

Introduces a full OpenAPI spec with endpoints for prices, balances, transactions (EVM/SVM), collectibles, leaderboards, and webhook management, plus supporting schemas and tags.

  • OpenAPI Definition
    • Prices: GET /echo/beta/tokens/evm/{contract_address} with optional historical_prices.
    • Balances:
      • GET /echo/v1/balance/{address}/token/{token} (single token, required chain_ids).
      • GET /echo/v1/balances/evm/{address} with filters (ERC20/NATIVE), spam exclusion, metadata, pagination, historical_prices.
    • Transactions:
      • GET /echo/v1/transactions/evm/{address} with decoding, filtering (to, method_id, logs, topics), pagination.
      • GET /echo/beta/transactions/svm/{address} with pagination.
    • Collectibles: GET /echo/v1/collectibles/evm/{address} with spam filtering and optional spam scores, pagination.
    • Leaderboard: GET /echo/v1/leaderboard/evm/{address} (ERC20 holders) with pagination.
    • Webhooks:
      • GET/POST /echo/v1/subscriptions/webhooks.
      • GET/DELETE/PATCH /echo/v1/subscriptions/webhooks/{id}.
      • GET/PUT/PATCH /echo/v1/subscriptions/webhooks/{id}/addresses.
  • Components/Schemas
    • Adds comprehensive models for balances (BalanceData, BalancesResponse), transactions (TransactionBase, ResponseTransaction, logs/decoding), collectibles (CollectiblesResponse, spam features), prices (TokenData, TokensResponse), leaderboards, webhooks (Webhook, create/update/address models), pools/DEX data, warnings, and shared types.
  • Meta: Sets server https://api.sim.dune.com, API info, and tags for transactions, leaderboard, collectibles, webhooks, etc.

Written by Cursor Bugbot for commit db6b722. Configure here.

Copy link

@cursor cursor bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Comment @cursor review or bugbot run to trigger another review on this PR

"schema": {
"type": "string"
}
},
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bug: EVM transactions offset parameter incorrectly marked required

The offset parameter for /echo/v1/transactions/evm/{address} is marked as required: true, but the description states it's "a cursor being passed from the previous response." This would prevent clients from making an initial request since they wouldn't have an offset value on the first call. All other pagination endpoints in this API correctly mark offset as optional (required: false), including the similar SVM transactions endpoint.

Fix in Cursor Fix in Web

Copy link

@bh2smith bh2smith left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems Legit - although the diff is a bit hard to parse since it looks like an entirely new file.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants