> For the complete documentation index, see [llms.txt](https://docs.swapkit.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.swapkit.dev/swapkit-api/providers-providers-status-and-identifiers-mapping.md). # /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 | {% hint style="info" %} 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. {% endhint %} *** ### 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. ```bash 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 | {% hint style="info" %} `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`. {% endhint %} #### Example — a fully enabled provider ```json { "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 ```json { "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. ```bash 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`. {% hint style="info" %} 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. {% endhint %} ```json { "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. ```bash 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 |