Quick Start

Get up and running with the Minima API

API keys (optional)

API Keys are entirely optional, so why even use one for your integration?

1. 🔍 Tracking volume! API Keys are how we can track volume per integration, and provide you with details on volume that moves through your specific integration.

2. 💸 Set your own custom trade fee. This fee will be directed to your configured fee collector address

To get your API keys, head over to nodefinance.org and click "Start for free." Once you create your account, log-in, go to the "Mission Control" section and click "API Keys" to generate your keys.

Include API Keys

Include your API key in the header such as the following:

X-API-KEY = <API Key>

Good to know: API Keys are entirely optional, your integration will still work without them!

Make your first request

To make your first request, send an authenticated request to the pets endpoint. This will calculate a route.

Get a swap route from one token to another

GEThttps://router.nodefinance.org/routes

Path parameters

tokenIn*Address (string (20 byte EVM address))

Input token for swap

tokenOut*Address (string (20 byte EVM address))

Output token

amountIn*BigNumberString (string (Raw uint256 value))

Total amount of input token to be traded

fromAddress (string (20 byte EVM address))

Transaction originator. If present, will return a transaction ready to be signed

slippageinteger (BPS)

Allowed slippage, in bips. Can be congifigured at transaction, defaults to 10 BPS

toAddress (string (20 byte EVM address))

Recipient of trade. Defaults to from

deadlineMsUnixTime (integer (Unix Seconds))

Deadline for quote, defaults to 5 minutes

chainIdChainId (enum)

Chain to perform swap on, defaults to 42220 (CELO). More chains coming soon.

422204487

Response

200

Path found Successfully

Body

application/json

expectedOutBigNumberString (string (Raw uint256 value))

routerAddressAddress (string (20 byte EVM address))

detailsSwapPayload (object)

Request

JavaScriptCurlPython

const response = await fetch('https://router.nodefinance.org/routes', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "expectedOut": "text",
  "routerAddress": "text",
  "details": {
    "path": [
      "text"
    ],
    "pairs": [
      "text"
    ],
    "extras": [
      "text"
    ],
    "inputAmount": "text",
    "expectedOutputAmount": "text",
    "sig": "text"
  }
}

Good to know: If a route cannot be found between two tokens, you will receive an error message which designates that.

Take a look at how you might call this method:

curl

curl -X GET -G \
    "https://router.nodefinance.org/routes" \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -H "X-Api-Key": <API Key> \
    -d inputToken=0x471EcE3750Da237f93B8E339c536989b8978a438 \
    -d outputToken=0x73a210637f6F6B7005512677Ba6B3C96bb4AA44B \
    -d inputAmount=10000000000000000000000 \