/providers - Providers, status, and identifiers mapping

The /providers endpoints describe which swap providers SwapKit has integrated, the chains they support, and their current operational status. All endpoints are GET and require your API key in the x-api-key header. Chains are reported as chain IDs throughout. See the table at the bottom for reference.

Endpoint	Purpose
/providers	Full list of providers with token-list metadata, supported chains, and the chains currently enabled for you
/providers/status	Per-provider swap status: supported chains, the SwapKit-level enabled/disabled split, and your API key's own settings
/providers/identifiers-mapping	Mapping between SwapKit asset identifiers and a provider's native identifiers

The set of providers is dynamic — don't hard-code it. Streaming providers with the _STREAMING suffix split a swap into sub-swaps over time. They are slower to execute, but often price better on larger trades where slippage matters. Non-streaming THORCHAIN and MAYACHAIN are not listed. They are superseded by THORCHAIN_STREAMING and MAYACHAIN_STREAMING, which are what SwapKit routes through.

---

GET /providers

Returns every provider integrated by SwapKit, with token-list metadata and chain support. Takes no query parameters, but note that enabledChainIds is evaluated against your API key — your key's own settings are applied.

curl -X 'GET' \
  'https://api.swapkit.dev/providers' \
  -H 'accept: application/json' \
  -H 'x-api-key: YOUR_API_KEY'

Response fields

Each object in the returned array contains:

Field	Description
name / provider	Provider identifier used to reference it in SwapKit
displayName / displayNameLong	Human-readable names such as "Chainflip" or "Chainflip Streaming"
keywords	Search keywords for the provider
count	Number of supported tokens
logoURI	URL to the provider's logo
url	URL to the provider's token list
supportedActions	Actions the provider supports. Currently ["swap"]
supportedChainIds	Every chain the provider can support — its full capability, regardless of current status
enabledChainIds	Subset of supportedChainIds currently usable for your API key. Empty if the provider is paused. Otherwise excludes chains disabled at the SwapKit level or by your key's own settings

supportedChainIds is what a provider can do. enabledChainIds is what it can do right now, for you. When a provider is paused, it still appears with its full supportedChainIds, but with an empty enabledChainIds.

Example — a fully enabled provider

{
  "name": "ONEINCH",
  "provider": "ONEINCH",
  "displayName": "1inch",
  "displayNameLong": "1inch V6",
  "keywords": ["oneinch", "1inch", "1inch.exchange"],
  "count": 1351,
  "logoURI": "https://storage.googleapis.com/token-list-swapkit/images/eth.1inch-0x111111111117dc0aa78b770fa6a738034120c302.png",
  "url": "https://storage.googleapis.com/token-list-swapkit/oneinch.json",
  "supportedActions": ["swap"],
  "supportedChainIds": ["42161", "43114", "8453", "56", "1"],
  "enabledChainIds": ["42161", "43114", "8453", "56", "1"]
}

Example — a paused provider

{
  "name": "THORCHAIN_STREAMING",
  "provider": "THORCHAIN_STREAMING",
  "displayName": "THORChain",
  "displayNameLong": "THORChain Streaming",
  "count": 40,
  "url": "https://storage.googleapis.com/token-list-swapkit/thorchain_streaming.json",
  "supportedActions": ["swap"],
  "supportedChainIds": ["litecoin", "thorchain-1", "1", "728126428", "43114", "8453", "bitcoincash", "56", "bitcoin", "dogecoin", "cosmoshub-4", "ripple", "solana"],
  "enabledChainIds": []
}

---

GET /providers/status

Returns an API-key-aware swap-status overview. Use this to understand why a provider or chain is or isn't available to you. Only the swap action is reflected.

curl -X 'GET' \
  'https://api.swapkit.dev/providers/status' \
  -H 'accept: application/json' \
  -H 'x-api-key: YOUR_API_KEY'

The response is a single providersChains array, one entry per provider:

