Get Started

Use this page to start a Delora integration through the interface that fits your product: direct API calls, the React Widget, or the MCP server for AI tools.

1. Register in the Partner Portal

Create an account in the Delora Partner Portal before going live. In the portal, configure:

your EVM and Solana wallet addresses for fee collection
your custom integrator string, for example xyz
your API key for expanded rate limits

The Portal also lets you create and manage applications, monitor execution activity across networks, track accumulated fees, and claim earned funds.

Choose fee collection wallets carefully. Wallet addresses are immutable for collected fees, and earned fees are tied to the wallets configured for your integrator.

2. Choose an integration interface

API

Build your own routing and transaction flow with Delora API.

Widget

Embed a ready-made swap UI in your application.

MCP

Connect AI tools and agents to Delora routing through MCP.

API quick start

Use the REST API when you want full control over quoting, transaction construction, wallet UX, analytics, and backend behavior.

Read the quote API

Start with Get a quote for a token transfer to understand request parameters, quote responses, executable calldata, fees, gas, and warnings.

Build the transaction flow

Follow the chain-specific examples:

Send your API key from a server

Pass your API key as the x-api-key HTTP header for expanded rate limits. See Rate Limits and API Authentication.

Configure attribution and fees

Send your portal integrator string with quote requests. If you monetize transactions, also send the fee parameter. See Fee Configuration.

curl --location 'https://api.delora.build/v1/quotes?...&integrator=xyz&fee=0.01' \
  --header 'x-api-key: YOUR_API_KEY'

Use the Widget when you want to embed Delora trading flows with less custom UI work.

Install the package

Follow Install Widget to add @deloraprotocol/widget and render TradeWidget.

Configure the widget

Set your integrator string, optional fee, theme, filters, initial tokens, and wallet options through TradeWidget props. See Configure Widget.

Choose the wallet integration pattern

Use the widget’s built-in wallet UI or connect Delora to wallet state your app already owns. See Integration Patterns.

Monetize the widget

Forward your portal integrator string and fee through the widget config. See Monetize Widget.

import "@deloraprotocol/widget/styles.css";
import { TradeWidget } from "@deloraprotocol/widget";

export function App() {
  return (
    <TradeWidget
      theme="dark"
      config={{
        integrator: "xyz",
        fee: 0.01,
      }}
    />
  );
}

Do not expose your Delora API key in browser code. If a browser-based widget needs authenticated rate limits, keep the key on your backend and point config.apiUrl at your proxy.

MCP quick start

Use MCP when you want AI tools or agents to discover Delora chains, tokens, and quote tools through the Model Context Protocol instead of hand-written HTTP calls.

Connect the hosted server

Add the hosted MCP endpoint to your MCP-compatible client:

{
  "mcpServers": {
    "delora": {
      "type": "http",
      "url": "https://mcp.delora.build/mcp"
    }
  }
}

Add authentication when supported

If your MCP client supports custom HTTP headers, pass x-api-key: YOUR_API_KEY. For local stdio usage, set DELORA_API_KEY. See MCP Installation.

Use the routing tools

Start with get_chains, get_tokens or get_token, and get_quote. See Available Tools and MCP Examples.

Sign and submit externally

MCP quote responses include unsigned transaction data. Your application, wallet, or backend must still sign and broadcast transactions.

Next steps

For API integrations, start with Get a quote for a token transfer.
For Widget integrations, start with Install Widget.
For MCP integrations, start with MCP Server.
For revenue setup across all interfaces, review Fee Configuration.

ABOUT

PROTOCOL

INTEGRATIONS

EXAMPLES

LEARN MORE

1. Register in the Partner Portal

2. Choose an integration interface

API

Widget

MCP

API quick start

Widget quick start

MCP quick start

Next steps

​1. Register in the Partner Portal

​2. Choose an integration interface

API

Widget

MCP

​API quick start

​Widget quick start

​MCP quick start

​Next steps

1. Register in the Partner Portal

2. Choose an integration interface

API quick start

Widget quick start

MCP quick start

Next steps