Wallets

Exchange Privy session for Ethos JWTs

post

Verifies the Privy bearer token and sets Ethos access/refresh JWTs via HttpOnly cookies.

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Successful response

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

post

/auth/exchange

HTTPcURLJavaScriptPython

POST /api/v2/auth/exchange HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "ok": true
}

Logout and clear Ethos JWT cookies

post

Clears Ethos access/refresh cookies and revokes the current refresh token if present. If deviceIdentifier is provided, also removes the FCM push notification token for that device. Safe to call even if not authenticated.

Body

application/json

deviceIdentifierstringOptional

Responses

200

Successful response

application/json

400

Invalid input data

application/json

500

Internal server error

application/json

post

/auth/logout

HTTPcURLJavaScriptPython

POST /api/v2/auth/logout HTTP/1.1
Host: api.ethos.network
Content-Type: application/json
Accept: */*
Content-Length: 27

{
  "deviceIdentifier": "text"
}

{
  "ok": true
}

Verify authentication for Ethos Everywhere wallet

get

Returns ok when authenticated. If the access token is expired, it will be refreshed using the refresh token.

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Successful response

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

get

/wallets/privy/auth-check

HTTPcURLJavaScriptPython

GET /api/v2/wallets/privy/auth-check HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "ok": true,
  "profileId": 1
}

Check if wallet has enough funds for transactions

get

Returns whether the Ethos Everywhere wallet has sufficient balance for transactions like reviews, votes, or replies. Also indicates if gas sponsorship is available.

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Successful response

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

get

/wallets/privy/check-funds

HTTPcURLJavaScriptPython

GET /api/v2/wallets/privy/check-funds HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "balance": 1,
  "sponsorshipEligible": true
}

Create a review via an Ethos Everywhere wallet

post

Signs and submits a review transaction using the user's Ethos Everywhere wallet. > ⚠️ Warning: This is a beta endpoint. It is not guaranteed to be stable and may change or break without notice.

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

scorestring · enumRequiredPossible values:

titlestring · min: 1Required

contentstring · min: 1Optional

metadataany ofOptionalDefault: []

or

subjectany ofRequired

or

or

waitForTxTimeoutSecondsnumberOptional

Timeout in seconds to wait for the transaction to be processed by Ethos. Defaults to 5 seconds. Set to 0 to skip waiting.

Default: 5

Responses

200

Successful response

application/json

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

post

/wallets/privy/post/review

HTTPcURLJavaScriptPython

POST /api/v2/wallets/privy/post/review HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 152

{
  "score": "negative",
  "title": "text",
  "content": "text",
  "metadata": [
    {
      "key": "text",
      "value": "text"
    }
  ],
  "subject": {
    "address": "text"
  },
  "waitForTxTimeoutSeconds": 5
}

{
  "hash": null,
  "review": {
    "id": 1,
    "authorProfileId": 1,
    "author": "text",
    "subject": "text",
    "score": "negative",
    "comment": "text",
    "metadata": "text",
    "createdAt": 1,
    "archived": true,
    "attestationDetails": {
      "account": "text",
      "service": "text"
    }
  },
  "reviewSlug": "text"
}

Create a review by address via an Ethos Everywhere wallet

post

Signs and submits a review transaction for a subject address using the user's Ethos Everywhere wallet. > ⚠️ Warning: This is a beta endpoint. It is not guaranteed to be stable and may change or break without notice.

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

scorestring · enumRequiredPossible values:

titlestring · min: 1Required

contentstring · min: 1Optional

metadataany ofOptionalDefault: []

or

addressstringRequired

waitForTxTimeoutSecondsnumberOptional

Timeout in seconds to wait for the transaction to be processed by Ethos. Defaults to 5 seconds. Set to 0 to skip waiting.

Default: 5

Responses

200

Successful response

application/json

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

post

/wallets/privy/post/review/by-address

HTTPcURLJavaScriptPython

POST /api/v2/wallets/privy/post/review/by-address HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 140

{
  "score": "negative",
  "title": "text",
  "content": "text",
  "metadata": [
    {
      "key": "text",
      "value": "text"
    }
  ],
  "address": "text",
  "waitForTxTimeoutSeconds": 5
}

{
  "hash": null,
  "review": {
    "id": 1,
    "authorProfileId": 1,
    "author": "text",
    "subject": "text",
    "score": "negative",
    "comment": "text",
    "metadata": "text",
    "createdAt": 1,
    "archived": true,
    "attestationDetails": {
      "account": "text",
      "service": "text"
    }
  },
  "reviewSlug": "text"
}

Create a review for x.com account via an Ethos Everywhere wallet

post

Signs and submits a review transaction for an x.com account (id or username) using the user's Ethos Everywhere wallet. > ⚠️ Warning: This is a beta endpoint. It is not guaranteed to be stable and may change or break without notice.

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

scorestring · enumRequiredPossible values:

titlestring · min: 1Required

contentstring · min: 1Optional

metadataany ofOptionalDefault: []

or

xany ofRequired

or

waitForTxTimeoutSecondsnumberOptional

Timeout in seconds to wait for the transaction to be processed by Ethos. Defaults to 5 seconds. Set to 0 to skip waiting.

Default: 5

Responses

200

Successful response

application/json

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

post

/wallets/privy/post/review/by-x

HTTPcURLJavaScriptPython

POST /api/v2/wallets/privy/post/review/by-x HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 141

{
  "score": "negative",
  "title": "text",
  "content": "text",
  "metadata": [
    {
      "key": "text",
      "value": "text"
    }
  ],
  "x": {
    "id": "text"
  },
  "waitForTxTimeoutSeconds": 5
}

{
  "hash": null,
  "review": {
    "id": 1,
    "authorProfileId": 1,
    "author": "text",
    "subject": "text",
    "score": "negative",
    "comment": "text",
    "metadata": "text",
    "createdAt": 1,
    "archived": true,
    "attestationDetails": {
      "account": "text",
      "service": "text"
    }
  },
  "reviewSlug": "text"
}

Vote on an activity via Ethos Everywhere wallet

post

Submits an upvote or downvote on a review, vouch, attestation, slash, broker post, project, reputation market, or reply using the user's Ethos Everywhere wallet. > ⚠️ Warning: This is a beta endpoint. It is not guaranteed to be stable and may change or break without notice.

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

activityTypestring · enumRequiredPossible values:

idinteger · max: 2147483647Required

Body

application/json

isUpvotebooleanRequired

waitForTxTimeoutSecondsnumberOptional

Timeout in seconds to wait for the transaction to be processed by Ethos. Defaults to 5 seconds. Set to 0 to skip waiting.

Default: 5

Responses

200

Successful response

application/json

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

post

/wallets/activity/{activityType}/{id}/vote

HTTPcURLJavaScriptPython

POST /api/v2/wallets/activity/{activityType}/{id}/vote HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 45

{
  "isUpvote": true,
  "waitForTxTimeoutSeconds": 5
}

{
  "hash": null,
  "vote": null
}

Reply to an activity via Ethos Everywhere wallet

post

Posts a reply to a review, vouch, attestation, slash, broker post, project, reputation market, or existing reply (use activityType='reply') using the user's Ethos Everywhere wallet. > ⚠️ Warning: This is a beta endpoint. It is not guaranteed to be stable and may change or break without notice.

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

activityTypestring · enumRequiredPossible values:

idinteger · max: 2147483647Required

Body

application/json

contentstring · min: 1Required

metadataany ofOptionalDefault: []

or

waitForTxTimeoutSecondsnumberOptional

Timeout in seconds to wait for the transaction to be processed by Ethos. Defaults to 5 seconds. Set to 0 to skip waiting.

Default: 5

Responses

200

Successful response

application/json

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

post

/wallets/activity/{activityType}/{id}/reply

HTTPcURLJavaScriptPython

POST /api/v2/wallets/activity/{activityType}/{id}/reply HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 89

{
  "content": "text",
  "metadata": [
    {
      "key": "text",
      "value": "text"
    }
  ],
  "waitForTxTimeoutSeconds": 5
}

{
  "hash": null,
  "reply": null
}

Archive a review via Ethos Everywhere wallet

post

Archives a review using the user's Ethos Everywhere wallet. > ⚠️ Warning: This is a beta endpoint. It is not guaranteed to be stable and may change or break without notice.

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idinteger · max: 2147483647Required

Body

application/json

waitForTxTimeoutSecondsnumberOptional

Timeout in seconds to wait for the transaction to be processed by Ethos. Defaults to 5 seconds. Set to 0 to skip waiting.

Default: 5

Responses

200

Successful response

application/json

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

post

/wallets/activity/review/{id}/archive

HTTPcURLJavaScriptPython

POST /api/v2/wallets/activity/review/{id}/archive HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 29

{
  "waitForTxTimeoutSeconds": 5
}

{
  "hash": null,
  "review": null
}

Invite an address via Ethos Everywhere wallet

post

Invites an address to Ethos using the user's Ethos Everywhere wallet. > ⚠️ Warning: This is a beta endpoint. It is not guaranteed to be stable and may change or break without notice.

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

inviteestringRequired

waitForTxTimeoutSecondsnumberOptional

Timeout in seconds to wait for the transaction to be processed by Ethos. Defaults to 5 seconds. Set to 0 to skip waiting.

Default: 5

Responses

200

Successful response

application/json

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

post

/wallets/privy/invite/address

HTTPcURLJavaScriptPython

POST /api/v2/wallets/privy/invite/address HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 46

{
  "invitee": "text",
  "waitForTxTimeoutSeconds": 5
}

{
  "hash": null,
  "processed": true
}

Cancel an invite via Ethos Everywhere wallet

post

Cancels an invitation (uninvites a user) using the user's Ethos Everywhere wallet. > ⚠️ Warning: This is a beta endpoint. It is not guaranteed to be stable and may change or break without notice.

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

inviteestringRequired

waitForUninviteTimeoutSecondsnumberOptional

Timeout in seconds to wait for the uninvite transaction to be processed by Ethos. Defaults to 5 seconds. Set to 0 to skip waiting.

Default: 5

Responses

200

Successful response

application/json

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

post

/wallets/privy/invite/cancel

HTTPcURLJavaScriptPython

POST /api/v2/wallets/privy/invite/cancel HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 52

{
  "invitee": "text",
  "waitForUninviteTimeoutSeconds": 5
}

{
  "hash": null,
  "processed": true
}

Create a bond via Ethos Everywhere wallet

post

Creates a bond using the user's Ethos Everywhere wallet. The signature must be obtained from the signatures.createHumanityBond endpoint first. > ⚠️ Warning: This is a beta endpoint. It is not guaranteed to be stable and may change or break without notice.

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

statementstring · min: 1Required

bondTypestring · min: 1Required

expirationstring · min: 1Required

amountstring · min: 1Required

amountTypestring · min: 1Required

metadatastringOptionalDefault: ""

randValueintegerRequired

signatureanyRequired

waitForTxTimeoutSecondsnumberOptional

Timeout in seconds to wait for the transaction to be processed by Ethos. Defaults to 5 seconds. Set to 0 to skip waiting.

Default: 5

Responses

200

Successful response

application/json

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

post

/wallets/privy/bonds

HTTPcURLJavaScriptPython

POST /api/v2/wallets/privy/bonds HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 167

{
  "statement": "text",
  "bondType": "text",
  "expiration": "text",
  "amount": "text",
  "amountType": "text",
  "metadata": "",
  "randValue": 1,
  "signature": null,
  "waitForTxTimeoutSeconds": 5
}

{
  "hash": null,
  "processed": true
}