Field	Description
name	Provider
supportedChainsGlobal	Every chain the provider has a swap entry for — its full capability
enabledChainsGlobal	Chains currently usable at the SwapKit level
disabledChainsGlobal	Chains not usable at the SwapKit level — either the chain's swap status is disabled, or the provider is globally paused, in which case all supported chains appear here
enabledChainsApiKey	Chains your API key has explicitly enabled
disabledChainsApiKey	Chains your API key has explicitly disabled

For every provider, enabledChainsGlobal and disabledChainsGlobal together partition supportedChainsGlobal. The ...ApiKey lists contain only chains your key has an explicit setting for. Each is a subset of supportedChainsGlobal.

The ...ApiKey lists were historically called "overrides." They no longer override the SwapKit-level status. They are simply your key's own setting for a given provider-chain, reported alongside the global status so you can see both.

{
  "providersChains": [
    {
      "name": "MAYAN",
      "supportedChainsGlobal": ["1", "10", "137", "143", "42161", "43114", "56", "8453", "solana", "sui"],
      "enabledChainsGlobal": ["1", "10", "137", "143", "42161", "43114", "56", "8453", "solana"],
      "disabledChainsGlobal": ["sui"],
      "enabledChainsApiKey": ["1", "10", "42161", "43114", "56", "8453", "solana", "sui"],
      "disabledChainsApiKey": ["137", "143"]
    },
    {
      "name": "THORCHAIN_STREAMING",
      "supportedChainsGlobal": ["1", "43114", "56", "728126428", "8453", "bitcoin", "bitcoincash", "cosmoshub-4", "dogecoin", "litecoin", "ripple", "solana", "thorchain-1"],
      "enabledChainsGlobal": [],
      "disabledChainsGlobal": ["1", "43114", "56", "728126428", "8453", "bitcoin", "bitcoincash", "cosmoshub-4", "dogecoin", "litecoin", "ripple", "solana", "thorchain-1"],
      "enabledChainsApiKey": ["1", "43114", "56", "728126428", "8453", "bitcoin", "bitcoincash", "cosmoshub-4", "dogecoin", "litecoin", "ripple", "thorchain-1"],
      "disabledChainsApiKey": ["solana"]
    }
  ]
}

MAYAN shows all the moving parts at once: a chain disabled at the SwapKit level (sui), and an API key that independently re-enables sui while disabling 137 and 143.

THORCHAIN_STREAMING shows the global pause forcing every chain into disabledChainsGlobal.

---

GET /providers/identifiers-mapping

Returns the mapping between SwapKit asset identifiers and a provider's native asset identifiers. The optional provider query parameter narrows the result to one provider.

curl -X 'GET' \
  'https://api.swapkit.dev/providers/identifiers-mapping?provider=CHAINFLIP' \
  -H 'accept: application/json' \
  -H 'x-api-key: YOUR_API_KEY'

Parameter	In	Required	Description
provider	query	No	Restrict the mapping to a single provider

---

Chain IDs and corresponding names

All Providers endpoints report chains using these IDs. They are standard across the crypto ecosystem:

Chain ID	Chain name
1	Ethereum Mainnet
42161	Arbitrum One
43114	Avalanche C-Chain
8453	Base
56	Binance Smart Chain (BSC)
137	Polygon
10	Optimism
100	Gnosis
80094	BeraChain
143	Monad
196	X-Layer - OKB
728126428	Tron - TRX
36900	Adi
0x534e5f4d41494e	Starknet
cardano	Cardano
ton	TON
solana	Solana
bitcoin	Bitcoin
bitcoincash	Bitcoin Cash
litecoin	Litecoin
ripple	XRP - Ripple
cosmoshub-4	Cosmos Hub
near	Near Chain
dash	Dash
zcash	ZCash
sui	Sui
dogecoin	Dogecoin
kaiyo-1	Kujira
mayachain-mainnet-v1	MayaChain
thorchain-1	THORChain
hype	Hype