Wallets

Exchange Privy session for Ethos JWTs

post

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

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Successful response

application/json

okboolean · enumRequiredPossible values:

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

post

/auth/exchange

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

deviceIdentifierstringOptional

Responses

200

Successful response

application/json

okboolean · enumRequiredPossible values:

400

Invalid input data

application/json

500

Internal server error

application/json

post

/auth/logout

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

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Successful response

application/json

okbooleanRequired

profileIdnumberRequired

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

get

/wallets/privy/auth-check

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

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Successful response

application/json

balanceinteger · int64Required

sponsorshipEligiblebooleanRequired

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

get

/wallets/privy/check-funds

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

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

scorestring · enumRequiredPossible values:

titlestring · min: 1Required

contentstring · min: 1Optional

metadataany ofOptionalDefault: []

subjectany ofRequired

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

hashanyRequired

reviewSlugstringOptional

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

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

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

scorestring · enumRequiredPossible values:

titlestring · min: 1Required

contentstring · min: 1Optional

metadataany ofOptionalDefault: []

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

hashanyRequired

reviewSlugstringOptional

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

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

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

scorestring · enumRequiredPossible values:

titlestring · min: 1Required

contentstring · min: 1Optional

metadataany ofOptionalDefault: []

xany ofRequired

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

hashanyRequired

reviewSlugstringOptional

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

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"
}

Edit a review via an Ethos Everywhere wallet

post

Signs and submits a review edit 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

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

idinteger · max: 2147483647Required

titlestring · min: 1Required

contentstring · min: 1Optional

metadataany ofOptionalDefault: []

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

hashanyRequired

reviewSlugstringOptional

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/edit/review

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

{
  "id": 1,
  "title": "text",
  "content": "text",
  "metadata": [
    {
      "key": "text",
      "value": "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

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

activityTypestring · enumRequiredPossible values:

idinteger · max: 2147483647Required

Body

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

hashanyRequired

voteanyOptional

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

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

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

activityTypestring · enumRequiredPossible values:

idinteger · max: 2147483647Required

Body

contentstring · min: 1Required

metadataany ofOptionalDefault: []

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

hashanyRequired

replyanyOptional

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

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

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idinteger · max: 2147483647Required

Body

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

hashanyRequired

reviewanyOptional

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

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

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

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

hashanyRequired

processedbooleanRequired

Whether the invitation transaction has been received & processed by Ethos.

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

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

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

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

hashanyRequired

processedbooleanRequired

Whether the uninvite transaction has been received & processed by Ethos.

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

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
}

Archive a bond via Ethos Everywhere wallet

post

Archives a bond 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

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

bondIdinteger · max: 2147483647Required

Body

archiveReasonstring · min: 1Required

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

hashanyRequired

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/bond/{bondId}/archive

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

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

{
  "hash": null
}

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

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

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

hashanyRequired

processedbooleanRequired

Whether the bond transaction has been received & processed by Ethos.

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

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
}

PreviousVouches NextXp

Last updated 21 hours ago

hashtagExchange Privy session for Ethos JWTs

hashtagLogout and clear Ethos JWT cookies

hashtagVerify authentication for Ethos Everywhere wallet

hashtagCheck if wallet has enough funds for transactions

hashtagCreate a review via an Ethos Everywhere wallet

hashtagCreate a review by address via an Ethos Everywhere wallet

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

hashtagEdit a review via an Ethos Everywhere wallet

hashtagVote on an activity via Ethos Everywhere wallet

hashtagReply to an activity via Ethos Everywhere wallet

hashtagArchive a review via Ethos Everywhere wallet

hashtagInvite an address via Ethos Everywhere wallet

hashtagCancel an invite via Ethos Everywhere wallet

hashtagArchive a bond via Ethos Everywhere wallet

hashtagCreate a bond via Ethos Everywhere wallet

Exchange Privy session for Ethos JWTs

Logout and clear Ethos JWT cookies

Verify authentication for Ethos Everywhere wallet

Check if wallet has enough funds for transactions

Create a review via an Ethos Everywhere wallet

Create a review by address via an Ethos Everywhere wallet

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

Edit a review via an Ethos Everywhere wallet

Vote on an activity via Ethos Everywhere wallet

Reply to an activity via Ethos Everywhere wallet

Archive a review via Ethos Everywhere wallet

Invite an address via Ethos Everywhere wallet

Cancel an invite via Ethos Everywhere wallet

Archive a bond via Ethos Everywhere wallet

Create a bond via Ethos Everywhere wallet