Geoblocking

The Yield.xyz API enables you to stay at the forefront of innovation while maintaining full compliance with global regulatory standards. The regulatory landscape for cryptocurrency is rapidly evolving, and our built-in geoblocking system ensures your integration remains compliant — without requiring you to maintain country-by-country enforcement logic.

Geoblocking allows you to selectively restrict access to yield-related functionality based on a user’s location — at the country or region level — using a flexible, configuration-based system.

How It Works

Geoblocking is enforced at the action level — including all enter, exit, and manage flows. If a user is in a blocked region, the API will return a 403 Forbidden error and prevent the transaction from being created.

All geoblocking checks are performed at the project level, allowing you to define your own compliance posture.

Configuration Options

You can manage your geoblocking settings directly in the StakeKit Dashboard. As a project owner, you can:

• Enable Auto Compliance Mode to block all regions that fall under global compliance risk lists (OFAC, OFSI, crypto bans, staking bans, and more)
• Manually configure additional country or region-level restrictions
• Allow or override specific locations to match your legal position or risk tolerance

By default, only OFAC-level restrictions are applied unless you opt into broader enforcement.

Region Categories

Yield.xyz maintains an up-to-date global region list across several categories:

Official Crypto Bans

Some countries have explicit bans on cryptocurrency trading, staking, or DeFi use. You can block access from these regions to align with local regulations.

OFAC Sanctions

The U.S. Treasury’s Office of Foreign Assets Control (OFAC) publishes a list of sanctioned countries. Enforcing OFAC bans ensures your product avoids prohibited jurisdictions under U.S. policy.

OFSI Sanctions

The U.K.'s Office of Financial Sanctions Implementation (OFSI) also maintains a sanctions regime. You can block OFSI-restricted countries with a single toggle.

Pending Litigation (Optional)

In response to increasing U.S. scrutiny around staking, Yield.xyz also allows you to restrict access from states with active legal cases — such as California, New Jersey, and South Carolina — following patterns adopted by platforms like Coinbase.

Error Response

If a request is blocked due to geoblocking, the API returns:

{
  "message": "Access denied from US (US-CA)",
  "error": "Forbidden",
  "statusCode": 403
}

This response is consistent across all endpoints and includes the detected region, making it easy to handle programmatically or inform the user.