# Welcome to Obsidian Finance
Experience seamless trading across various DEXs with our Smart DEX aggregator
{% hint style="info" %}
Trade, earn, and win crypto on the AI-powered DeFi DEX aggregator platform on Cronos.
{% endhint %}
### Introduction to Obsidian: Your Smart DEX Aggregator
Welcome to Obsidian, the newest addition to our suite of Defi solutions. Obsidian is a smart DEX aggregator designed to streamline your trading experience by seamlessly integrating with multiple DEXs to ensure you get the best possible trading rates.
#### What is Obsidian?
Obsidian is more than just another DEX. It is a sophisticated, smart DEX aggregator that connects with various decentralized exchanges, allowing you to find the most favorable trading rates with minimal effort. By leveraging advanced algorithms and our proprietary SmartRouter technology, Obsidian optimizes your trades, saving you time and money.
### Key Features of Obsidian
**1. Smart Routing for Best Rates**
One of the standout features of Obsidian is its ability to find the best trading rates across multiple DEXs. When you initiate a trade, our SmartRouter evaluates various available exchanges, ensuring that you get the most competitive price. This not only enhances your trading efficiency but also maximizes your returns.
**2. Liquidity Provision**
By providing liquidity, you can earn rewards and contribute to the overall health and efficiency of the ecosystem. Whether you are a seasoned trader or a newcomer, adding liquidity to Obsidian is a straightforward process that can offer significant benefits.
**3. Seamless Integration**
Our SmartRouter technology ensures seamless integration with other DEXs. This means that even if you choose to add liquidity on Obsidian, our system will still search for the best trading routes across other exchanges. You can rest assured that you are always getting the best rates, regardless of where the liquidity originates.
#### Why Choose Obsidian?
**Optimized Trading Experience**
With Obsidian, you no longer need to manually search for the best trading rates. Our SmartRouter does the heavy lifting for you, analyzing multiple exchanges in real-time to find the optimal trading path.
**Enhanced Liquidity Options**
By allowing users to add liquidity, Obsidian creates a more dynamic and flexible trading environment. Liquidity providers can earn rewards while traders benefit from improved market conditions.
**Cutting-Edge Technology**
Obsidian leverages state-of-the-art technology to deliver a superior trading experience. Our platform is built with scalability and security in mind, ensuring that your trades are executed smoothly and safely.
### Get Started with Obsidian
Ready to experience the future of decentralized trading? Getting started with Obsidian is easy:
1. **Connect Your Wallet**: Link your preferred cryptocurrency wallet to the Obsidian platform.
2. **Add Liquidity**: Choose the tokens you want to provide as liquidity and add them to the Obsidian pool.
3. **Start Trading**: Use our intuitive interface to initiate trades. Our SmartRouter will automatically find the best trading routes for you.
Join us in revolutionizing the DEX landscape with Obsidian. Whether you're adding liquidity or trading, Obsidian ensures you get the best rates and a seamless experience.
## Quick links
{% content-ref url="/spaces/hGXU2Bkhc8kxeNzLmq9Y/pages/7HQBXsuC2zxrWxi3JVx0" %}
[Contracts](/dex/contracts)
{% endcontent-ref %}
## Get Started
We've put together some helpful guides for you to get setup with Obsidian quickly and easily.
{% content-ref url="/spaces/hGXU2Bkhc8kxeNzLmq9Y/pages/pz5KvTHgMWFPcxXdG4B0" %}
[Wallet Setup](/get-started/wallet-setup)
{% endcontent-ref %}
# Swap
\* Under construction
{% hint style="warning" %}
Raise slippage if your are trading tokens with buy or sell tax.
{% endhint %}
# Contracts
Obsidian Dex Contracts
{% hint style="info" %}
Contracts might change but to be communicated in our Discord server.
{% endhint %}
**Obsidian Finance Smart Contracts on Cronos Mainnet and zkCRO EVM**
Welcome to the Obsidian Finance Smart Contracts page. Here, we provide detailed information about the smart contracts deployed on both the Cronos Mainnet and Cronos zkCRO EVM. These contracts power our decentralized exchange aggregator, liquidity pools, staking, and farms modules, ensuring a secure and seamless trading experience.
For each network, you will find the contract addresses for core components such as the Obsidian Smart Router, liquidity pools, staking contracts, and more.
| Name | Contract Address |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| v2SwapRouter |
|
| FarmV2 | **Cronos Mainent:** [0x8a44aC7D38B9925D2437803520ED38ae5C3120e5](https://explorer.cronos.org/address/0x8a44aC7D38B9925D2437803520ED38ae5C3120e5#code) |
# Obsidian Royalties
Obsidian introduces **Royalties**, a feature designed to foster the growth of the Cronos ecosystem by redistributing aggregator fees collected during token transactions. This initiative empowers project founders with funds to support development and marketing efforts, ensuring a sustainable future for projects on Cronos.
### How It Works
* **Aggregator Fees**:\
Each transaction on Obsidian collects a **0.4% aggregator fee**.
* **Royalties Distribution**:\
These fees are sent to the Obsidian Royalties contract and distributed as follows:
* **50% to Partner Projects**:\
Partner projects and tokens with qualifying liquidity will receive a share of the **aggregator fees collected specifically from transactions involving their token** (usually from token purchases).
* **50% to $OBS Auto-Burn**:\
The remaining fees are automatically swapped to **$OBS** and burned 🔥 during each royalty claim, supporting Obsidian's token and reducing its supply.
*\*We reserve the right to amend the royalty program details at any time and in our sole discretion. Any changes will be effective immediately upon posting the updated terms. By continuing to use the service after any such changes, you agree to be bound by the updated conditions. We encourage you to review our documentation periodically to stay informed of any modifications.*
### Benefits to Projects
1. **Partner Projects**:
* Obsidian will share transaction fees with projects using their services.
* **First Partner**: [puush.fun](https://puush.fun)
* All graduated tokens that choose Obsidian for their Liquidity will receive **50% of the aggregator fees collected from their token transactions**.
2. **Liquidity-Based Eligibility**:
* Tokens maintaining more than **$10,000 USD bunt or locked liquidity** on Obsidian are eligible to enroll for royalty benefits.
\**Projects graduating to Obsidian and those based on liquidity must maintain over $10,000 in liquidity. Falling below this threshold disqualifies them from the Royalties program until the requirement is met again.*
### How to Claim Royalties
Project founders can claim their royalties in just two steps:
1. **Set Up Your Claim**:
* Create a ticket in our [Discord server](https://obsidian.finance/discord), and our team will assist you in setting up your royalties.
2. **Claim Royalties**:
* Once set up, you can claim your royalties directly on the [Obsidian Royalties page](https://obsidian.finance/royalties).
#### Important Note
Only the aggregator fees collected from transactions involving your token will be eligible for royalties. Typically, these fees are generated from **token purchases but not sales.**
### Unclaimed Tokens
Unclaimed tokens after 60 days of transfer within the royalties contract won't go to waste! They will be used for:
* **Mystery Prizes**: Exciting rewards for platform users.
* **Other Rewards**: Incentives to engage and grow our community.
### Our Vision
The goal of Obsidian Royalties is to provide sustainable funding solutions for Cronos projects. By empowering both small and large projects, we aim to create a thriving ecosystem that fosters innovation and growth on the Cronos chain.
# LP Farms
# Fixed Staking
#### 🔒Fixed Staking - Early Withdrawal Rules
\
If you stake in a Fixed Pool and decide to withdraw before the lock period ends, here’s exactly how it works
***
#### 💰Do I lose my rewards if I exit early?
\
No.
You keep all rewards accrued up to that point.
The contract always calculates:
* Rewards already accumulated
* Plus new rewards earned since your last action
Those rewards are added to your payout, even if you leave early.
***
#### ✂️Where does the penalty apply?
\
The penalty is applied only to your original deposit, not to rewards.
Your final payout is:
Penalized principal + 100% of earned rewards
***
#### ⏳How early-exit penalties are calculated
\
Each pool’s lock period is split into 3 equal phases:
**Phase 1:** No withdrawals allowed,\
**Phase 2:** Partial principal unlocked (Penalty Tier 1),\
**Phase 3:** Larger principal unlocked (Penalty Tier 2),
Depending on when you exit, the contract applies one of these:
withdrawalCut1 → % of principal returned in Phase 2,\
withdrawalCut2 → % of principal returned in Phase 3,
Rewards are **always fully included.**
***
#### ✅Summary
\
• Early withdrawals keep all earned rewards\
• Penalties affect only the principal\
• Lock period has 3 stages\
• The later you exit, the less principal is cut
# Token Listing on Obsidian
At Obsidian, we strive to create a diverse and inclusive platform that supports tokens of all sizes. Whether you're a newly launched project or an established token, we welcome you to apply for listing on Obsidian. We are committed to providing access to the best trading rates through our comprehensive liquidity sources, including our own liquidity pools, as well as aggregating from VVS, Ebisus, and H2 Finance.
### How to Get Listed
There are two simple ways for a token to get listed on Obsidian:
1. **Discord Ticket**: Reach out to our team via our [Discord server](https://discord.gg/HSDJPQTeDX) and create a ticket. Our team will review your request and guide you through the process.
2. **Online Form**: Alternatively, you can fill out our [listing form](https://obsidian.finance/listing), which helps us gather all the necessary information to evaluate your token for listing.
### Listing Criteria
While we support tokens of all sizes, including those with smaller liquidity pools, we have certain requirements to ensure the security and integrity of our platform:
* **Compliance**: We will check that your token’s smart contract is compliant with security best practices.
* **Social Media**: The token must have an updated social media presence, including links on its Dexscreener profile.
* **Active Community**: Tokens with an engaged, active community are prioritized, as this demonstrates the project's commitment to growth and user engagement.
#### Liquidity Pools
We do not require tokens to have their own liquidity pools on Obsidian to be listed. Since we aggregate liquidity from multiple sources, including VVS, Ebisus, H2 Finance, and our own liquidity pools, we always prioritize the best pool prices for users. However, we do provide the opportunity for tokens to create liquidity pools on Obsidian, which can further enhance visibility and trading volume.
### Obsidian's Right to Reject or Remove Listings
While we strive to support a broad range of tokens, Obsidian reserves the right to reject any listing requests or remove tokens from the platform at our discretion. This decision may be based on security concerns, compliance issues, or other factors that may affect the safety of our community and investors.
At Obsidian, the security and integrity of our platform and its users are always our top priority.
# API Docs v2
Integrate Obsidian swap routing into your project and unlock quest tracking for approved middleman contracts on Cronos.
Welcome to the **Powered by Obsidian** integration guide.
This documentation is for third-party projects that want to:
* Route swaps through Obsidian's aggregator
* Display Obsidian's whitelisted token list and logos
* Earn quest tracking attribution for their users when routing through approved middleman contracts
{% hint style="info" %}
**Note.** This is a public partner guide. It only covers supported external integration flows and onboarding requirements.
{% endhint %}
{% hint style="info" %}
**AI-friendly by design.** The endpoint summaries, request bodies, and examples in this guide are structured so they can be handed directly to your editor or coding assistant with minimal rewriting. See Section 5 for prompts and workflows.
{% endhint %}
## Quick Reference
### Environment
| Item | Value |
| ------------------------ | -------------------------------------------- |
| Base URL | `https://api.obsidian.finance` |
| Cronos chain ID | `25` |
| Native token placeholder | `0x0000000000000000000000000000000000000000` |
| WCRO | `0x5C7F8A570d578ED84E63fdFA7b1eE72dEae1AE23` |
| Obsidian router | `0x1189331089b6ca8beA989C1F2fFd0EfAdCd33a69` |
### Capabilities
| Capability | Status | Notes |
| ----------------------------------------------- | -------------------- | ------------------------------------------- |
| Direct swap integration | ✅ Supported | Public quote and calldata routes |
| Public token list and logos | ✅ Supported | Helper route for token pickers and branding |
| Quest tracking for approved middleman contracts | 🔒 Supported (gated) | Requires review and a partner API key |
| Custom dual-recipient partner fee splitting | ⛔ Not in public flow | Not documented here |
### Endpoint Summary
| Purpose | Method | Route |
| ------------------------------------------- | ------ | --------------------------------- |
| Get quote | `POST` | `/:chainId/v1/getquote` |
| Build swap calldata | `POST` | `/v1/getswap` |
| Get public token list | `GET` | `/:chainId/v1/whitelisted-tokens` |
| Submit partner tx hashes for quest tracking | `POST` | `/v1/partners/trades/ingest` |
## 1. Direct Swap Integration
The end-to-end partner swap flow is three steps:
1. Call `POST /:chainId/v1/getquote`
2. Call `POST /v1/getswap`
3. Broadcast the returned router transaction
The currently documented execution path is `EXACT_INPUT`.
### 1.0 Workflow Overview
```
Your App ──▶ POST /:chainId/v1/getquote ──▶ Obsidian Quote API
◀── quote, routes, gas estimate ◀──
Your App ──▶ POST /v1/getswap ──▶ Obsidian Calldata API
◀── calldata, routerAddress, value ◀──
Your User ──▶ signs and broadcasts transaction ──▶ Cronos
Your Backend ──▶ POST /v1/partners/trades/ingest ──▶ Obsidian Quest Tracking
◀── processed / skipped / failed ◀──
```
### 1.1 Get Quote
**Route**
```http
POST /25/v1/getquote
```
**Request body**
```json
{
"currency": {
"address": "0x7A86f7f7cF2F08E8D4B7C13C7C6F54C5B8d38fA8",
"decimals": 18,
"symbol": "TOKEN",
"name": "Example Token"
},
"tradeType": 0,
"amount": {
"currency": {
"address": "0x0000000000000000000000000000000000000000",
"decimals": 18,
"symbol": "CRO",
"name": "Cronos"
},
"value": "150000000000000000000"
},
"maxSplits": 0
}
```
**Request notes**
* Use `tradeType: 0` for exact-input quoting.
* Use the zero address `0x0000...0000` for native CRO.
* `amount.value` must be the raw integer amount in smallest units.
* `maxSplits: 0` is the simplest default.
**Response highlights**
| Field | Meaning |
| -------------- | ---------------------------------- |
| `fee` | Quote fee metadata |
| `gasEstimate` | Estimated gas for the quoted route |
| `inputAmount` | Effective input amount |
| `outputAmount` | Effective output amount |
| `routes` | Route breakdown used for execution |
| `tradeType` | Returned trade type metadata |
{% hint style="info" %}
**Implementation notes.** The quote fee currently resolves to `0.004` (`0.4%`). `gasEstimateInUSD` exists in the response shape, but should not be treated as authoritative today.
{% endhint %}
### 1.2 Build Swap Calldata
**Route**
```http
POST /v1/getswap
```
Converts a quote into executable router calldata.
**Request body**
```json
{
"trade": {
"tradeType": "EXACT_INPUT",
"inputAmount": {
"currency": {
"isNative": true,
"wrapped": {
"address": "0x0000000000000000000000000000000000000000"
}
},
"quotient": "150000000000000000000"
},
"outputAmount": {
"currency": {
"isNative": false,
"wrapped": {
"address": "0x7A86f7f7cF2F08E8D4B7C13C7C6F54C5B8d38fA8"
}
},
"quotient": "123456789000000000000"
},
"routes": [
{
"path": [
{
"wrapped": {
"address": "0x5C7F8A570d578ED84E63fdFA7b1eE72dEae1AE23"
}
},
{
"wrapped": {
"address": "0x7A86f7f7cF2F08E8D4B7C13C7C6F54C5B8d38fA8"
}
}
],
"pools": [
{
"address": "0xYourPoolAddress"
}
],
"inputAmount": {
"currency": {
"isNative": true,
"wrapped": {
"address": "0x0000000000000000000000000000000000000000"
}
},
"quotient": "150000000000000000000"
},
"outputAmount": {
"currency": {
"isNative": false,
"wrapped": {
"address": "0x7A86f7f7cF2F08E8D4B7C13C7C6F54C5B8d38fA8"
}
},
"quotient": "123456789000000000000"
},
"type": "V2"
}
]
},
"options": {
"slippageTolerance": {
"numerator": "5",
"denominator": "1000"
},
"recipient": "0xYourUserWallet",
"deadlineOrPreviousBlockhash": "1735689600"
},
"chainId": 25,
"userAddress": "0xYourUserWallet"
}
```
**Mapping rules: quote → trade**
| From `quote` | To `trade` |
| ---------------------------------- | ----------------------------------------- |
| `quote.inputAmount.value` | `trade.inputAmount.quotient` |
| `quote.outputAmount.value` | `trade.outputAmount.quotient` |
| `quote.routes[i].path[j].address` | `trade.routes[i].path[j].wrapped.address` |
| `quote.routes[i].pools[k].address` | `trade.routes[i].pools[k].address` |
| (constant) | `trade.tradeType = "EXACT_INPUT"` |
Additional rules:
* When a token is native CRO, always set `isNative: true`.
* Preserving the native zero address at the trade-level input is acceptable.
* Route paths still use wrapped-token hop addresses, so native CRO routes usually begin with WCRO.
* For native output, use the WCRO address anywhere a wrapped output address is required. The API appends the unwrap step internally.
**Response highlights**
| Field | Meaning |
| --------------- | ---------------------------------------------- |
| `calldata` | Router calldata to broadcast |
| `value` | Native value to send with the tx |
| `routerAddress` | Router contract to call |
| `estimatedGas` | Estimated gas usage |
| `paths` | Path and pool breakdown |
| `recipient` | Final swap recipient |
| `multiHopRoute` | Whether the route spans multiple hops |
| `feeApplied` | Obsidian fee metadata in the built transaction |
**Broadcasting**
Send the user's transaction with:
| Tx field | Source |
| -------- | --------------- |
| `to` | `routerAddress` |
| `data` | `calldata` |
| `value` | `value` |
{% hint style="info" %}
**Execution guidance.** `estimatedGas` already includes an API-side safety buffer. If you add more padding client-side, keep it conservative. `deadlineOrPreviousBlockhash` should usually be a future Unix timestamp. If you omit it, Obsidian defaults the deadline to roughly **10 minutes** from request time.
{% endhint %}
### 1.3 Compact End-to-End Example
The fastest possible implementation handoff to an engineer or an LLM.
{% stepper %}
{% step %}
### Get a quote
```bash
curl -s https://api.obsidian.finance/25/v1/getquote \
-H 'Content-Type: application/json' \
-d '{
"currency": {
"address": "0x6135c840c511a112457d647Aad82a26412a4fa7D",
"decimals": 18,
"symbol": "LAZY",
"name": "Lazy Horse"
},
"tradeType": 0,
"amount": {
"currency": {
"address": "0x0000000000000000000000000000000000000000",
"decimals": 18,
"symbol": "CRO",
"name": "Cronos"
},
"value": "150000000000000000000"
},
"maxSplits": 0
}'
```
{% endstep %}
{% step %}
### Build swap calldata from the returned quote
```bash
curl -s https://api.obsidian.finance/v1/getswap \
-H 'Content-Type: application/json' \
-d '{
"trade": {
"tradeType": "EXACT_INPUT",
"inputAmount": {
"currency": {
"wrapped": { "address": "0x0000000000000000000000000000000000000000" },
"isNative": true
},
"quotient": "150000000000000000000"
},
"outputAmount": {
"currency": {
"wrapped": { "address": "0x6135c840c511a112457d647Aad82a26412a4fa7D" },
"isNative": false
},
"quotient": "20028343121762563187544"
},
"routes": [
{
"path": [
{ "wrapped": { "address": "0x5C7F8A570d578ED84E63fdFA7b1eE72dEae1AE23" } },
{ "wrapped": { "address": "0x3b41B27E74Dd366CE27cB389dc7877D4e1516d4d" } },
{ "wrapped": { "address": "0x6135c840c511a112457d647Aad82a26412a4fa7D" } }
],
"pools": [
{ "address": "0xA51231984ff01F4933a9FA24E8fd143f18ae6772" },
{ "address": "0xD9A74F078418e66BF787036c2a722B3c38704281" }
],
"inputAmount": {
"currency": {
"wrapped": { "address": "0x0000000000000000000000000000000000000000" },
"isNative": true
},
"quotient": "150000000000000000000"
},
"outputAmount": {
"currency": {
"wrapped": { "address": "0x6135c840c511a112457d647Aad82a26412a4fa7D" },
"isNative": false
},
"quotient": "20028343121762563187544"
},
"type": "V2"
}
]
},
"options": {
"slippageTolerance": {
"numerator": "5",
"denominator": "1000"
},
"recipient": "0xYourUserWallet",
"deadlineOrPreviousBlockhash": "1747804299"
},
"chainId": 25,
"userAddress": "0xYourUserWallet"
}'
```
{% endstep %}
{% step %}
### Send the transaction
Use the `/getswap` response as:
| Tx field | Source |
| ---------- | --------------- |
| `to` | `routerAddress` |
| `data` | `calldata` |
| `value` | `value` |
| `gasLimit` | `estimatedGas` |
Your app or wallet client then signs and broadcasts the transaction normally.
{% endstep %}
{% endstepper %}
## 2. Public Token List
Pull token metadata and logos for swap forms, token pickers, and branding.
**Route**
```http
GET /:chainId/v1/whitelisted-tokens
```
**Example**
```http
GET /25/v1/whitelisted-tokens
```
**Returned token fields**
| Field | Meaning |
| ---------- | ---------------- |
| `name` | Token name |
| `symbol` | Token symbol |
| `address` | Contract address |
| `decimals` | Token decimals |
| `logoURI` | Token logo URL |
**Rate limits**
* Public route
* Rate limited per IP
* Current default limit: **60 requests per minute**
## 3. Quest Tracking for Partner Contracts
If your project uses its own middleman contract and still wants Obsidian quest tracking, onboarding starts with a Discord ticket.
### 3.1 Open a Discord Ticket With
| Required item | Notes |
| ------------------------------------------ | ---------------------------------------------------- |
| Project name and primary contact | Main point of contact for follow-up |
| Target chain ID | For example `25` for Cronos |
| Deployed contract address or addresses | Include all relevant live contracts |
| Block explorer links | Explorer links for each contract |
| Verified contract on the relevant explorer | Obsidian can pull contract details from there |
| Flow description | Explain how your contract routes swaps into Obsidian |
| One to three real successful tx hashes | Use live successful examples |
| Expected end-user wallet for each tx hash | Needed for attribution validation |
| Fee-flow explanation | Include if your contract skims fees before routing |
### 3.2 Contract Requirements
The important requirement is not the outer contract brand or implementation style. The important requirement is that **Obsidian can prove the end user and the actual routed swap.**
Your contract must:
* Forward a decodable Obsidian router call inside the transaction flow
* Route the swap so the nested Obsidian recipient is the real end user
* Provide a reliable way to attribute the end user
**Supported attribution sources**
* Transaction sender
* A function argument
* An emitted event argument
**Preferred event fields**
| Field | Priority |
| -------------- | -------- |
| `user` | Required |
| `inputToken` | Required |
| `inputAmount` | Required |
| `feeAmount` | Required |
| `outputToken` | Helpful |
| `outputAmount` | Helpful |
**Example event shape**
```solidity
event Swap(
address indexed user,
address inputToken,
uint256 inputAmount,
uint256 feeAmount,
address outputToken,
uint256 outputAmount
);
```
{% hint style="warning" %}
**Important notes.** Output token and output amount are helpful, but they are not the main source of truth. Obsidian verifies partner trades primarily from nested router calldata and token transfer logs. Quest volume is tracked from the net amount that actually reached Obsidian after any partner-side skim.
{% endhint %}
### 3.3 Partner API Key
After your contract flow is approved, Obsidian will issue a partner API key.
| Item | Value |
| ------------------ | -------------------------------------------------- |
| Header name | `x-obsidian-partner-key` |
| Header format | `clientId.secret` |
| Default rate limit | `60` requests per minute per key |
| Scope | Approved chain IDs and approved contract addresses |
### 3.4 Submit Transaction Hashes
**Route**
```http
POST /v1/partners/trades/ingest
```
**Headers**
{% hint style="warning" %}
**Implementation note.** Call this route from your backend, worker, or serverless function. Do not expose x-obsidian-partner-key in frontend or browser code. Store the key in an environment variable or server-side secret.
{% endhint %}
```
x-obsidian-partner-key: clientId.secret
Content-Type: application/json
```
**Request body**
```json
{
"chainId": 25,
"txHashes": [
"0x1111111111111111111111111111111111111111111111111111111111111111",
"0x2222222222222222222222222222222222222222222222222222222222222222"
]
}
```
**Request rules**
* Maximum **4 unique transaction hashes** per request
* Hashes must be standard `0x`-prefixed transaction hashes
* Re-submitting the same successful transaction is safe and idempotent
* Default partner-key rate limit is `60` requests per minute unless Obsidian provisions a different limit for your project
**Response shape**
```json
{
"partnerProjectSlug": "example-project",
"partnerKeyId": "abc123",
"chainId": 25,
"submittedCount": 2,
"processedCount": 1,
"skippedCount": 1,
"failedCount": 0,
"results": [
{
"txHash": "0x1111111111111111111111111111111111111111111111111111111111111111",
"status": "processed",
"message": "Swap details processed successfully."
},
{
"txHash": "0x2222222222222222222222222222222222222222222222222222222222222222",
"status": "skipped_existing",
"message": "Transaction already processed."
}
]
}
```
**Result statuses**
| Status | Meaning |
| ------------------ | ------------------------------------------------------------------------------ |
| `processed` | The trade was verified and written into Obsidian trade tracking |
| `skipped_existing` | The transaction was already processed earlier |
| `failed` | The hash was received but could not be verified for the approved partner scope |
## 4. Final Notes
* Direct swap integration routes are public.
* Partner quest tracking ingestion is authenticated and only enabled after contract review.
* If your project wants quest tracking, **provide real sample transactions early.** That shortens onboarding more than anything else.
## 5. Building with AI
This API was designed to be readable by coding assistants. The endpoint summaries, request bodies, mapping rules, and examples are written so that an AI agent can scaffold a working integration with minimal hand-holding.
This section gives you the patterns, prompts, and guardrails to do it well.
### 5.1 Why This Doc Is AI-Friendly
The structure of this guide is deliberate:
| Pattern | Why it matters for AI |
| ---------------------------- | ------------------------------------------------------------------ |
| Stable endpoint tables | Models can cite exact routes without hallucinating paths |
| Explicit request bodies | Models can copy the shape instead of guessing field names |
| Quote-to-trade mapping table | The most error-prone step is spelled out as a direct map |
| Constant values in tables | Router, WCRO, native placeholder, and chain ID are easy to extract |
| Compact end-to-end example | Models can use it as a single-shot reference for full flows |
When you hand this doc to an assistant, you do not need to re-explain any of these. They are already in a form the model can use.
### 5.2 Recommended Workflow
A simple loop that works for most partner integrations:
```
1. Paste the relevant section of this doc into your assistant.
2. Tell it your stack (Next.js, ethers.js, viem, wagmi, etc.).
3. Tell it what you want (quote, swap, token picker, ingest worker).
4. Ask for a single self-contained module first.
5. Have it write a test against the example payloads in Section 1.3.
6. Iterate.
```
The shorter and more specific the prompt, the better the output.
### 5.3 Starter Prompts
Copy, adapt, and paste. Each prompt assumes you have also provided the relevant doc section to the assistant.
**Quote and Swap (Frontend)**
```
Using the Powered by Obsidian Partner API docs I provided, generate a
TypeScript module for a Next.js app using viem that:
- Accepts an input token, output token, and input amount in human-readable form
- Calls POST /25/v1/getquote with the correct shape
- Maps the response to POST /v1/getswap using the mapping rules in section 1.2
- Returns { to, data, value, gasLimit } ready to pass to a wallet client
- Treats CRO as native using the zero address
- Uses 0.5% slippage as the default
Use exact field names from the docs. Do not invent fields.
```
**Token Picker (Frontend)**
```
Using the Powered by Obsidian Partner API docs, build a React component that:
- Fetches GET /25/v1/whitelisted-tokens on mount
- Renders a searchable token list with logo, symbol, name, and address
- Caches results in memory for the session
- Falls back gracefully if the request fails
Use the exact field names from section 2.
```
**Partner Ingest Worker (Backend)**
```
Using the Powered by Obsidian Partner API docs, write a Node.js worker that:
- Watches our contract for Swap events
- Buffers tx hashes
- Every 30 seconds (or when 4 hashes are buffered) calls
POST /v1/partners/trades/ingest with the x-obsidian-partner-key header
- Logs processed, skipped, and failed counts
- Respects the 60 req/min rate limit
- Reads the partner key from an env var, never hardcoded
Use exact field names from section 3.4.
```
**Contract Scaffolding (Quest Tracking Onboarding)**
```
Using section 3 of the Powered by Obsidian Partner API docs, write a Solidity
event and a swap function that:
- Emits the preferred event shape with user, inputToken, inputAmount, feeAmount,
outputToken, outputAmount
- Forwards the swap to the Obsidian router with the end user as the nested recipient
- Skims a 0.25% fee in the input token before forwarding
Make the user attribution work via the indexed `user` argument in the event.
```
### 5.4 Guardrails When Building with AI
Coding assistants are excellent at scaffolding and weak at on-chain reasoning. Use these guardrails:
| Guardrail | Why |
| -------------------------------------------------- | ----------------------------------------------------------------- |
| Always verify the router address from this doc | Models sometimes invent or stale-cache addresses |
| Always confirm the chain ID is `25` | Some models default to mainnet-style chain IDs |
| Always test with small amounts on Cronos first | An incorrect calldata field will silently route wrong |
| Pin the exact `tradeType` values | `0` is for the quote route, `"EXACT_INPUT"` is for the swap route |
| Treat `gasEstimateInUSD` as informational only | Documented as non-authoritative |
| Never let an AI agent hold your partner API key | Use a server-side proxy and inject the key from env |
| Diff AI output against the example payloads in 1.3 | Field-by-field comparison catches almost every shape error |
### 5.5 Suggested Project Files for AI-First Builders
If you are starting a new partner integration, this is a clean repo layout that AI assistants tend to handle well:
```
your-partner-app/
├── docs/
│ └── obsidian-partner-api.md ← drop this guide in
├── lib/
│ ├── obsidian/
│ │ ├── quote.ts ← POST /:chainId/v1/getquote
│ │ ├── swap.ts ← POST /v1/getswap
│ │ ├── tokens.ts ← GET /:chainId/v1/whitelisted-tokens
│ │ └── mapping.ts ← quote → trade mapping helpers
├── server/
│ └── ingest-worker.ts ← POST /v1/partners/trades/ingest
├── contracts/
│ └── PartnerRouter.sol ← optional middleman contract
└── tests/
└── obsidian.spec.ts ← uses the 1.3 example payloads
```
Point your assistant at this structure and ask it to fill in one file at a time. Small, focused prompts beat one giant prompt every time.
### 5.6 When To Ask Obsidian Instead Of An AI
Some things an AI cannot answer for you. Open a Discord ticket if:
* You need quest tracking enabled for a custom middleman contract
* You need a higher rate limit than `60` requests per minute
* Your event attribution does not match any of the supported attribution sources
* You see consistent `failed` statuses in your ingest responses
* You want to discuss flows not documented in this guide
Real sample transactions speed up every one of these conversations.
# Wallet Setup
Get your web3 wallet ready
## Choose a wallet
If you haven't configured or download Metamask, you can download it from here:[ https://metamask.io/](https://metamask.io/)
## 🦊 MetaMask Configuration
### Connecting with MetaMask
First, you will need to connect your MetaMask wallet to the Cronos network:
* Click the "**My Account**" button in the top right corner. Then select **"Networks"** in the settings menu.
* Click "**Add Network**":
* Mainnet Configuration
* **Name**: Cronos
* **New RPC URL:**[`https://cronos-evm-rpc.publicnode.com`](https://cronos-evm-rpc.publicnode.com)
* **Chain ID: 25**
* **Symbol:**`CRO`
* **Block explorer URL:** [**https://cronos-evm-rpc.publicnode.com**](https://cronos-evm-rpc.publicnode.com/)
After saving the network configuration, we should be able to see the token in your address.
Alternatively, you can refer to this guide to install and configure the Cronos Chain Defi Wallet
# NFT Lending & Borrowing
The platform enables NFT-backed lending through a collateralized, time-based borrowing model. Lenders create loan offers by selecting an NFT and setting required collateral at a minimum of **2× the NFT’s current floor price**, with the option to require higher collateral. Floor prices are sourced in real time from **CDC NFT, Ebisus, and Minted**.
Borrowers initiate a loan by selecting a lender offer and depositing the required **CRO collateral** into an escrow smart contract for a chosen duration (**1, 7, or 30 days**). Upon lender approval, the NFT is transferred to the borrower for the duration of the loan.
Protocol fees are charged on the collateral and split evenly between the lender and the platform. Fee rates are:
* **1 day:** 1%
* **7 days:** 3%
* **30 days:** 5%
Borrowers may return the NFT at any time before expiry to reclaim their collateral (minus fees). After the loan term expires, the lender may claim the collateral (less platform fees) if the NFT is not returned. Borrowers retain the option to return the NFT late **until the lender claims the collateral**.
# TOOLS
# CROmmunities
# Volume MM
# AirDrop Tool
# Token Locker
# Token & NFT Staking
# Trading Contests
# OTC Market
# ROBIN NFTs
# ROBIN Contracts
| Name | Contract Address |
| -------------------- | ------------------------------------------ |
| ROBIN NFT Collection | 0x1dBA58B1bdcaA3B0488065cCEFa057c52a963280 |
# ROBIN NFT
| Name | Contract Address |
| ---------------- | ------------------------------------------ |
| $OBS Token | 0x0AEBa21655185583367f19D0C882dfc654C6Dd54 |
| Diamond Hands v1 | 0x1215B773d67fd9ed17656B08e223caEF4a93904f |
# Weekly Trading Battle
The more you trade, the more you win!
Welcome to the **Obsidian Trading Battle!** An exciting competition where projects and traders come together to compete for top spots and exclusive rewards. This competition celebrates the community’s most active projects by ranking tokens based on buy volume, with thrilling rewards for the weekly winners.
### How It Works
1. **Leaderboard**: Each week, tokens listed on Obsidian compete for the top spot on our **Trading Battle Leaderboard**. Rankings are based solely on **buy volume**, so every buy trade counts toward your favorite project’s success.
* View the live leaderboard: [Obsidian Trading Battle Leaderboard](https://obsidian.finance/battle)
2. **Eligible Tokens**:
* All tokens listed on Obsidian are automatically eligible to participate. No subscription or special signup is required. [Listing form](https://obsidian.finance/listing).
3. **Supported Network**:
* Currently, the competition is available only on the **Cronos Chain EVM (25)**.
### Rewards
Each week’s **top traded token by buy volume** will earn exclusive rewards, adding value for both the project and its supporters.
**Weekly Rewards for the Top Token**
* **Staking Pool Fees**: The winning token’s **buy volume** generates aggregator fees throughout the competition period. All fees collected from **buy trades** are returned to the winning project’s staking pool as a reward for its supporters. *Fees from sales do not count toward the staking pool rewards at this time; instead, they are allocated to other activities, including incentives for the Global Leaderboard.*
* **Promotional Banner**: In addition to the staking pool reward, the winning token will receive a **prominent promotional banner** on our Trading Battle page, boosting visibility for the project in the following week.
#### Strategy
To support your favorite token in the Trading Battle, increase buy volume through regular trading. Remember, only buy trades count toward the leaderboard rank, so every buy strengthens your token’s standing. **The more you trade, the higher the chance for your project to claim the top spot and enjoy exclusive rewards!**
#### Global Leaderboard and Contests
In addition to the **Trading Battle**, Obsidian features a **Global Leaderboard** that ranks individual traders based on their total trade volume, counting both buys and sells. This leaderboard provides even more ways to win and showcase your trading activity.
* **Single Wallet Leaderboard**: Track your personal progress on the Global Leaderboard as you trade. By supporting your favorite token through active trading (buys and sells), you not only contribute to its success in the Trading Battle but also advance in the **Single Wallet Leaderboard**. Climbing the ranks gives you access to special incentives and rewards as a top trader!
* **Special Boosts and Contests**: Participate in exciting contests and receive unique boosts, available only on the Global Leaderboard. With these additional incentives, you can maximize your trading impact and stand out as a leading trader.
Check out the **Global Obsidian Trading Leaderboard** here: [Obsidian Global Leaderboard](https://obsidian.finance/leaderboard) to track your wallet's rank and view available contests.
All projects are welcome to participate. **Let’s battle it out!** 🏆
# Liquidity Pool Incentive Program
Obsidian's program rewards top ranking tokens by creating liquidity pools, collecting aggregator fees, and offering the option to add liquidity to their TOKEN/CRO pair.
Obsidian is not just a decentralized exchange (DEX) aggregator; it is a comprehensive decentralized exchange platform. In addition to providing users with the best trading rates across multiple liquidity sources, Obsidian is also committed to fostering growth in the decentralized finance (DeFi) ecosystem. We are focused on building our liquidity pool (LP) protocol, and we aim to support projects by offering them increased liquidity pools on our platform.
We are happy to introduce an exciting new incentive program designed to encourage tokens to increase their liquidity and visibility within the Obsidian ecosystem. This program rewards tokens with significant buy volume and top rankings on our leaderboard by offering them the opportunity to participate in our liquidity pool creation process.
***
#### **Incentive Program Details:**
To qualify for the program, tokens must meet two criteria:
1. **Top 10 Ranking:** Tokens that reach the top 10 on Obsidian’s weekly [battle leaderboard](https://wiki.obsidian.finance/contests/weekly-trading-battle) based on buy volume.
2. **Minimum Buy Volume:** Tokens must have a minimum buy volume of **$10,000** within a given week.
Once a token qualifies, they will be eligible for the following incentives:
**1️⃣ Liquidity Pool Creation**
Obsidian will create liquidity pools for qualifying tokens on our platform, increasing its accessibility and exposure. The liquidity pool creation process will help ensure there is sufficient liquidity for seamless token swaps and trading.
**2️⃣ Aggregator Fee Collection and Liquidity Zapping**
Obsidian’s aggregator fee is **0.5%** of the trading volume generated for each qualifying token. For example, if a token generates **$20,000** in buy volume, the fee collected will be **$100**.
These collected fees will then be used to add liquidity to the token's **TOKEN/CRO** pair on Obsidian, contributing to the liquidity pool of that pair. Additionally, the created liquidity will be **burned**, helping reduce the token's overall supply and increasing its scarcity.
**3️⃣ Staking Pool or Liquidity Pool Opt-In**
Currently, the top ranking token receives the collected aggregator fees in a **staking pool**. However, if the token chooses to opt into the LP (liquidity pool) program, the fees will instead be used to increase the liquidity of the token's **TOKEN/CRO** liquidity pool on Obsidian. This offers more flexibility for tokens to choose between staking rewards or liquidity growth.
***
#### **Program Duration and Review:**
This incentive program will be valid for the next 2 months (starting on Nov 10th, 2024) and is subject to review and possible extension based on the engagement and participation of the projects involved. Obsidian aims to continuously improve the program and provide valuable incentives to projects that engage with the platform and contribute to the liquidity of the ecosystem.
***
#### **Benefits for Tokens and Projects:**
1. **Increased Liquidity:** Tokens will benefit from increased liquidity on Obsidian, enabling smoother and faster trading for users.
2. **Exposure:** By qualifying for the top 10 on the leaderboard, tokens will receive more visibility within the DeFi ecosystem.
3. **Liquidity Pool Incentives:** The liquidity added to the **TOKEN/CRO** pair will help boost token value by improving its market depth.
4. **Staking or LP Growth Options:** Tokens can choose whether to receive rewards in the staking pool or opt into the LP program for liquidity growth.
5. **Reduced Supply:** The liquidity added to the pool will be burned, helping decrease the overall supply of the token and potentially increasing scarcity.
***
#### **How to Participate:**
1. **Monitor the Leaderboard:** Tokens must rank within the top 10 on Obsidian's leaderboard.
2. **Achieve Minimum Buy Volume:** Tokens must generate a minimum buy volume of **$10,000**.
3. **Opt-in to the LP Program:** Qualifying tokens can opt to participate in the LP program, directing their aggregator fees towards liquidity growth.
**Exclusions:** Tokens that are already paired with $ROBIN are excluded from this program, as liquidity is already being injected for those tokens.
***
#### **Conclusion:**
Obsidian’s new Liquidity Pool Incentive Program is designed to encourage projects to engage with the platform and increase liquidity, benefiting both the token holders and the broader DeFi ecosystem. This initiative highlights Obsidian’s commitment to becoming a full-featured decentralized exchange that not only aggregates liquidity but also builds and supports liquidity pools for token projects, driving value and adoption within the decentralized finance space.
# Obsidian Leaderboard
### Introduction to the Obsidian Leaderboard Points System
Every week, Obsidian distributes 50% of the platform trading fees to the top 50 traders based on their trading activity. This distribution is made in the form of OBS tokens. Whether you are an avid trader or a casual participant, the leaderboard gives you an exciting opportunity to earn more, especially when you hold a **ROBIN NFT**.
### Boost System for ROBIN NFT Holders
Owning an NFT provides you with a boost, adding a percentage to your points based on the rank of your NFT. Here’s how the boost system works:
* **Rank 1-5:** 100% Boost (2x points)
* **Rank 6-25:** 75% Boost
* **Rank 26-100:** 50% Boost
* **Rank 101-200:** 35% Boost
* **Rank 201-500:** 25% Boost
* **Rank 501-1000:** 15% Boost
* **Rank 1001-2500:** 10% Boost
Owning a **ROBIN NFT** can make a substantial difference in your leaderboard position. In competitive weeks, even a few extra points can place you in a higher reward bracket.
By incorporating the **ROBIN NFT** into your strategy, you not only enhance your earning potential but also become a valued member of the **Obsidian** community.
So, start trading, boost your points with a **ROBIN NFT**, and climb the ranks on the **Obsidian Leaderboard**!
### Reward Cycle
Each reward cycle lasts for 7 days. At the end of each cycle, the top 50 addresses with the highest trading volume (converted into leaderboard points) are eligible to receive a share of 50% of the fees collected by Obsidian that week. These rewards are paid out in OBS tokens.
### How Rewards Are Calculated
Each trader’s share of the weekly reward pool is proportional to their points compared to the total points earned by all 50 eligible traders.
For example, if 100 million OBS tokens are allocated for the week, then the reward for each user is calculated using the formula:
Your Reward = (Your Points / Total Points of Top 50) × 100,000,000 OBS
To illustrate how rewards are distributed, we will use an example where 100 million OBS tokens are allocated for a given week.
### Example Scenarios
#### Scenario 1: Close Points Between Top Users
If the first and second place traders have nearly equal points, they will receive almost the same rewards. Example:
\- Trader A has 10,000 points\
\- Trader B has 9,900 points\
\- Total points from all 50 traders = 50,000
Reward amounts:\
\- Trader A: (10,000 / 50,000) × 100M = 20,000,000 OBS\
\- Trader B: (9,900 / 50,000) × 100M = 19,800,000 OBS
#### Scenario 2: Top 5 Traders Dominate
If the top 5 traders accumulate most of the points, they will receive the bulk of the reward pool. Example:
\- Total points from all traders = 1,000,000\
\- Top 5 traders have a combined 900,000 points
Reward amounts:\
\- Trader 1 (300,000 points): 30,000,000 OBS\
\- Trader 2 (250,000 points): 25,000,000 OBS\
\- Remaining 45 traders share 10,000,000 OBS
### Claiming Your Rewards
Rewards must be claimed within 15 days after the cycle ends. If not claimed within this period, the rewards expire and cannot be claimed afterward.
### Final Notes
Obsidian’s leaderboard rewards ensure that active traders are fairly rewarded. Whether you're a top trader or rising through the ranks, your activity helps you earn a share of the platform fees distributed weekly.
# Collab Partner NFT Boosts
We’re bringing a whole new level of excitement to the **Obsidian Trading Leaderboard** with the introduction of **Collab Partner NFT Boosts**! This is your chance to gain even more points, amplify your rewards, and climb the ranks faster than ever before. To kick things off, we're teaming up with the **Cronos Cruisers NFTs** for the very first collaboration, giving holders a **25% boost** on points for every trade. But that’s not all, each new round or season will feature fresh collaborations with different NFT projects, offering you new opportunities to earn boosts and outshine the competition!
### How Collab Partner Boosts Work
The **Collab Partner NFT Boosts** are all about giving you extra power in the race to the top of the leaderboard. Here’s the scoop on how it works:
* **First Round Collaboration**: Holders of the **Cronos Cruisers NFTs** will get a **25% boost** on the points they earn from each trade throughout this round.
* **Boost Application**: This boost will be directly added to your points total for every trade you make. For instance, if you would earn 100 points from a trade, the boost would increase that to 125 points!
#### Rotating Collaborations
Each round or season will bring a **new Collab Partner NFT**, and the percentage of the boost may vary depending on the collaboration. The best part? You get to discover new and exciting NFTs to collect and earn boosts from, making every season feel like a fresh challenge.
* **New Partnerships Every Season**: The collaboration may feature different NFTs each round, with new perks, boosts, and surprises to keep things exciting!
### Example of Boosted Points
Let’s walk through an example to show just how powerful the **Cronos Cruisers NFT Boost** can be:
#### Step 1: Base Points Calculation
Imagine you’re trading **1,000 USD** worth of tokens. With a **POINTS\_RATIO** of 10 (meaning every 10 USD equals 1 point), you’d normally earn:
* **Base Points** = 1,000 USD / 10 = **100 points**
#### Step 2: Applying the 25% Boost
Now, if you hold a **Cronos Cruisers NFT**, you get that extra **25% boost** on your points. So, your points calculation would look like this:
* **Boosted Points** = 100 points × (1 + 0.25) = **125 points**
By holding the **Cronos Cruisers NFT**, you’re immediately earning 25 extra points, propelling you higher up the leaderboard.
#### Step 3: Climbing the Leaderboard
Every trade you make with a **boosted point total** gives you a greater chance of reaching those top prize spots. With more boosts, you rise faster and claim more rewards, whether you’re gunning for a **Gold** rank or just aiming for consistency among the **Teal** ranks.
### Why Collab Partner NFTs?
The **Collab Partner NFT Boosts** are designed to add a whole new layer of excitement and strategy to the **Obsidian Trading Leaderboard**. Here’s why you’ll want to get involved:
* **Boost Your Performance**: Holders of the featured NFT get an instant advantage with boosted points, giving you a leg up in the race for rewards.
* **Fresh Challenges with Every Season**: With new **Collab Partner NFTs** featured every round, there’s always something fresh to collect and trade for.
* **Join a Thriving Community**: These collaborations aren’t just about trading—they’re about being part of a vibrant community of NFT enthusiasts and traders.
### What’s Next?
The **Collab Partner NFT Boosts** are just the beginning! Here’s what you can look forward to in the upcoming seasons:
* **New NFT Partners**: Each season will feature a new **Collab Partner NFT** with a unique boost percentage. Whether it’s 15%, 30%, or more, each new partner brings a fresh way to enhance your leaderboard performance.
* **More Opportunities to Earn**: With every new partner, you’ll have even more chances to boost your points, climb the ranks, and grab your share of the rewards.
We’re constantly looking for new and exciting ways to improve the **Obsidian Trading Leaderboard**, and the **Collab Partner NFT Boosts** are just one of the ways we’re keeping things thrilling and dynamic.
### Conclusion
The **Collab Partner NFT Boosts** bring a new level of excitement and opportunity to the **Obsidian Trading Leaderboard**. In this first round, **Cronos Cruisers NFT holders** get a **25% boost**—but stay tuned, because every season will feature new collaborations with even more surprises. Whether you’re a seasoned trader or just getting started, these boosts are your ticket to climbing the leaderboard faster, earning bigger rewards, and becoming a true leader in the community.
Start collecting your **Cronos Cruisers NFTs** now and watch your points soar. The leaderboard is waiting for you! Get in the race and claim your rewards today!
# Obsidian Diamonds Program
We’re thrilled to unveil our new **Obsidian Diamonds Program**, where every trade counts toward exciting rewards! Say hello to a system designed to reward our loyal traders and make every transaction on Obsidian more thrilling.
#### How It Works
1. **Trade to Earn Diamonds**: For a minimum of **$10 USD** traded on Obsidian, users are eligible to claim a daily diamond. Your trading volume resets daily, so you can start fresh every day.
2. **Claim Daily**: Once you reach $10 in trading volume, you can claim your diamond. After claiming, you will need to wait until the next reset at **0:00 UTC** to start earning for the following day’s diamond. **Unclaimed diamonds do not accumulate**, so make sure to claim daily to avoid missing out.
3. **Reveal Mystery Prizes**: Collect **21 diamonds** to unlock a mystery prize. Each mystery prize is guaranteed to contain a reward, ranging from small to large amounts of **Cronos Chain tokens** or **exclusive NFTs**.
#### Mystery Prizes
* **Every prize wins**: All mystery prizes will have a reward , there are no empty boxes!
* **Reward Range**: Prizes will vary, with probabilities spanning from **0.001% to 70%** for different reward tiers.
* **Prize Pool**: A portion of the aggregator fees from Obsidian will be allocated to seed the prize pool, ensuring a fair and sustainable rewards system.
#### Track Your Progress
Stay updated on your progress directly within the Diamonds Program:
* **Daily Volume**: Displays your trading volume for the day.
* **Goal Tracker**: Indicates how much more you need to trade to claim a diamond.
* **Mystery Prize Progress**: Shows how many diamonds you’ve collected toward your next mystery prize.
For example:
* **Daily Volume**: `$0.00 / $10`
* **Trade more to unlock!**: `$10.00 volume needed`
* **Collect 21 diamonds to reveal a mystery prize!**
***
### Future Expansions
The **21 diamonds collection** is just the beginning, this marks the first phase of the Obsidian Diamonds Program. We are actively testing and refining the system, with plans to introduce additional features and challenges soon. Stay tuned for more ways to earn and engage as we expand the program!
***
### Start Collecting Diamonds Today
Ready to start collecting diamonds and unlocking rewards? Jump into Obsidian and make your trades count. Whether you’re trading for your portfolio or enjoying the best rates on Cronos Chain, you’ll be working toward exciting prizes with every transaction.
Let’s make trading more rewarding — one diamond at a time!\
\
\* Valid for Cronos EVM (25)
# Community Contests
### Overview
We’re excited to introduce **Trading Contests** to **Crommunities**, giving community managers a powerful way to **engage traders and reward participation**. With a brand-new UI and an innovative **Rolling Average Approach**, these contests encourage consistent trading activity while preventing last-minute manipulation.
### Key Features
#### ✅ **Easy Contest Creation**
* Community managers can **set start & end dates**, **define prizes**, and more.
* **Creating a contest is free**, and community managers are responsible for distributing rewards once the contest ends.
#### 📊 **Enhanced UI & Leaderboards**
* **Global & daily leaderboards** to track top traders.
* **Granular reporting tools** help managers monitor contest performance.
* **CSV export** available for contest reports.
#### 🎯 **Rolling Average Scoring System**
Unlike traditional ranking methods that only count total volume, our **Rolling Average Approach** ensures a **fair and balanced competition**:
**How It Works**
1. **Daily Points Calculation** – Each day, traders earn points based on their **buy/sell activity**.
2. **Average Calculation** – A trader’s total points are divided by the number of days in the contest.
3. **Ranking** – Traders are ranked based on their **daily average score**, not just total points.
4. **Zero-Activity Days Impact** – Days with no activity **count as zero points**, lowering the overall score.
**Benefits of Rolling Average Ranking**
* **Rewards Consistency** – Encourages traders to stay active throughout the contest.
* **More Fair Than Daily Caps** – No arbitrary limits; traders can have exceptional days while still needing steady participation.
* **Harder to Game** – Last-minute traders can’t suddenly overtake active participants.
* **Smooths Out Market Volatility** – Balances out fluctuations in trading activity.
#### 🚀 **Boosted Points for Buys**
* **Buys receive a 30% point boost**, making contests more engaging and incentivizing **long-term holding**.
### Example Contest
**ROBIN Trading Contest - Edition #1**
* 🗓 **Mar 8, 12:30 AM - Mar 15, 10:03 PM**
* 🏆 **Prizes:**
* 1st Place: **50,000 ROBIN**
* 2nd Place: **25,000 ROBIN**
* 🔥 **Leaderboard available in the new UI!**
### Get Started
Ready to launch your first contest? Head to **Obsidian Crommunities** and start rewarding your traders today!\
\
# Token Merge: Forging Obsidian
## What’s Happening to ROBIN and LION?
ROBIN and LION were originally envisioned as community or meme tokens, and they’ve played a valuable role in helping us grow and engage our ecosystem. However, Obsidian has evolved into a platform with real utility and long-term potential.
👉 **In short:** We’re merging tokens to make things simpler, stronger, and better for you, for us, and for the future of our community.
## A Stronger Future Together
As our community grows and our ecosystem evolves, it’s important that our foundations are built for long-term success. That’s why we’re taking a major step forward: merging our tokens into one unified asset. This isn’t just a technical move, it’s a strategic decision designed to strengthen our brand, streamline user experience, and unlock new opportunities for growth.
### 1. **Consistency & Simplicity for Everyone**
Managing multiple tokens can be confusing. Not only for new community members, but also for long-time holders. By unifying into one token, we remove unnecessary complexity. This gives our users and partners a single, clear point of reference for everything we’re building.
* One brand, one ticker, one ecosystem.
* Easier onboarding for new users.
* Simpler integrations with exchanges, wallets, and DeFi platforms.
### 2. **Stronger, More Recognizable Branding**
A fragmented token landscape dilutes recognition. By consolidating, we create a stronger and more consistent brand identity, something the entire community can rally behind. This not only builds trust but also ensures that when people talk about us, they’re talking about one powerful, unified asset.
* Greater visibility and credibility.
* A stronger presence across Crypto, DeFi, and Web3 spaces.
* Unified marketing and storytelling.
### 3. **Future Growth & Ecosystem Expansion**
This merge isn’t just about today, it’s about preparing for tomorrow. A single, unified token makes it easier to scale and expand into new markets, partnerships, and technologies. It allows us to stay nimble, seize new opportunities, and provide more value to our community.
* Improved liquidity and deeper market confidence.
* Easier listings and adoption across platforms.
* A foundation designed to grow with us.
### 4. **Built for the Community**
We know that any change to the token structure directly impacts you our holders and supporters. This merge is designed with your long-term benefit in mind. It’s about creating a sustainable ecosystem where your assets are easier to use, more recognizable, and better positioned for future value.
## What This Means for You
* If you’re already holding our tokens, you’ll be able to seamlessly migrate to the new unified token during the TGE.
* The new token will represent everything the old ones did, but with more strength and clarity.
* We’re giving you a stronger foundation to grow with us.
* During the TGE we are gathering all legacy tokens, giving you new one per the allocation, and we will be selling **ALL** of the legacy tokens we gather into the burnt LPs to gather as much CRO as we can to put into the new token.
* The only purpose for collecting legacy tokens is to sell into the burnt LPs helping deepen liquidity and create stronger trading pair's for $OBS
### The Road Ahead
This token merge is just the beginning of an exciting new chapter. With a unified asset, we’ll be able to focus on building innovative products, forming key partnerships, and expanding into new opportunities without the distraction of fragmentation.
Together, we’re creating not just a token, but a long-lasting brand and ecosystem.
# Full $OBS TGE Details
{% embed url="" %}
$ OBS CA:
Initial Announcement: October 3rd
Market Cap Snapshot: Randomly between October 6th-TGE Start
TGE Start: October 10th 2:00 PM Coordinated Universal Time (UTC)
TGE End: October 16th 2:00 PM Coordinated Universal Time (UTC)
$OBS Liquidity seeding & Go Live: October 17th 2:00 PM Coordinated Universal Time (UTC)
## TOKENOMICS
10B Total Supply:
* 10% (1B $OBS) will be held for development to facility future growth of bridging, new liquidity etc not meant to go into circulation unless it is to facilitate this type of activity. If we don’t need it, we will burn it at a later date
## TGE BREAKDOWN
* 70% (6.3B) Legacy Token Holders
* 15% (1.35B) New investors
* 10% (900M) Liquidity paired with 100% of CRO Raised
* 5% (450M) ROBIN Liquid NFTs with Puush (previously named retro 404s)
* Finalized MCAP Snapshot was taken 2:50pm US Central time
## Legacy Token Holders (6.3B $OBS)
**ELIGIBLE TOKENS:**
* $ROBIN
* $LION (Cronos)
* $LION (zkEVM)
**MARKET-CAP SNAPSHOT:**
On the snapshot date (randomly taken between October 6th-TGE Start), we will record the market capitalization of each legacy token. Each token’s share of the combined market cap determines its percentage of the 6.3 B OBS allocation.
Example: If ROBIN represents 65% of the combined market cap, it would receive roughly 4 B OBS from the 6.3 B pool.
**USER DEPOSITS:**
* Holders deposit their tokens during the TGE.
* Suppose 10 B ROBIN are deposited in total.
* The 4 B OBS allocated to the ROBIN pool will be divided pro-rata among all deposited ROBIN.
* The same calculation applies to both LION pools.
## Public TGE Sale (1.35B $OBS)
New investors can participate by depositing $CRO. The 1.35B $OBS allocated for the public sale will be split pro-rata according to the total $CRO contributed. No soft cap & no hard cap
This structure ensures:
* Fair distribution to legacy holders based on actual market value at the snapshot.
* A clear on-ramp for new participants to join the Obsidian ecosystem.
## Vesting Terms
CLAIMABILITY:
* At TGE completion, users will be able to **claim 15%** of their allocated OBS immediately.
* The remaining **85%** will be locked and released linearly over **90 days**.
* The locked portion will vest continuously and users will be able to claim vested tokens at any time (claimable per second). \*Vesting starts the unlock timer once the initial 15% is claimed
* This applies to OBS allocations from legacy token pools (ROBIN and both LION pools) as well as OBS received from the public CRO sale.
## Use Case - Worked Example
**\*The following is a hypothetical example and should not be used to calculate your allocation\***
**ASSUMPTIONS FOR THE EXAMPLE:**
* Allocation to ROBIN pool: 4B OBS
* Total ROBIN deposited by all participants: 10B ROBIN
* User A deposit: 100K ROBIN
**STEP-BY-STEP CALCULATION FOR USER A:**
* User A share of deposited ROBIN = User A deposit / Total ROBIN deposited = 100,000,000 / 10,000,000,000 = 1.000000%
* User A total OBS allocation from ROBIN pool = Allocation to ROBIN pool × User A share = 4,000,000,000 × 1.000000% = 40,000,000 OBS
* Immediately claimable (15%) = 15.00% of 40,000,000 = 6,000,000 OBS
* Locked (85%) = 85.00% of 40,000,000 = 34,000,000 OBS
* Vesting duration = 90 days (7776000 seconds)
* Vesting (release) rate = Locked amount / Vesting seconds = 34,000,000 / 7,776,000 ≈ 4.372428 OBS/second
**So, in this scenario (100 participants assumed across the example totals):**
* User A receives 6,000,000 OBS immediately at TGE completion.
* The remaining 34,000,000 OBS unlocks linearly over 90 days at approximately 4.372428 OBS/second.
## **TGE Related Contracts**
**TGE Contract** [**https://explorer.cronos.org/address/0xBC48798A865ADbd7cd1eb9E88Bf55BDa59965798#code**](https://explorer.cronos.org/address/0xBC48798A865ADbd7cd1eb9E88Bf55BDa59965798#code)
**TGE Lock Contract** [**https://explorer.cronos.org/address/0x0AEBa21655185583367f19D0C882dfc654C6Dd54#code**](https://explorer.cronos.org/address/0x0AEBa21655185583367f19D0C882dfc654C6Dd54#code)
**Treasury Wallet** [**https://explorer.cronos.org/address/0xA8dB8275e9d1F641701A0956A08Aed153F244b11#tokens**](https://explorer.cronos.org/address/0xA8dB8275e9d1F641701A0956A08Aed153F244b11#tokens)
# TGE FAQ
Frequently Asked Questions
**Q: What will happen with the previous legacy tokens?**
A: Support for all legacy tokens will end and collected tokens will be sold into burnt LP's to add new liquidity to $OBS token.
**Q: Where will Liquidity be seeded?**
A: Liquidity will be seeded on Obsidian DEX.
**Q: Will liquidity be burnt of locked?**
A: Liquidity will be locked initially and we may decide to fully burn at a later date
**Q: Will $ROBIN still be used for weekly Leaderboard rewards?**
A: The last time $ROBIN will be used for leaderboard rewards will be October 5th. For the week ending on October 12th wCRO will be used and then starting on October 19th on $OBS will be used.
.png?alt=media&token=7efd0bbe-025e-48fc-a385-3fbf37f02226)