Skip to main content
POST
/
v1
/
trpc
/
system.ipDetection
tRPC System IP Detection API
curl --request POST \
  --url https://api.glider.fi/v1/trpc/system.ipDetection \
  --header 'X-API-KEY: <api-key>'
The manual IP detection procedure is available on the tRPC base endpoint:
  • Base endpoint: POST /v1/trpc
  • Procedure: system.ipDetection
  • Auth: public
  • Rate tier: Tier2

​
Response Notes

system.ipDetection performs an async country lookup for the request IP using country.is.
  • countryCode: manually detected ISO-2 country code
  • requestCountryCode: Cloudflare-derived request country code from the incoming request
  • provider: always country.is
  • ipDebug: raw IP-related request headers plus the derived client IP, country code, and region code used by the backend
  • status:
    • detected
    • missing_ip
    • lookup_failed
    • invalid_response
ipDebug is returned specifically for support and debugging so callers can compare the raw forwarded headers against the derived values the backend used.

​
Intended Usage

This procedure is designed to provide an additive country signal for restriction-aware routes.
  1. Call system.ipDetection
  2. Read countryCode
  3. Send it back to routes such as assets.searchForTokens as manualCountryCode
The backend evaluates both the Cloudflare request country and the manual country when both are present, and keeps the stricter restriction result.

​
Example Response Shape

{
  "countryCode": "RU",
  "requestCountryCode": "SE",
  "provider": "country.is",
  "status": "detected",
  "ipDebug": {
    "rawHeaders": {
      "cf-connecting-ip": "203.0.113.7",
      "x-forwarded-for": "203.0.113.7, 10.0.0.4",
      "x-real-ip": "203.0.113.7",
      "cf-ipcountry": "SE",
      "cf-region-code": "AB",
      "cf-ipcity": "Stockholm",
      "cf-ipcontinent": "EU",
      "cf-iplatitude": "59.3293",
      "cf-iplongitude": "18.0686",
      "cf-region": "Stockholm County",
      "cf-metro-code": null,
      "cf-postal-code": "11122",
      "cf-timezone": "Europe/Stockholm"
    },
    "derivedClientIp": "203.0.113.7",
    "derivedCountryCode": "SE",
    "derivedRegionCode": "AB"
  }
}