API Reference

Complete REST API documentation for AGI-CAD Portfolio

Base URL

https://www.agi-hive.com/api/v1

Authentication

Most API endpoints require authentication. Include your Firebase ID token in the Authorization header:

Authorization: Bearer YOUR_ID_TOKEN

Portfolio

Endpoints for managing and retrieving portfolio data

GET/api/portfolio🔒 Auth Required

Get current portfolio holdings and total value

Response

Portfolio object with holdings array and total value

Alerts

Endpoints for creating and managing price alerts

POST/api/alerts🔒 Auth Required

Create a new price alert

Request Body

Field	Type	Required	Description
`symbol`	`string`	Yes	Cryptocurrency symbol (e.g., BTC)
`targetPrice`	`number`	Yes	Target price in USD
`direction`	`string`	Yes	Alert direction: "above" or "below"
`notifyVia`	`string[]`	Yes	Notification channels

Response

Created alert object

GET/api/alerts🔒 Auth Required

List all price alerts

Parameters

Name	Type	Required	Description
`status`	`string`	No	Filter by status: "active", "triggered", "expired"

Response

Array of alert objects

DELETE/api/alerts/:id🔒 Auth Required

Delete a price alert

Parameters

Name	Type	Required	Description
`id`	`string`	Yes	Alert ID

Response

Success message

Prices

Endpoints for retrieving cryptocurrency price data

GET/api/prices/:symbol

Get current price for a cryptocurrency

Parameters

Name	Type	Required	Description
`symbol`	`string`	Yes	Cryptocurrency symbol

Response

Price data object

Exchanges

Endpoints for connecting and managing exchange integrations

POST/api/exchanges/connect🔒 Auth Required

Connect an exchange account

Request Body

Field	Type	Required	Description
`exchange`	`string`	Yes	Exchange name (coinbase, binance, etc.)
`apiKey`	`string`	Yes	Exchange API key
`apiSecret`	`string`	Yes	Exchange API secret

Response

Connection status

Rate Limits

Authenticated Requests

1000/hour

Public Endpoints

100/hour

Rate limit headers are included in all responses:X-RateLimit-Limit,X-RateLimit-Remaining

Error Codes

Code	Message	Description
`200`	OK	Request successful
`400`	Bad Request	Invalid request parameters
`401`	Unauthorized	Missing or invalid auth token
`403`	Forbidden	Insufficient permissions for resource
`404`	Not Found	Resource does not exist
`429`	Too Many Requests	Rate limit exceeded
`500`	Internal Server Error	Server error occurred