Carbon

Documentation

Welcome to Carbon's docs!

Get Started    

Location Support (Blocked Countries)

Overview

Access list of countries by ISO 3166-1 alpha-2 codes (for example 'IR' for Iran) we geoblock. If a country is not explicitly geoblocked, you can assume we support it. By geoblock we mean we must block user IP addresses for our fiat > crypto, crypto <> crypto, and crypto > fiat services. If you're integrating via API, you must block those IP addresses on your end. If you're integrating via the widget, geoblocking is built-in.

Country
Currency
Symbol Name (ISO2)

China

CNY (¥)

CN

Russia

RUB (₽)

RU

Vietnam

VND (₫)

VN

Bolivia

BOB ($b)

BO

Colombia

COP ($)

CO

Ecuador

USD ($)

EC

Algeria

DA (د.ج)

DZ

Bangladesh

BDT (৳)

BD

Indonesia

IDR (Rp)

ID

Jordan

JOD (ينار)

JO

Kyrgyzstan

KGS (лв)

KG

Morocco

MAD (.د.م)

MA

Nepal

NPR (₨)

NP

Saudi Arabia

SAR (﷼)

SA

Iran

IRR (﷼)

IR

Pakistan

PKR (₨)

PK

Taiwan

TWD (NT$)

TW

Cambodia

KHR (៛)

KH

Cuba

CUP (₱)

CU

North Korea

KPW (₩)

KP

United States (coming soon)

USD ($)

US

1. Blocked Countries (GET)

No Super JWT Required

let url = `${ROOT}/v1/admin/blockedCountries`;

axios.get(url)
  .then(result => console.log(result))
  .catch(err => console.log(err));
{ message: 'Successfully retrieved blocked countries',
  code: 200,
  data: 
   [ 'KP',
     'IR',
     'CU',
     'US',
     'CN',
     'TW',
     'KG',
     'RU',
     'ID',
     'VN',
     'KH',
     'PK',
     'BD',
     'NP',
     'CO',
     'EC',
     'BO',
     'SA',
     'JO',
     'MA',
     'DZ' ] 
}

API Integration User Geoblocking

By using Carbon Fiber's API, you must agree not to conduct business in aforementioned blocked countries due to uncertain regulatory climate or OFAC considerations.

Carbon will be monitoring IP address location and proxy IP address to ensure compliance. Violation of service will result in termination of API and possible legal action. Note that this applies to superuser requests from your server via an API integration. For user requests through the widget we apply geoblocking automatically for all widget requests to our API for any route involving buying/selling/exchanging crypto.

Note you must pass in your user's ip address via a 'userip' request header. If the user's ip address originates from a country we geoblock, our API will return a 403 and the user will not be allowed to buy, sell, or exchange crypto.
You can also block your user's IP address by their geolocation and our blocked country list above if you would like.
If your server is based in one of the countries we geoblock, please reach out to daniel at carbon.money and joel at carbon.money to whitelist.

Location Support (Blocked Countries)


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.