REST API ডকুমেন্টেশন

Authentication

Bearer token অথবা X-API-Key header

Required

প্রতিটি রিকোয়েস্টে আপনার API Key পাঠান। Key কখনো URL query string-এ রাখবেন না।

Authorization: Bearer YOUR_API_KEY

X-API-Key: YOUR_API_KEY

Key কোথায় পাবেন? লগইন করে API Key পেজে আপনার সম্পূর্ণ Key দেখুন অথবা রোটেট করুন।

Base endpoint

GET + POST

JSON

GET https://www.apisell.svserver.top/api/v1/query.php

POST https://www.apisell.svserver.top/api/v1/query.php

সব সার্ভিসেই service প্যারামিটার আবশ্যক। বাকি প্যারামিটার সার্ভিস অনুযায়ী নির্ধারিত।

GET method

Query string দিয়ে ইনপুট দিন

GET

curl -X GET "https://www.apisell.svserver.top/api/v1/query.php?service=currency-rates&base=USD" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"

GET রিকোয়েস্টে সব প্যারামিটার URL-encoded query string হিসেবে যাবে।

POST method

JSON অথবা form body

POST

curl -X POST "https://www.apisell.svserver.top/api/v1/query.php" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "service": "currency-rates", "base": "USD" }'

Content-Type application/x-www-form-urlencoded দিলে সাধারণ form field হিসেবেও POST করা যাবে।

Success response

Canonical envelope

200

{
    "code": 200,
    "success": true,
    "data": {
        "owner": "CRD-GR",
        "result": "success",
        "base": "USD",
        "rates": {
            "USD": 1,
            "BDT": 121.5
        },
        "notice": ""
    }
}

code — সফল কলে 200।
success — সফল কলে true।
data.owner — সবসময় CRD-GR।
সার্ভিসে কনফিগার করা প্রতিটি field সবসময় present থাকে। Upstream value না থাকলে empty string বা কনফিগার করা default দেখানো হয়।

Error response

HTTP status + machine-readable body

4xx / 5xx

{
    "code": 422,
    "success": false,
    "data": null,
    "message": "Base currency আবশ্যক।",
    "requestId": "CRD-261029-ABCDEF1234"
}

HTTP	অর্থ
400	INVALID_JSONPOST body valid JSON নয়।
401	UNAUTHORIZEDAPI Key নেই অথবা সঠিক নয়।
402	INSUFFICIENT_BALANCEব্যালেন্স অপর্যাপ্ত; upstream কল হয় না।
404	SERVICE_NOT_FOUNDservice slug পাওয়া যায়নি।
405	METHOD_NOT_ALLOWEDGET বা POST ছাড়া অন্য মেথড।
409	SERVICE_INACTIVEAPI সার্ভিস বন্ধ আছে।
422	VALIDATION_ERRORইনপুট প্যারামিটার সঠিক নয়।
429	RATE_LIMITEDপ্রতি মিনিটের রিকোয়েস্ট সীমা শেষ।
502	UPSTREAM_ERRORUpstream API ব্যর্থ বা invalid response।
504	UPSTREAM_TIMEOUTUpstream API সময়মতো উত্তর দেয়নি।

Billing rules

শুধু সফল upstream response-এ চার্জ

Prepaid

সফল 200 responseসার্ভিসের প্রাইস কাটা হবে

Validation / auth / balance errorচার্জ নেই

Upstream timeout / 5xx / invalid JSONচার্জ নেই

Request headersX-Request-Id, X-Charged, X-Balance

Rate limit30 / মিনিট / অ্যাকাউন্ট

Quick start

তিন ধাপে প্রথম কল

১

রেজিস্টার করে API Key পেজ থেকে Bearer Key নিন।

২

নিচের সার্ভিস তালিকা থেকে service slug এবং ইনপুট field দেখুন।

৩

GET বা POST দিয়ে কল করুন। সফল হলে ব্যালেন্স থেকে ফি কাটবে।

Live services

3টি সক্রিয় API

Currency Exchange Rates৳5.00 / সফল কল Crypto Asset Prices৳3.00 / সফল কল Bangladesh Postal Code Lookup৳2.00 / সফল কল

Data policy

কী এই গেটওয়েতে চলে

এই গেটওয়ে lawful, non-sensitive JSON API-এর জন্য তৈরি। NID, জন্মতারিখ, পাসপোর্ট, ভোটার তথ্য, ছবি, স্বাক্ষর বা অনুরূপ সংবেদনশীল পরিচয় ডেটা কনফিগার বা প্রসেস করার জন্য নয়।

SERVICE CATALOGUE

সার্ভিসভিত্তিক ইন্টিগ্রেশন

প্রতিটি সার্ভিসের request fields, response mapping এবং GET/POST উদাহরণ।

Currency Exchange Rates

currency-rates · ৳5.00 / সফল কল

লাইভ

Live foreign-exchange reference rates for 160+ currencies. Send an ISO 4217 base currency such as USD, EUR or BDT.

