Vaults

This is the simulated Earn API. Position creation and withdrawal change sandbox records; they do not sign a wallet transaction.

Authentication · Errors · Amounts and units

List vaults

GET /vaults

Parameters

| Name | Location | Type | Required | Description |

| --- | --- | --- | --- | --- |

| asset | query | "USDC", "USDT" | No | Filter by asset |

| chain | query | "base", "arbitrum" | No | Filter by chain |

| status | query | "active", "paused" | No | Filter by status |

| limit | query | integer | No | Page size (1-500, default 100) |

| cursor | query | string | No | Opaque cursor returned as meta.next_cursor |

Response · 200

Field	Type	Required	Description
object	"list"	Yes
data	Vault[]	Yes
meta	ListMeta	Yes

For failed requests, inspect error.code, error.message and the request ID. Error handling.

Get a vault

GET /vaults/{id}

Parameters

| Name | Location | Type | Required | Description |

| --- | --- | --- | --- | --- |

| id | path | string | Yes | Vault id |

Response · 200

Field	Type	Required	Description
object	string	Yes
data	Vault	Yes
meta	object	No

For failed requests, inspect error.code, error.message and the request ID. Error handling.