Skip to main content
The Pulsedive API returns consistent, predictable responses to help you build reliable integrations.

Response Format

All API responses use JSON format for straightforward parsing and integration.

Successful Responses

Successful requests return predictable patterns with clear status indicators. When your request succeeds, you receive an HTTP 200 status code along with the requested data. Many successful responses also include a success parameter, though this parameter doesn’t appear across all endpoints.

Error Responses

When requests fail, the API provides clear error messages to help you troubleshoot and resolve issues. When something goes wrong, the API returns a JSON object with an error field explaining what happened. For example, a request with these parameters:
GET request to /api/indicator.php with parameters
{
  "iid": "-1",
  "pretty": "1"
}
Returns this error:
404 Indicator not found
{
  "error": "Indicator not found."
}

HTTP Status Codes

The API uses standard HTTP conventions to communicate result outcomes.

Success Codes

This code confirms your request completed successfully:
  • 200: Request succeeded and data is returned.

Client Error Codes

These codes indicate issues with your request that you can resolve by adjusting parameters or authentication:
  • 400: Bad request. Review your parameters or request format.
  • 401: Unauthorized. Check your API key or permissions.
  • 404: Not found. The requested resource doesn’t exist.
  • 429: Rate limit exceeded. Wait before retrying or upgrade your plan for higher limits.

Server Error Codes

These codes indicate temporary issues on our end that resolve automatically:
  • 500: Internal server error. We have been automatically notified and are investigating.