Safix API v1 - Documentation

Authentication

All requests require a valid API key passed as a query parameter.

?api_key=YOUR_KEY

Rate Limits

Per Minute

requests per API key

Per Hour

1800

requests per API key

Endpoints

GET/api/v1/{symbol}

Single Cryptocurrency

Get the current price and data of a specific cryptocurrency with prices in multiple currencies (USD, EUR, BRL, ETH, BTC).

Parameters:

symbol (path) - Cryptocurrency symbol (e.g., btc, eth, ada)
api_key (query) - Your API key

Example:

GET /api/v1/btc?api_key=YOUR_KEY

Response:

{
  "success": true,
  "symbol": "BTC",
  "name": "Bitcoin",
  "price": "105213.00",
  "price_usd": "105213.00",
  "price_eur": "92082.00",
  "price_brl": "593992.00",
  "price_eth": 39.888336,
  "price_btc": 1,
  "change_24h": -1.30,
  "change_24h_percent": -1.30,
  "market_cap": 2137912292133,
  "volume_24h": 28657300789,
  "rank": 1,
  "last_updated": "2025-05-25T20:27:49.000Z",
  "timestamp": "2025-05-25T20:28:46.874Z"
}

Code Samples:

curl -X GET "https://yourdomain.com/api/v1/btc?api_key=YOUR_KEY"

GET/api/v1/ticker

Multiple Cryptocurrencies

Get data from multiple cryptocurrencies in a single request with prices in multiple currencies (USD, EUR, BRL, ETH, BTC).

Parameters:

symbols (query) - Cryptocurrency symbols separated by comma (default: btc,eth,ada)
limit (query) - Maximum number of results (default: 10)
api_key (query) - Your API key

Example:

GET /api/v1/ticker?api_key=YOUR_KEY&symbols=btc,eth,ada&limit=5

Response:

{
  "success": true,
  "data": [
    {
      "symbol": "BTC",
      "name": "Bitcoin",
      "price": "105221.00",
      "price_usd": "105221.00",
      "price_eur": "92080.00",
      "price_brl": "594098.00",
      "price_eth": 39.883726,
      "price_btc": 1,
      "change_24h": -1130.25,
      "change_24h_percent": -1.06,
      "market_cap": 2084728375633,
      "volume_24h": 24858264592,
      "rank": 1,
      "last_updated": "2025-06-04T16:11:56.000Z",
      "pair": "BTC/USD"
    }
  ],
  "count": 1,
  "vs_currency": "USD",
  "timestamp": "2025-06-04T16:12:31.035Z"
}

Code Samples:

curl -X GET "https://yourdomain.com/api/v1/ticker?api_key=YOUR_KEY&symbols=btc,eth,ada&limit=5"

GET/api/v1/all

All Cryptocurrencies

Get all supported cryptocurrencies with prices in multiple currencies (USD, EUR, BRL, ETH, BTC).

Parameters:

api_key (query) - Your API key

Example:

GET /api/v1/all?api_key=YOUR_KEY

Response:

{
  "success": true,
  "data": [
    {
      "symbol": "BTC",
      "name": "Bitcoin",
      "price": "105221.00",
      "price_usd": "105221.00",
      "price_eur": "92080.00",
      "price_brl": "594098.00",
      "price_eth": 39.883726,
      "price_btc": 1,
      "change_24h": -1130.25,
      "change_24h_percent": -1.06,
      "market_cap": 2137912292133,
      "volume_24h": 28657300789,
      "rank": 1,
      "last_updated": "2025-05-25T20:27:49.000Z"
    }
  ],
  "count": 24,
  "currencies": ["USD", "EUR", "BRL", "ETH", "BTC"],
  "timestamp": "2025-05-25T20:28:57.310Z"
}

Code Samples:

curl -X GET "https://yourdomain.com/api/v1/all?api_key=YOUR_KEY"

GET/POST/api/ping

Ping Test

Simple ping-pong endpoint to test API connectivity (no authentication required).

Example:

GET /api/ping

Response:

{
  "success": true,
  "message": "pong",
  "timestamp": "2025-05-26T15:30:00.000Z",
  "server": "Safix API v1",
  "status": "operational"
}

Code Samples:

curl -X GET "https://yourdomain.com/api/ping"

GET/api/v1

API Documentation

Get complete API documentation and examples.

Example:

GET /api/v1

Supported Symbols

btcethadasoldotlinkltcdogexrpxlmbnbusdtusdcmaticavaxshibtrxetcbchvetdepixlbtceurteurx

And many more...

Error Codes

401Invalid or missing API key

404Cryptocurrency not found

429Rate limit exceeded

500Internal server error