Request fields

Field	Type	Required	Rule
baseBase currency	text	হ্যাঁ	ISO 4217 currency code, e.g. USD, EUR, BDT.

Response fields

Output	Upstream path	Missing default
owner	স্বয়ংক্রিয়	`"CRD-GR"`
result	result	`""`
base	base_code	`""`
rates	rates	`""`
updatedAt	time_last_update_utc	`""`
nextUpdateAt	time_next_update_utc	`""`
notice	provider_notice	`""`

GEThttps://www.apisell.svserver.top/api/v1/query.php?service=currency-rates&base=USD

curl -X GET "https://www.apisell.svserver.top/api/v1/query.php?service=currency-rates&base=USD" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"

POSThttps://www.apisell.svserver.top/api/v1/query.php

curl -X POST "https://www.apisell.svserver.top/api/v1/query.php" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "service": "currency-rates", "base": "USD" }'

Sample success response

{
    "code": 200,
    "success": true,
    "data": {
        "owner": "CRD-GR",
        "result": "success",
        "base": "USD",
        "rates": {
            "USD": 1,
            "BDT": 121.5,
            "EUR": 0.92
        },
        "updatedAt": "Thu, 29 Oct 2026 00:02:31 +0000",
        "nextUpdateAt": "Fri, 30 Oct 2026 00:02:31 +0000",
        "notice": ""
    }
}

Crypto Asset Prices

crypto-prices · ৳3.00 / সফল কল

লাইভ

Current spot prices for a crypto asset in your chosen fiat or crypto quote currency. Data is supplied by CoinGecko.

Request fields

Field	Type	Required	Rule
coinCoin ID	text	হ্যাঁ	CoinGecko asset ID, e.g. bitcoin or ethereum.
currencyQuote currency	text	হ্যাঁ	Lower-case quote currency, e.g. usd, eur or bdt.

Response fields

Output	Upstream path	Missing default
owner	স্বয়ংক্রিয়	`"CRD-GR"`
coin	value: {coin}	`""`
currency	value: {currency}	`""`
price	{currency}	`""`
updatedAt	last_updated_at	`""`
notice	provider_notice	`""`

GEThttps://www.apisell.svserver.top/api/v1/query.php?service=crypto-prices&coin=bitcoin&currency=usd

curl -X GET "https://www.apisell.svserver.top/api/v1/query.php?service=crypto-prices&coin=bitcoin&currency=usd" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"

POSThttps://www.apisell.svserver.top/api/v1/query.php

curl -X POST "https://www.apisell.svserver.top/api/v1/query.php" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "service": "crypto-prices", "coin": "bitcoin", "currency": "usd" }'

Sample success response

{
    "code": 200,
    "success": true,
    "data": {
        "owner": "CRD-GR",
        "coin": "bitcoin",
        "currency": "usd",
        "price": 79998,
        "updatedAt": 1793279673,
        "notice": ""
    }
}

Bangladesh Postal Code Lookup

bd-postcode · ৳2.00 / সফল কল

লাইভ

Look up Bangladesh postal codes and the matching post office, district and division from a public directory.

Request fields

Field	Type	Required	Rule
postcodePostal code	text	হ্যাঁ	Four-digit Bangladesh postal code.

Response fields

Output	Upstream path	Missing default
owner	স্বয়ংক্রিয়	`"CRD-GR"`
country	country	`""`
countryCode	country abbreviation	`""`
postCode	post code	`""`
placeName	places.0.place name	`""`
state	places.0.state	`""`
stateCode	places.0.state abbreviation	`""`
latitude	places.0.latitude	`""`
longitude	places.0.longitude	`""`
notice	provider_notice	`""`

GEThttps://www.apisell.svserver.top/api/v1/query.php?service=bd-postcode&postcode=1000

curl -X GET "https://www.apisell.svserver.top/api/v1/query.php?service=bd-postcode&postcode=1000" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"

POSThttps://www.apisell.svserver.top/api/v1/query.php

curl -X POST "https://www.apisell.svserver.top/api/v1/query.php" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "service": "bd-postcode", "postcode": "1000" }'

Sample success response

{
    "code": 200,
    "success": true,
    "data": {
        "owner": "CRD-GR",
        "country": "Bangladesh",
        "countryCode": "BD",
        "postCode": "1000",
        "placeName": "Dhaka GPO",
        "state": "Dhaka",
        "stateCode": "",
        "latitude": "",
        "longitude": "",
        "notice": ""
    }
}

প্রোডাকশন-স্টাইল API ইন্টিগ্রেশন

Authentication

Base endpoint

GET method

POST method

Success response

Error response

Billing rules

Quick start

Live services

Data policy

সার্ভিসভিত্তিক ইন্টিগ্রেশন

Currency Exchange Rates

Request fields

Response fields

Sample success response

Crypto Asset Prices

Request fields

Response fields

Sample success response

Bangladesh Postal Code Lookup

Request fields

Response fields

Sample success response