Gilito AIDocs

Copy Trading

Browse public portfolios, follow top-performing leaders, auto-sync positions, and publish your own strategies.

GET/api/v1/copy-trading/leaders

Browse public portfolio leaders. Paginated and sortable by performance metrics.

Query Parameters

sortBystringoptional

Sort field (totalReturn, sharpeRatio, followers). Default: totalReturn.

pagenumberoptional

Page number for pagination.

limitnumberoptional

Results per page (default 20, max 100).

minReturnnumberoptional

Minimum total return filter (e.g., 0.1 for 10%).

Response

200 OK
GET/api/v1/copy-trading/leaders
curl -X GET "https://api.gilito.ai/api/v1/copy-trading/leaders?sortBy={sortBy}&page={page}&limit={limit}&minReturn={minReturn}" \
  -H "Authorization: Bearer YOUR_API_KEY"
Try It
Example Response
{
  "data": [
    {
      "id": "ldr-abc123...",
      "slug": "quantking",
      "displayName": "QuantKing",
      "bio": "Systematic momentum strategies",
      "totalReturn": 0.456,
      "sharpeRatio": 2.1,
      "followers": 342,
      "verified": true,
      "publishedAt": "2026-01-15T00:00:00.000Z"
    }
  ],
  "meta": { "total": 150, "page": 1, "limit": 20 }
}
GET/api/v1/copy-trading/leaders/:slug

Returns detailed profile of a leader including performance history and portfolio allocation.

Path Parameters

slugstringrequired

The leader's unique slug.

Response

200 OK
GET/api/v1/copy-trading/leaders/:slug
curl -X GET "https://api.gilito.ai/api/v1/copy-trading/leaders/{slug}" \
  -H "Authorization: Bearer YOUR_API_KEY"
Try It
Example Response
{
  "data": {
    "id": "ldr-abc123...",
    "slug": "quantking",
    "displayName": "QuantKing",
    "bio": "Systematic momentum strategies",
    "totalReturn": 0.456,
    "sharpeRatio": 2.1,
    "maxDrawdown": -0.08,
    "followers": 342,
    "verified": true,
    "topHoldings": [
      { "symbol": "AAPL", "allocationPct": 15.2 },
      { "symbol": "MSFT", "allocationPct": 12.8 }
    ],
    "monthlyReturns": [
      { "month": "2026-03", "return": 0.032 },
      { "month": "2026-02", "return": 0.018 }
    ]
  }
}
GET/api/v1/copy-trading/following

Returns the list of leaders the authenticated user is currently following.

Response

200 OK
GET/api/v1/copy-trading/following
curl -X GET "https://api.gilito.ai/api/v1/copy-trading/following" \
  -H "Authorization: Bearer YOUR_API_KEY"
Try It
Example Response
{
  "data": [
    {
      "id": "fol-xyz789...",
      "leaderProfileId": "ldr-abc123...",
      "leaderSlug": "quantking",
      "leaderDisplayName": "QuantKing",
      "autoSync": true,
      "notifications": true,
      "followedAt": "2026-03-01T10:00:00.000Z"
    }
  ]
}
POST/api/v1/copy-trading/publish

Publish your portfolio as a public leader profile.

Query Parameters

portfolioIdstring (UUID)required

The portfolio to publish.

displayNamestringrequired

Public display name.

biostringoptional

Short bio or strategy description.

slugstringrequired

Unique URL slug for your profile.

Response

200 OK
POST/api/v1/copy-trading/publish
curl -X POST "https://api.gilito.ai/api/v1/copy-trading/publish?portfolioId={portfolioId}&displayName={displayName}&bio={bio}&slug={slug}" \
  -H "Authorization: Bearer YOUR_API_KEY"
Try It
Example Response
{
  "data": {
    "id": "ldr-new123...",
    "slug": "my-strategy",
    "displayName": "My Strategy",
    "bio": "Momentum-based approach",
    "portfolioId": "p1234...",
    "publishedAt": "2026-04-04T09:00:00.000Z"
  }
}
DELETE/api/v1/copy-trading/publish

Unpublish your portfolio. Followers will be notified and auto-sync will stop.

Response

200 OK
DELETE/api/v1/copy-trading/publish
curl -X DELETE "https://api.gilito.ai/api/v1/copy-trading/publish" \
  -H "Authorization: Bearer YOUR_API_KEY"
Try It
Example Response
{
  "data": {
    "status": "unpublished"
  }
}
POST/api/v1/copy-trading/follow

Follow a leader's portfolio. Optionally enable auto-sync and notifications.

Query Parameters

leaderProfileIdstringrequired

The leader profile ID to follow.

