Skip to content

Connection security

Exchange API IP allowlists: which address belongs there?

Your laptop, the website and the exchange-request gateway can have different addresses. A migration worksheet makes the missing boundary visible.

Nested permission frames illustrate exchange API IP allowlist.
Illustration for connection security; examples in this article are educational.

An exchange API IP allowlist restricts the network addresses from which a credential can be used. For a hosted trading application, confirm the application's outbound exchange-request addresses rather than entering your laptop's IP. Keep required restrictions in place, test the intended account and environment, and resolve an address mismatch before enabling automation. An allowed address does not make every submitted trade safe.

The connection works at lunch and fails after a server migration. The secret has not changed. The permission screen looks identical. Someone suggests removing the IP restriction to get the bot running again.

That suggestion trades a visible connection problem for a less visible authorization problem. A better investigation begins with the route a request takes to the exchange. This guide builds that route, shows how to check a migration without publishing credentials, and explains what to ask when a hosted service does not provide an address list.

Whose address belongs on the list?

The relevant address is the source address the exchange sees when it receives an API request. A browser, an application server and an exchange can be three different systems. Clicking a trading control on your computer does not establish that your computer sends the signed exchange request.

In a hosted arrangement, a backend may submit requests through a network gateway. Its outbound address can differ from its website address, its incoming server address and the address displayed by a search for your own IP. A domain name resolving to a web server is therefore insufficient evidence for an API allowlist.

For KLINEO, use the official connection guidance and ask through the contact page if the required outbound addresses are unclear. No current KLINEO egress address list was verified for this article. Do not substitute a value from an exchange tutorial, a screenshot or the addresses used in this hypothetical example.

The permission requirements also depend on credential type. Binance's API-key setup documentation strongly recommends IP restrictions for permissions beyond reading and describes restrictions on unrestricted system-generated HMAC keys. The appropriate response is to establish a supported configuration, rather than weaken those controls to complete a connection. Binance API-key setup.

Draw the route before changing a security setting

A short route worksheet prevents a surprisingly common mistake: configuring the right address for the wrong program.

QuestionRecord without secretsWhy it matters
What submits the signed request?Hosted backend, local script or another documented componentDetermines which network path to investigate
Which exchange service receives it?Venue, product and production or test environmentA working connection to another service proves little
Which account is selected?A private inventory label for the intended accountAvoids testing a different account's credential
Who confirms the outbound addresses?Official service instruction and its dateSeparates current instructions from an old screenshot
What changes during failover?Whether another gateway or region sends requestsHelps explain intermittent rejection
How is the key restricted?Exact allowed entries and required permissionsProvides a comparison after the change

Keep actual account identifiers in your own protected inventory. A support conversation usually needs the venue, environment, approximate time and a redacted error. It does not need the API secret or an unredacted signed URL.

An allowlist also does not override exchange eligibility or regional restrictions. Network authorization, account eligibility and permission scope are separate checks. Ask the venue or service to resolve an unsupported setup; do not route requests around an access restriction.

A migration with two addresses and one missing step

Consider a fictional service moving its exchange-request gateway from address A to address B. These are labels, not real IP addresses. The operator has one credential restricted to A. There are no live KLINEO observations behind this example.

At 09:00, the service begins sending some requests through B. A balance check routed through A succeeds; an order query routed through B fails. The connection appears intermittent even though each network route behaves consistently.

The wrong diagnosis is “the exchange randomly rejects this key.” The more useful hypothesis is “the application has more than one outbound path, and one is not authorized.” That hypothesis can be tested by the service operator without revealing credentials to the reader.

A planned migration would establish the new supported address before the switch, preserve the restriction during any approved overlap, verify the new path, and retire the old entry when the change is complete. Whether overlapping entries are available and appropriate depends on the venue and service. Do not assume that every application supports a zero-downtime address transition.

The acceptance record for the fictional migration might read:

