list_my_deals
Read · Sign-in needed
Your deals, with their agreed terms
Lists every deal the signed-in account is a party to, across all its linked wallets: offers you made, deals you accepted, and offers waiting for YOUR answer as a registration holder. This is the only list that includes each deal's agreed terms, and each row carries actions (what you may do now) and stage. Use it for "what's happening with my deals" and "what do I need to answer". Filter with deal_type and status; an unknown value is a 400, not an empty list. Paginate with limit/offset against total.
| Reads or changes | Reads only |
| Sign-in | Yes |
| Scope | api:read |
| Calls | GET /api/v2/deals/mine (API Explorer) |
Input
JSON Schema, as the server serves it.
json
{
"additionalProperties": false,
"properties": {
"deal_type": {
"enum": [
"buyout",
"merge",
"project_sale",
"collab"
],
"type": "string"
},
"limit": {
"default": 20,
"description": "Page size.",
"type": "integer"
},
"offset": {
"default": 0,
"description": "Rows to skip.",
"type": "integer"
},
"status": {
"enum": [
"draft",
"pending",
"announced",
"paused",
"payment_pending",
"executing",
"completed",
"failed",
"cancelled",
"migrating",
"closed"
],
"type": "string"
}
},
"type": "object"
}Example
A tools/call request:
json
{
"name": "list_my_deals",
"arguments": {}
}