# MetaLayer API

MetaLayer API is a unified interface for accessing distributed liquidity across the entire DeFi ecosystem. Unlike standard bridges or aggregators, the MetaLayer acts as an orchestrator by combining liquidity from DEXs aggregators and bridging into a single intelligent routing layer.<br>

For fintech providers, this is the shortest path to integrating crypto functionality without the need to maintain dozens of separate protocols or spend resources on complex backend infrastructure.

### Overview

At the core of the MetaLayer is the principle of complexity abstraction. Instead of manually integrating 10 bridges, 20 DEX aggregators or multiple aggregators, you connect to a single API that builds optimal routes on top of existing protocols.

#### Key benefits for businesses:

* Unique routes: Access to multi-step exchange paths (e.g. swap on Chain A, then bridge, then swap on Chain B) that are not available via direct integrations
* Maximum liquidity: Automatic selection of the best price across all connected liquidity sources
* Flexible monetization: Tools for dynamic fee management and automated revenue distribution

### Monetization and partnership

The CrossCurve MetaLayer is designed around a partnership-driven model. Activation of commercial terms consists of two stages:

#### Agreement on revenue share terms

Before going live, you need to contact our partnership team at <a.gluhovskij@eywa.fi> or @Eywa\_COO. The manager will work out your specific revenue sharing terms with you and activate your API key for withdrawing accumulated fees.

#### Dynamic partner fees

You have full control over your margin. In each quote request, you can include the  partnerFeeBps parameter.

* Flexibility: Set different fees for different asset types or swap directions.
* Calculation: 1 basis point (bps) equals 0.01%. For example, a value of 50 bps corresponds to a 0.5% fee.
* Automation: The system automatically calculates the fee amount and includes it in the final quote for the user.

### Quick start

#### API key and fee address

You can test the API without a dedicated key. In this mode, you cannot set or receive additional fees.

Contact <a.gluhovskij@eywa.fi> or @Eywa\_COO to obtain an API key and register your EVM address. Your fees will be sent to this address.

### Action flow for executing a swap

**Step 1: Request routes**

Your application requests possible transfer routes from network A to network B.

**Step 2: Select route and build transaction**

API returns options with the estimated time, fees, and output amount. Your application selects the best one.

Then, build the transaction with the selected route.

**Step 3: Send transaction**&#x20;

User sends the signed transaction using ethers.js or any Web3 library.

**Step 4:  Track transaction status**

Your application may monitor the transaction status across chains via REST API or WebSocket Monitor.

**Step 5: Completion**

Transfer completes in the destination network. All confirmation and relay logic is handled by MetaLayer infrastructure.

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.crosscurve.fi/crosscurve-metalayer-1/what-is-crosscurve-metalayer/metalayer-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.