duneanalytics / duneanalytics/spellbook

[CONTRIBUTION] Add ToroDex (Sei-native perpetuals DEX) to perpetual.trades

Open
#9,112 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
1.5k
Forks
1.4k
Avg merge
3d 16h
Merged PRs (30d)
22

Description

[CONTRIBUTION] Add ToroDex (Centralized Perps on Sei) to Spellbook Perp Tables
High-level Description

ToroDex is a perpetual futures exchange that settles internally but accepts on-chain deposits and withdrawals on Sei.
We would like to contribute a Spellbook integration so that ToroDex activity can be queried consistently across the Dune ecosystem.

Because trade execution occurs off-chain, historical fills and funding data will be supplied by our public API, while on-chain deposit/withdraw activity will come from Sei contracts.

Our contribution will include:

A new torodex schema

Models for:

torodex.trades (via API ingestion)

torodex.funding_rates (via API)

torodex.positions (optional, if desired by Dune)

torodex.deposits / torodex.withdrawals (from Sei on-chain vault contracts)

Market metadata (symbol → base/quote, decimals, asset mappings)

Test cases + sample transactions

This will allow ToroDex to appear in unified perp abstractions (e.g., perp.trades), enabling ecosystem-level metrics such as volume, funding, open interest, and user activity.

Affected Sub-Projects

perp/ (primary)

labels/ (optional — trader labels based on ToroDex activity)

seichain/ (for vault deposit/withdraw parsing)

Why This Benefits the Community

Adds a Sei-native perps venue to Dune’s ecosystem

Enables dashboards for volume, funding, OI, and liquidity from ToroDex

Establishes a reusable pattern for centralized perps with on-chain settlement rails

Allows other Sei-based perp or hybrid exchanges to follow the same integration pattern

Expands coverage of the Sei ecosystem within Dune’s standardized perp tables

Lets researchers and developers analyze flows between on-chain vaults and off-chain execution venues

ToroDex users, Sei ecosystem teams, and analysts will gain full transparency into trading metrics and on-chain capital movements.

Additional Notes

We can supply a stable public API endpoint for:

historical + realtime trades

funding rates

market metadata

We can also provide example responses and schema definitions

Our vault contracts are deployed on Sei; we will include:

checksummed addresses

ABI/event schemas

example deposit/withdraw txs via explorer links

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the existing integrations under perp/ and seichain/, then compare their model and unified-table patterns with the proposed torodex.trades, funding_rates, deposits, and withdrawals models. The issue does not name specific files, API details, or tests; done means the supplied API and Sei vault data are integrated, tested with sample transactions, and exposed through the requested perp abstractions.

Written by the indexing model from the issue text.

Assessment

Domain
api, blockchain, data-engineering
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.