Skip to main content

Authentication

All API requests require an API key passed in the X-API-Key header.

curl -H "X-API-Key: your_api_key" https://api.ibnk.xyz/api/v1/pools

Request Headers

HeaderRequiredDescription
X-API-KeyYesYour API key for authentication
Content-TypeYes (POST)application/json

Obtaining an API Key

To request access to the iBnk Sandbox Environment (Testnet API), please contact: ying@ibnk.xyz

Application Information:

  • Your name/company name
  • Contact email
  • Use case description
  • Expected request volume

Testing API Connection

After obtaining your API Key, test the connection:

# Test connection (health check, no API Key required)
curl -X GET "https://api.ibnk.xyz/health"

# Test authentication (API Key required)
curl -X GET "https://api.ibnk.xyz/api/v1/pools?chainId=84532" \
-H "X-API-Key: your_api_key"

Expected Response:

{
"success": true,
"data": {
"pools": [...],
"pagination": {...}
}
}

Supported Networks

NetworkChain IDStatus
Base Sepolia84532Testnet
Arbitrum Sepolia421614Testnet

Rate Limits

LimitValue
Requests per 15 minutes100
Burst limit10 requests/second

Exceeding the limit will return a 429 Too Many Requests error.