autoSyncbooleanoptional

Automatically sync positions (default false).

notificationsbooleanoptional

Receive notifications on leader trades (default true).

Response

200 OK
POST/api/v1/copy-trading/follow
curl -X POST "https://api.gilito.ai/api/v1/copy-trading/follow?leaderProfileId={leaderProfileId}&autoSync={autoSync}&notifications={notifications}" \
  -H "Authorization: Bearer YOUR_API_KEY"
Try It
Example Response
{
  "data": {
    "id": "fol-xyz789...",
    "leaderProfileId": "ldr-abc123...",
    "autoSync": false,
    "notifications": true,
    "followedAt": "2026-04-04T09:00:00.000Z"
  }
}
DELETE/api/v1/copy-trading/follow/:id

Unfollow a leader.

Path Parameters

idstringrequired

The follow relationship ID.

Response

200 OK
DELETE/api/v1/copy-trading/follow/:id
curl -X DELETE "https://api.gilito.ai/api/v1/copy-trading/follow/{id}" \
  -H "Authorization: Bearer YOUR_API_KEY"
Try It
Example Response
{
  "data": {
    "id": "fol-xyz789...",
    "status": "unfollowed"
  }
}
PATCH/api/v1/copy-trading/follow/:id/sync

Toggle auto-sync for a followed leader.

Path Parameters

idstringrequired

The follow relationship ID.

Query Parameters

autoSyncbooleanrequired

Enable or disable auto-sync.

Response

200 OK
PATCH/api/v1/copy-trading/follow/:id/sync
curl -X PATCH "https://api.gilito.ai/api/v1/copy-trading/follow/{id}/sync?autoSync={autoSync}" \
  -H "Authorization: Bearer YOUR_API_KEY"
Try It
Example Response
{
  "data": {
    "id": "fol-xyz789...",
    "autoSync": true,
    "updatedAt": "2026-04-04T09:00:00.000Z"
  }
}
GET/api/v1/copy-trading/leaders/:slug/transactions

Returns verified transactions from a leader's portfolio.

Path Parameters

slugstringrequired

The leader's unique slug.

Response

200 OK
GET/api/v1/copy-trading/leaders/:slug/transactions
curl -X GET "https://api.gilito.ai/api/v1/copy-trading/leaders/{slug}/transactions" \
  -H "Authorization: Bearer YOUR_API_KEY"
Try It
Example Response
{
  "data": [
    {
      "id": "txn-abc123...",
      "symbol": "AAPL",
      "side": "buy",
      "quantity": 50,
      "price": 178.50,
      "executedAt": "2026-04-03T14:35:00.000Z",
      "verified": true
    }
  ]
}
GET/api/v1/copy-trading/strategies

Returns published strategies available for copy trading.

Response

200 OK
GET/api/v1/copy-trading/strategies
curl -X GET "https://api.gilito.ai/api/v1/copy-trading/strategies" \
  -H "Authorization: Bearer YOUR_API_KEY"
Try It
Example Response
{
  "data": [
    {
      "id": "strat-pub-123...",
      "name": "Momentum RSI",
      "description": "RSI-based momentum strategy",
      "authorSlug": "quantking",
      "totalReturn": 0.34,
      "sharpeRatio": 1.9,
      "publishedAt": "2026-03-01T00:00:00.000Z"
    }
  ]
}
POST/api/v1/copy-trading/strategies

Publish a strategy for others to follow.

Query Parameters

strategyHashstringrequired

The strategy hash to publish.

namestringrequired

Display name for the strategy.

descriptionstringoptional

Strategy description.

Response

200 OK
POST/api/v1/copy-trading/strategies
curl -X POST "https://api.gilito.ai/api/v1/copy-trading/strategies?strategyHash={strategyHash}&name={name}&description={description}" \
  -H "Authorization: Bearer YOUR_API_KEY"
Try It
Example Response
{
  "data": {
    "id": "strat-pub-456...",
    "strategyHash": "abc123...",
    "name": "Momentum RSI",
    "description": "RSI-based momentum strategy",
    "publishedAt": "2026-04-04T09:00:00.000Z"
  }
}
DELETE/api/v1/copy-trading/strategies/:id

Unpublish a strategy.

Path Parameters

idstringrequired

The published strategy ID.

Response

200 OK
DELETE/api/v1/copy-trading/strategies/:id
curl -X DELETE "https://api.gilito.ai/api/v1/copy-trading/strategies/{id}" \
  -H "Authorization: Bearer YOUR_API_KEY"
Try It
Example Response
{
  "data": {
    "id": "strat-pub-456...",
    "status": "unpublished"
  }
}