Everything you need to integrate with the Artsays Trading API. Follow the steps below to make your first API call.
Your API key is generated by the platform admin. Contact your admin or visit the Settings page to request access.
sk_sandbox_...Sandbox key — Returns mock/test data. No real funds are affected. Use this for development and testing.
sk_prod_...Production key — Returns real live data. Real trading and real funds. Use only in production environments.
Every API request must include your API key. You can pass it in two ways:
x-api-key: sk_sandbox_your_key_here
Most secure. Use this in production.
?x-api-key=sk_sandbox_your_key_here
Convenient for quick testing in Postman or browser.
https://trading.artsays.in/api/v1/All endpoints are prefixed with /api/v1/. Both sandbox and production use the same URL — your API key determines the environment.
Try fetching the asset list — the simplest endpoint with no required parameters:
curl -X GET "https://trading.artsays.in/api/v1/assets" \
-H "x-api-key: YOUR_API_KEY"Or in Postman:
https://trading.artsays.in/api/v1/assetsx-api-key, Value = your_api_keyAll responses are JSON with a consistent structure:
{
"success": true,
"count": 12,
"data": [...]
}{
"error": "Invalid or missing API key"
}Sandbox responses include extra fields: "test": true and "environment": "sandbox"
| Problem | Cause | Fix |
|---|---|---|
Missing API Key | No x-api-key header or query param sent | Add the header or query parameter with your key |
Invalid API Key | Key doesn't match any record in database, or has been rotated/deleted | Check key is correct, not expired. Generate a new key from admin. |
Endpoint not allowed | Your API key does not have permission for this endpoint | Contact admin to add endpoint to your allowed list |
429 Too Many Requests | Exceeded 60 requests/min rate limit | Wait and retry. Check Retry-After header. |
Sandbox returns test data | Using a sk_sandbox_ key | Switch to sk_prod_ key for real data |
Return market-wide data. Any valid API key can access these. No user identity is needed.
Return data specific to the API client user. The API key acts as the user identity — you see only your own orders, portfolio, and wallet.
Default rate limit is 60 requests per minute per API key. Exceeding this returns a 429 status. Your admin can adjust your per-key limit. The Retry-After header indicates when you can retry.
| Method | Path | Description | Scope |
|---|---|---|---|
| GET | /api/v1/stats | Market Stats | Public |
| GET | /api/v1/assets | Asset List | Public |
| GET | /api/v1/trades | Recent Trades | Public |
| GET | /api/v1/orderbook | Orderbook | Public |
| GET | /api/v1/artists | Artist Directory | Public |
| GET | /api/v1/ipo | IPO Listings | Public |
| POST | /api/v1/ipo/subscribe | IPO Subscribe | User |
| GET | /api/v1/orders | List Orders | User |
| POST | /api/v1/orders | Place Order | User |
| GET | /api/v1/portfolio | My Portfolio | User |
| GET | /api/v1/wallet | Wallet Balance | User |
| GET | /api/v1/transactions | Transaction Ledger | User |
| GET | /api/v1/withdrawals | Withdrawal History | User |
| POST | /api/v1/withdrawals | Request Withdrawal | User |
| GET | /api/v1/artist/artworks | List Artworks | User |
| POST | /api/v1/artist/artworks | Submit Artwork | User |