Skip to main content

Get Your API Key

There are two ways to get started with the Fincept API:
Get a temporary 24-hour API key for testing.
POST /guest/register
{
  "device_fingerprint": "unique-device-id"
}
You’ll receive a temporary API key with prefix fk_guest_.

Make Your First Request

Once you have your API key, you can start making requests:
curl -X GET "https://finceptbackend.share.zrok.io/user/profile" \
  -H "X-API-Key: fk_user_your_api_key_here"

Response Format

All API responses follow a standard format:
Success Response
{
  "success": true,
  "message": "Profile retrieved successfully",
  "data": {
    "user_id": 1,
    "email": "john@example.com",
    "full_name": "John Doe",
    "credits": 100
  }
}
Error Response
{
  "success": false,
  "message": "Invalid API key",
  "error_code": "INVALID_API_KEY"
}

Try AI Chat

Use the chat endpoint to interact with GLM-powered AI:
# Create a chat session
POST /chat/create
X-API-Key: fk_user_your_api_key_here

# Send a message
POST /chat/send
{
  "session_id": "session-uuid",
  "message": "What's the current price of Apple stock?"
}
AI chat with MCP tools (stock data, news) is available only for registered users.

Next Steps