Skip to main content
GET
/
v1
/
tools
List bridges and DEX aggregators
curl --request GET \
  --url https://api.hypermid.io/v1/tools \
  --header 'X-API-Key: <api-key>'
{
  "data": {
    "tools": [
      {
        "key": "stargate",
        "name": "Stargate",
        "type": "bridge",
        "supportedChains": [1, 42161, 137, 10, 8453, 43114, 56]
      },
      {
        "key": "hop",
        "name": "Hop Protocol",
        "type": "bridge",
        "supportedChains": [1, 42161, 137, 10]
      },
      {
        "key": "across",
        "name": "Across Protocol",
        "type": "bridge",
        "supportedChains": [1, 42161, 137, 10, 8453]
      },
      {
        "key": "1inch",
        "name": "1inch",
        "type": "dex",
        "supportedChains": [1, 42161, 137, 10, 56, 43114]
      },
      {
        "key": "near-intents",
        "name": "Near Intents",
        "type": "intents",
        "supportedChains": [900000001, 900000002, 900000003, 900000004]
      }
    ]
  },
  "error": null,
  "meta": {
    "requestId": "d4e5f6a7-b8c9-0123-def0-234567890123",
    "timestamp": 1711234570,
    "rateLimit": {
      "limit": 2000,
      "remaining": 1996,
      "reset": 1711234627
    }
  }
}
Returns the list of available bridge and DEX aggregator tools that Hypermid can use for swaps. 
{
  "data": {
    "tools": [
      {
        "key": "stargate",
        "name": "Stargate",
        "type": "bridge",
        "supportedChains": [1, 42161, 137, 10, 8453, 43114, 56]
      },
      {
        "key": "hop",
        "name": "Hop Protocol",
        "type": "bridge",
        "supportedChains": [1, 42161, 137, 10]
      },
      {
        "key": "across",
        "name": "Across Protocol",
        "type": "bridge",
        "supportedChains": [1, 42161, 137, 10, 8453]
      },
      {
        "key": "1inch",
        "name": "1inch",
        "type": "dex",
        "supportedChains": [1, 42161, 137, 10, 56, 43114]
      },
      {
        "key": "near-intents",
        "name": "Near Intents",
        "type": "intents",
        "supportedChains": [900000001, 900000002, 900000003, 900000004]
      }
    ]
  },
  "error": null,
  "meta": {
    "requestId": "d4e5f6a7-b8c9-0123-def0-234567890123",
    "timestamp": 1711234570,
    "rateLimit": {
      "limit": 2000,
      "remaining": 1996,
      "reset": 1711234627
    }
  }
}

const tools = await client.getTools();

const bridges = tools.data.tools.filter(t => t.type === "bridge");
console.log("Available bridges:", bridges.map(b => b.name).join(", "));

Authorizations

​
X-API-Key
string
header
required

Partner API key. Optional for public endpoints, required for /v1/partner/*.

Response

Tool list

​
data
any
required

Response payload (null on error)

​
error
object
required
​
meta
object
required