Getting started

Getting started

DAY API v1 (version 1.0.0) is a non-custodial yield router for AI agents: route capital, harvest yield, and Auto Pay — without Day holding keys.

Series	v1 · 1.0.0
Preferred base	https://dayprotocol.com/api/v1
OpenAPI	/api/v1/openapi.json
SDK	npm install github:dayprotocol/sdk
Site	dayprotocol.com

Legacy unversioned paths (/api/v1/day/*) still work. New integrations should use /api/v1/*.

Full detail: API reference · Fees · Whitepaper

Phase-1 realities

• Auth is X-API-Key, not Authorization: Bearer. X-Role is ignored.
• strategyId = bare venue id (suilend, kamino) — not composite slugs.
• Writes return prepared plans (ownerMustSign: true) unless broadcast is enabled.
• Harvest does not invent yield. Principal fee 0; yield skim 500 bps.

1. Status

curl -sS https://dayprotocol.com/api/v1/day/status \
  | jq '{phase, launchHomes, protocolYieldSkimBps, executionEnabled, broadcastEnabled}'

2. List strategies

curl -sS https://dayprotocol.com/api/v1/day/strategies \
  | jq '.strategies[:5] | .[] | {strategyId, chain, ready, grossApyBps}'

Use bare venue ids such as suilend, kamino, navi (not composite slug names).

3. Deposit plan

Plans are prepare-only by default: you get a plan the owner signs. Principal fee is 0.

curl -sS -X POST https://dayprotocol.com/api/v1/day/strategies/deposit/plan \
  -H 'content-type: application/json' \
  -d '{"strategyId":"suilend","amountMicros":"1000000","owner":"0xYOUR_ADDRESS"}' \
  | jq '{status, ownerMustSign, submitted, feeMicros}'

4. Fees (MVP)

	Rate
Principal (deposit / withdraw)	0 bps
Yield skim at harvest	500 bps (5%)

See Fees.

5. Auth

curl -sS -H "X-API-Key: $DAY_OWNER_API_KEY" \
  https://dayprotocol.com/api/v1/characters/demo-agent/day/position

Roles: owner (mutations), agent (reads), keeper, public. Details: API reference.

6. SDK

import { DayClient } from "@dayprotocol/sdk";

const day = new DayClient({
  baseUrl: "https://dayprotocol.com",
  apiKey: process.env.DAY_OWNER_API_KEY,
});

await day.readiness();
await day.listStrategies();
await day.prepareStrategyDeposit({ strategyId: "suilend", amountMicros: "1000000" });

Next: API reference · OpenAPI at /api/v1/openapi.json