Add Perp volume and fees of Antarctic

[elsa3450]

Name (to be shown on DefiLlama): Antarctic
Twitter Link: https://x.com/Antarctic_EX
List of audit links if any: https://drive.google.com/file/d/1SwiKK6Wrt55g_-60ccebhV2OuO4kpiZd/view?usp=drive_link
Website Link: https://www.antarctic.exchange/
Logo (High resolution, will be shown with rounded borders): https://drive.google.com/file/d/1kUAZnDZti4ayL5Y-oAPOZDpjAo3b88Y0/view?usp=sharing

Existing protocol: Antarctic (already listed on DefiLlama for TVL as "Antarctic").

This PR adds a new "Antarctic Perps" product under the same protocol, exposing:

• perpetual futures daily volume
• trading fees

Category: Derivatives – Perpetuals
Chains: Arbitrum One, BNB Smart Chain, Ethereum

Data source (public API):

• https://prod-openapi.antarctic.exchange/futures/common/v1/perpetual/contracts
• https://prod-openapi.antarctic.exchange/futures/common/v1/perpetual/fee

Metrics returned by this adapter:

• dailyVolume – notional perpetual trading volume (used for Perp Volume 24h/7d/30d/cumulative)
• dailyFees – total perpetual trading fees paid by users

Methodology:

• Fees: Fees paid by users on perpetual futures trades.
• Perp Volume: Notional volume of all perpetual futures trades in the protocol, includes leverage.

[llamabutler]

The antarctic adapter exports:

> adapters@1.0.0 test
> ts-node --transpile-only cli/testAdapter.ts dexs antarctic

🦙 Running ANTARCTIC adapter 🦙
---------------------------------------------------
Start Date:	Tue, 02 Dec 2025 00:00:00 GMT
End Date:	Wed, 03 Dec 2025 00:00:00 GMT
---------------------------------------------------

OFF_CHAIN 👇
Backfill start time: 10/5/2025
Daily volume: 286.82 M

[llamabutler]

The antarctic adapter exports:

> adapters@1.0.0 test
> ts-node --transpile-only cli/testAdapter.ts fees antarctic

🦙 Running ANTARCTIC adapter 🦙
---------------------------------------------------
Start Date:	Tue, 02 Dec 2025 00:00:00 GMT
End Date:	Wed, 03 Dec 2025 00:00:00 GMT
---------------------------------------------------

OFF_CHAIN 👇
Backfill start time: 10/5/2025
Daily fees: 74.57 k

[noateden]

hi @elsa3450 thanks for the PR. Any change we can track data from on-chain contracts?

[elsa3450]

hi @noateden, Thanks for the review and the question.

For our current architecture, the perpetuals matching engine runs off-chain.
Trades and fees are recorded in our internal engine and exposed through our
public stats APIs, but we do not emit on-chain events for each perp trade / fee.

On-chain, we only have the vault / margin related contracts that are already
used for the TVL adapter (deposits, withdrawals, etc.), so there is currently
no reliable way to reconstruct perp volume and fees purely from on-chain
events.

[elsa3450]

hi @noateden，thanks for checking.

Our perp engine is currently off-chain, so the adapter reads data from our public APIs rather than directly from on-chain contracts:
https://prod-openapi.antarctic.exchange/futures/common/v1/perpetual/contracts
https://prod-openapi.antarctic.exchange/futures/common/v1/perpetual/fee

These endpoints are the same sources we use for the stats shown in the UI, and we don’t have a way to reconstruct perp volume/fees purely from on-chain data at the moment.

[llamabutler]

The antarctic adapter exports:

> adapters@1.0.0 test
> ts-node --transpile-only cli/testAdapter.ts dexs antarctic

🦙 Running ANTARCTIC adapter 🦙
---------------------------------------------------
Start Date:	Wed, 10 Dec 2025 00:00:00 GMT
End Date:	Thu, 11 Dec 2025 00:00:00 GMT
---------------------------------------------------

OFF_CHAIN 👇
Backfill start time: 10/5/2025
Daily volume: 260.58 M

[llamabutler]

The antarctic adapter exports:

> adapters@1.0.0 test
> ts-node --transpile-only cli/testAdapter.ts fees antarctic

🦙 Running ANTARCTIC adapter 🦙
---------------------------------------------------
Start Date:	Wed, 10 Dec 2025 00:00:00 GMT
End Date:	Thu, 11 Dec 2025 00:00:00 GMT
---------------------------------------------------

OFF_CHAIN 👇
Backfill start time: 10/5/2025
Daily fees: 77.90 k

[noateden]

hi @elsa3450, do you have open interest API data?

[elsa3450]

hi @noateden，You can obtain the open interest of all our symbols through the following API.
https://prod-openapi.antarctic.exchange/futures/common/v1/perpetual/open-interest

Alternatively, you can obtain the open interest of a specified symbol through the API below.
https://prod-openapi.antarctic.exchange/futures/common/v1/perpetual/symbol/open-interest?symbol={SYMBOL}

If you have any requirements regarding the data that the API needs to provide, please provide guidance, and we will adjust accordingly.

[llamabutler]

The antarctic adapter exports:

> adapters@1.0.0 test
> ts-node --transpile-only cli/testAdapter.ts dexs antarctic

🦙 Running ANTARCTIC adapter 🦙
---------------------------------------------------
Start Date:	Fri, 12 Dec 2025 00:00:00 GMT
End Date:	Sat, 13 Dec 2025 00:00:00 GMT
---------------------------------------------------

OFF_CHAIN 👇
Backfill start time: 10/5/2025
Daily volume: 234.93 M

[llamabutler]

The antarctic adapter exports:

> adapters@1.0.0 test
> ts-node --transpile-only cli/testAdapter.ts fees antarctic

🦙 Running ANTARCTIC adapter 🦙
---------------------------------------------------
Start Date:	Fri, 12 Dec 2025 00:00:00 GMT
End Date:	Sat, 13 Dec 2025 00:00:00 GMT
---------------------------------------------------

OFF_CHAIN 👇
Backfill start time: 10/5/2025
Daily fees: 67.62 k

[llamabutler]

The antarctic-oi.ts adapter exports:

> adapters@1.0.0 test
> ts-node --transpile-only cli/testAdapter.ts open-interest antarctic-oi.ts

🦙 Running ANTARCTIC-OI.TS adapter 🦙
---------------------------------------------------
Start Date:	Fri, 12 Dec 2025 00:00:00 GMT
End Date:	Sat, 13 Dec 2025 00:00:00 GMT
---------------------------------------------------

OFF_CHAIN 👇
Open interest at end: 319.33 M

[noateden]

updated #5060