---
title: "Get Positions"
method: GET
path: "/v1/earn/positions"
tags: ["earn"]
---

# Get Positions

`GET /v1/earn/positions`

## Request

- Base URL: `https://api.fereai.xyz`
- URL: `https://api.fereai.xyz/v1/earn/positions`
- Auth: none declared

Get yield positions and history.

## Response `200`

Successful Response

- EarnPositionsResponse: Positions and activity history.
  - `positions` EarnPosition[]: List of yield positions.
    - `id` string, required: Position ID (UUID).
    - `agent_id` string, required: Agent that owns the position.
    - `status` string, required: Position status: active, withdrawn.
    - `vault_chain_name` string: Chain for this position (Base or Arbitrum).
    - `current_apy` number, nullable: Current APY percentage.
    - `amount_deposited_usdc` number, nullable: Total USDC deposited.
    - `current_value_usdc` number, nullable: Current value of the position in USDC.
    - `unrealized_yield_usdc` number, nullable: Unrealized yield in USDC.
    - `created_at` string, nullable: ISO 8601 creation timestamp.
  - `history` EarnHistoryEntry[]: Activity history entries.
    - `id` string: History entry ID.
    - `position_id` string: Associated position ID.
    - `action_type` string: Action type: deposit, withdraw.
    - `amount_usdc` number, nullable: Amount in USDC.
    - `status` string: Entry status: pending, completed, failed.
    - `created_at` string, nullable: ISO 8601 timestamp.

---

[API](https://skmtc.dev/fereai/apis/fereai-gateway.md) - [All operations](https://skmtc.dev/fereai/apis/fereai-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/fereai/apis/fereai-gateway/revisions/ad211f8e2f30?raw)