TimeObservationWhat it establishes
08:50Venue settings show approved A and BBoth entries are configured, subject to provider processing
09:05Authenticated read succeeds through BThat read worked on B with the tested credential
09:10Operator confirms no active work depends on AA retirement decision has an operational basis
09:20A is removed; subsequent B reads succeedThe remaining route works for the observed checks

The final row still does not establish that every order type, product or future failover will work. Verification should be specific enough that another person can see what was tested and what remains uncertain.

Start with the exact provider error and time. Similar-looking failures can result from a disabled key, a product permission, a clock problem, an account restriction or an IP mismatch. Do not repeatedly edit several settings until something happens to work; that destroys the comparison.

Bybit's API-key information endpoint documents bound IP addresses alongside permissions and account-related fields. That is useful evidence when a supported client or the provider's own tools expose it. It is not a reason to paste a credential into an unfamiliar diagnostic website. Bybit API-key information.

Use a narrow sequence:

  1. Confirm the selected account, environment and credential label in the application and exchange.
  2. Read the provider's current error definition. Save a redacted copy and timestamp.
  3. Compare the exchange's configured entries with the service's current official outbound-address instructions.
  4. Ask the service operator to verify the route actually used at that time, including any failover path.
  5. Repeat a supported authenticated read after the mismatch is resolved. Record its scope and observation time.
  6. Reconcile existing orders and positions before resuming automation if connectivity was interrupted.

Do not place an unnecessary live order merely to test an address. An authenticated read provides narrower evidence with less account impact. Read success does not establish trade permission, so any further readiness check should follow the product's documented process.

If a request may already have reached the exchange, changing an allowlist does not answer whether it traded. Use the order timeout reconciliation guide to recover the accepted order and fill state separately.

What does an IP allowlist fail to protect?

An allowlist restricts request origin. It cannot evaluate the strategy behind a valid request or distinguish a legitimate process from an attacker who controls an allowed system. A leaked credential combined with access to that system can still present a serious risk.

It also does not separate two applications using the same key on the same authorized server. Dedicated credentials improve identification and revocation, but the assets remain subject to the permissions and account structure at the exchange. Read the broader API permission boundary before treating a network setting as a capital limit.

Other controls still have their own jobs: keeping withdrawals and transfers disabled, narrowing trading permissions, protecting the secret, reviewing account access, and maintaining a provider revocation procedure. None removes execution or market risk. KLINEO's security policy describes the product's connection boundaries without promising that a restricted key cannot cause losses.

For a known credential exposure, adding an address restriction is not equivalent to retiring the exposed secret. Revoke the affected credential through the exchange's official controls and inspect account activity. A restriction added after exposure cannot prove the secret was never used.

The handoff that keeps a future change understandable

A connection should have an owner and a change record. The owner needs to know when an outbound address changes, which keys depend on it, who updates the venue setting and how to tell whether a failed verification belongs to the old or new route.

Keep this record short enough to maintain. Record the service, venue, environment, credential inventory label, source of address instructions, last verification time and intended review trigger. Useful triggers include a hosting migration, a new failover route, a provider security notice and unexplained authentication errors. A calendar reminder can help, but an outdated address list remains outdated even if someone checked a box last month.

If the service cannot confirm a supported restricted configuration, leave the connection inactive while resolving the requirement. Follow the Binance connection steps for that venue rather than extrapolating from another exchange's screen. A successful setup has a clear, current explanation for where requests originate and what authority they carry. It does not depend on an instruction to turn off a protection whenever an error appears.

Editorial method: Prepared with AI assistance from official exchange documentation and KLINEO's public connection policy on 20 October 2026. The gateway migration and worksheet are original hypothetical teaching examples. No production network address, customer account, live credential or independent security audit was examined.

Keep the context with the example.

Prepared with AI assistance by KLINEO Editorial. Each worked example is illustrative, with its sources and assumptions in the article. Read our editorial standards for authorship, verification and corrections.