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

okconst: Required

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

okconst: Required

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

hashstringRequired

0x-prefixed 32-byte transaction hash (keccak256)

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": "text",
  "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

Ethereum address (0x-prefixed, 20 bytes)

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

hashstringRequired

0x-prefixed 32-byte transaction hash (keccak256)

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": "text",
  "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

hashstringRequired

0x-prefixed 32-byte transaction hash (keccak256)

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": "text",
  "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

hashstringRequired

0x-prefixed 32-byte transaction hash (keccak256)

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": "text",
  "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

isArchivebooleanOptional

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

hashstringRequired

0x-prefixed 32-byte transaction hash (keccak256)

voteobjectOptional

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: 62

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

{
  "hash": "text",
  "vote": {}
}

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

hashstringRequired

0x-prefixed 32-byte transaction hash (keccak256)

replyobjectOptional

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": "text",
  "reply": {}
}

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

hashstringRequired

0x-prefixed 32-byte transaction hash (keccak256)

reviewobjectOptional

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": "text",
  "review": {}
}

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

Ethereum address (0x-prefixed, 20 bytes)

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

hashstringRequired

0x-prefixed 32-byte transaction hash (keccak256)

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": "text",
  "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

Ethereum address (0x-prefixed, 20 bytes)

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

hashstringRequired

0x-prefixed 32-byte transaction hash (keccak256)

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": "text",
  "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

hashstringRequired

0x-prefixed 32-byte transaction hash (keccak256)

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

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

randValueinteger · max: 9007199254740991Required

signaturestringRequired

65-byte ECDSA signature (0x-prefixed hex, 132 chars)

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

hashstringRequired

0x-prefixed 32-byte transaction hash (keccak256)

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: 169

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

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

Vouch for a user via Ethos Everywhere wallet

post

Submits a vouch transaction using the user’s Ethos Everywhere wallet. The user’s EEW wallet must hold sufficient ETH to cover both the stake amount and gas.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

targetany ofRequired

commentstring · min: 1Required

paymentAmountEthstringRequired

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

hashstringRequired

0x-prefixed 32-byte transaction hash (keccak256)

processedbooleanRequired

Whether the vouch 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/vouches

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

{
  "target": {
    "address": "text"
  },
  "comment": "text",
  "metadata": {
    "description": "text",
    "source": "text",
    "importedFromTestnet": 1,
    "batchId": "123e4567-e89b-12d3-a456-426614174000",
    "reviewId": 1,
    "client": "text",
    "clientSource": "text",
    "version": "text"
  },
  "paymentAmountEth": "text",
  "waitForTxTimeoutSeconds": 5
}

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

Increase an existing vouch via Ethos Everywhere wallet

post

Submits an increaseVouch transaction using the user’s Ethos Everywhere wallet. Restricted to vouches whose authorProfileId equals the caller’s profile — the contract permits any address registered to that profile, so the EEW can top up a vouch originally created by a different wallet. The EEW must hold sufficient ETH to cover both the additional stake and gas.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

vouchIdinteger · max: 9007199254740991Required

paymentAmountEthstringRequired

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

hashstringRequired

0x-prefixed 32-byte transaction hash (keccak256)

processedbooleanRequired

Whether the increaseVouch 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/vouches/increase

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

{
  "vouchId": 1,
  "paymentAmountEth": "text",
  "waitForTxTimeoutSeconds": 5
}

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

Unvouch via Ethos Everywhere wallet

post

Submits an unvouch transaction using the user’s Ethos Everywhere wallet. Restricted to vouches whose original authorAddress equals the EEW. The contract refunds balance - exitFee to the original authorAddress (the EEW). When isHealthy=false, dispatches to unvouchUnhealthy (combo unvouch + markUnhealthy).

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

vouchIdinteger · max: 9007199254740991Required

isHealthybooleanRequired

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

hashstringRequired

0x-prefixed 32-byte transaction hash (keccak256)

processedbooleanRequired

Whether the unvouch 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/vouches/unvouch

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

{
  "vouchId": 1,
  "isHealthy": true,
  "waitForTxTimeoutSeconds": 5
}

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

Buy market votes via Ethos Everywhere wallet

post

Submits a buyVotes transaction on the ReputationMarket contract using the user’s Ethos Everywhere wallet. The user’s EEW wallet must hold sufficient ETH to cover both the buy amount and gas.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

profileIdinteger · max: 2147483647Required

isPositivebooleanRequired

maxVotesToBuyinteger · max: 9007199254740991Required

minVotesToBuyinteger · max: 9007199254740991Required

buyAmountEthstringRequired

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

hashstringRequired

0x-prefixed 32-byte transaction hash (keccak256)

processedbooleanRequired

Whether the market buy 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/markets/buy

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

{
  "profileId": 1,
  "isPositive": true,
  "maxVotesToBuy": 1,
  "minVotesToBuy": 1,
  "buyAmountEth": "text",
  "waitForTxTimeoutSeconds": 5
}

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

Sell market votes via Ethos Everywhere wallet

post

Submits a sellVotes transaction on the ReputationMarket contract using the user’s Ethos Everywhere wallet. The contract sends ETH proceeds back to the seller.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

profileIdinteger · max: 2147483647Required

isPositivebooleanRequired

amountinteger · max: 9007199254740991Required

minimumVotePricestringRequired

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

hashstringRequired

0x-prefixed 32-byte transaction hash (keccak256)

processedbooleanRequired

Whether the market sell 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/markets/sell

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

{
  "profileId": 1,
  "isPositive": true,
  "amount": 1,
  "minimumVotePrice": "text",
  "waitForTxTimeoutSeconds": 5
}

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

Open a position on a v2 market via Ethos Everywhere wallet

post

Submits an openPosition transaction on the EthosMarket contract 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

marketOnchainIdinteger · max: 9007199254740991Required

isPositivebooleanRequired

paymentAmountstringRequired

minTokensOutstringRequired

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

hashstringRequired

0x-prefixed 32-byte transaction hash (keccak256)

processedbooleanRequired

Whether the v2 market open position 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/markets-v2/open-position

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

{
  "marketOnchainId": 1,
  "isPositive": true,
  "paymentAmount": "text",
  "minTokensOut": "text",
  "waitForTxTimeoutSeconds": 5
}

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

Close a position on a v2 market via Ethos Everywhere wallet

post

Submits a closePosition transaction on the EthosMarket contract using the user’s Ethos Everywhere wallet. Burns position tokens and returns MMB credits. > ⚠️ 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

marketOnchainIdinteger · max: 9007199254740991Required

isPositivebooleanRequired

positionTokenAmountstringRequired

minCreditsOutstringRequired

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

hashstringRequired

0x-prefixed 32-byte transaction hash (keccak256)

processedbooleanRequired

Whether the v2 market close position 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/markets-v2/close-position

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

{
  "marketOnchainId": 1,
  "isPositive": true,
  "positionTokenAmount": "text",
  "minCreditsOut": "text",
  "waitForTxTimeoutSeconds": 5
}

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

Send MMB via Ethos Everywhere wallet

post

Submits an MMB transfer using the user 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

recipientstringRequired

Ethereum address (0x-prefixed, 20 bytes)

amountstringRequired

Responses

200

Successful response

application/json

hashstringRequired

0x-prefixed 32-byte transaction hash (keccak256)

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/mmb/send

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

{
  "recipient": "text",
  "amount": "text"
}

{
  "hash": "text"
}

PreviousVouches NextXp

Last updated 4 days ago