curl --request GET \
--url https://mcp.echozero.app/api/v1/developers/payouts \
--header 'Authorization: Bearer <token>' \
--header 'x-signature: <x-signature>' \
--header 'x-timestamp: <x-timestamp>'import requests
url = "https://mcp.echozero.app/api/v1/developers/payouts"
headers = {
"x-signature": "<x-signature>",
"x-timestamp": "<x-timestamp>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'x-signature': '<x-signature>',
'x-timestamp': '<x-timestamp>',
Authorization: 'Bearer <token>'
}
};
fetch('https://mcp.echozero.app/api/v1/developers/payouts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const options = {
method: 'GET',
headers: {
'x-signature': '<x-signature>',
'x-timestamp': '<x-timestamp>',
Authorization: 'Bearer <token>'
}
};
fetch('https://mcp.echozero.app/api/v1/developers/payouts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://mcp.echozero.app/api/v1/developers/payouts"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-signature", "<x-signature>")
req.Header.Add("x-timestamp", "<x-timestamp>")
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"success": true,
"data": {
"items": [
{
"id": "<string>",
"developerId": "<string>",
"developerAgentId": "<string>",
"periodIsoYear": 123,
"periodIsoWeek": 123,
"periodLabel": "<string>",
"periodStartUtc": "2023-11-07T05:31:56Z",
"periodEndUtc": "2023-11-07T05:31:56Z",
"cumulativeFeesEarnedUsdAtClose": 123,
"grossRevenue": 123,
"platformFee": 123,
"netPayout": 123,
"developerRevenueSharePercent": 123,
"status": "<string>",
"agentName": "<string>",
"agentStatus": "DRAFT",
"periodKey": "<string>",
"cumulativeV5CreatorUsdAtClose": 123,
"cumulativeV5EzUsdAtClose": 123,
"cumulativeLegacyCreatorUsdAtClose": 123,
"feeModelSource": "v5_hwm",
"effectiveRevenueSharePercent": 123,
"legacyDeveloperRevenueSharePercent": 123,
"payoutAddress": "<string>",
"txHash": "<string>",
"paidAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z"
}
],
"pagination": {
"total": 123,
"limit": 123,
"page": 123,
"totalPages": 123,
"hasNextPage": true,
"hasPreviousPage": true
}
}
}{
"success": false,
"error": {
"code": "NOT_FOUND",
"message": "Resource not found"
}
}{
"success": false,
"error": {
"code": "NOT_FOUND",
"message": "Resource not found"
}
}{
"success": false,
"error": {
"code": "NOT_FOUND",
"message": "Resource not found"
}
}Developer payout history
Paginated weekly payout rows for the authenticated developer (gross, platform fee, net, fee-model source, and cumulative bookkeeping). periodLabel is the human-readable ISO week; periodKey adds the exact snapshot anchor. developerRevenueSharePercent remains the configured compatibility value; new snapshots also expose effective netPayout / grossRevenue. V5 rows map collected HWM creator → net and EZ → platform. The hooks job records a snapshot at its actual completion anchor after the full HWM batch.
curl --request GET \
--url https://mcp.echozero.app/api/v1/developers/payouts \
--header 'Authorization: Bearer <token>' \
--header 'x-signature: <x-signature>' \
--header 'x-timestamp: <x-timestamp>'import requests
url = "https://mcp.echozero.app/api/v1/developers/payouts"
headers = {
"x-signature": "<x-signature>",
"x-timestamp": "<x-timestamp>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'x-signature': '<x-signature>',
'x-timestamp': '<x-timestamp>',
Authorization: 'Bearer <token>'
}
};
fetch('https://mcp.echozero.app/api/v1/developers/payouts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const options = {
method: 'GET',
headers: {
'x-signature': '<x-signature>',
'x-timestamp': '<x-timestamp>',
Authorization: 'Bearer <token>'
}
};
fetch('https://mcp.echozero.app/api/v1/developers/payouts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://mcp.echozero.app/api/v1/developers/payouts"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-signature", "<x-signature>")
req.Header.Add("x-timestamp", "<x-timestamp>")
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"success": true,
"data": {
"items": [
{
"id": "<string>",
"developerId": "<string>",
"developerAgentId": "<string>",
"periodIsoYear": 123,
"periodIsoWeek": 123,
"periodLabel": "<string>",
"periodStartUtc": "2023-11-07T05:31:56Z",
"periodEndUtc": "2023-11-07T05:31:56Z",
"cumulativeFeesEarnedUsdAtClose": 123,
"grossRevenue": 123,
"platformFee": 123,
"netPayout": 123,
"developerRevenueSharePercent": 123,
"status": "<string>",
"agentName": "<string>",
"agentStatus": "DRAFT",
"periodKey": "<string>",
"cumulativeV5CreatorUsdAtClose": 123,
"cumulativeV5EzUsdAtClose": 123,
"cumulativeLegacyCreatorUsdAtClose": 123,
"feeModelSource": "v5_hwm",
"effectiveRevenueSharePercent": 123,
"legacyDeveloperRevenueSharePercent": 123,
"payoutAddress": "<string>",
"txHash": "<string>",
"paidAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z"
}
],
"pagination": {
"total": 123,
"limit": 123,
"page": 123,
"totalPages": 123,
"hasNextPage": true,
"hasPreviousPage": true
}
}
}{
"success": false,
"error": {
"code": "NOT_FOUND",
"message": "Resource not found"
}
}{
"success": false,
"error": {
"code": "NOT_FOUND",
"message": "Resource not found"
}
}{
"success": false,
"error": {
"code": "NOT_FOUND",
"message": "Resource not found"
}
}Authorizations
User JWT access token issued by POST /api/auth/verify or POST /api/auth/social/verify. Routes that accept both auth modes declare api-key and bearer-jwt security schemes.
Headers
Required for API-key authenticated requests. HMAC-SHA256(secretKey, timestamp + METHOD + path + body) as lowercase hex. Omit only for JWT/OAuth session tokens or public routes.
Required with x-signature. Epoch milliseconds; rejected if drift exceeds 5 minutes. Omit only for JWT/OAuth session tokens or public routes.