logo
API docs by Redocly

Roll App (1.0.0)

Download OpenAPI specification:Download

E-mail: [email protected] URL: http://tryroll.com/ License: Apache 2.0 Terms of Service

Documentation to access api powering Roll app by third-party applications. You can find a reference example app implementation here. If you wish to register as a third-party developer on Roll, you can apply here. Error codes can be one as following:

  > Possible Error Codes
  Invalid Oauth Token: 1001         | HTTP 401
  Invalid API Key: 1002             | HTTP 401
  Insufficient Permissions: 1003    | HTTP 403
  Invalid request body: 1005        | HTTP 400
  Invalid request parameter: 1006   | HTTP 400
  Record not found: 1004            | HTTP 400
  Unexpected error: 1006            | HTTP 500
Reference Application

Balance

Operations to get Roll token balances

Check if user has a certain balance of a specific token

Retrieve information about the user's balance for a specific token.

Authorizations:
oauth2_client_credentials
path Parameters
userID
required
string

The ID of the user.

tokenID
required
string

The ID of the token.

amount
required
number <double>

The amount to check for.

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "error": "string"
}

Get user token balances

Retrieve token balances for a specific user.

Authorizations:
oauth2_client_credentials
path Parameters
userID
required
string

The ID of the user.

Responses

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "error": "string"
}

Get user balance

Authorizations:
oauth2_client_credentials
path Parameters
userID
required
string

The user's unique identifier

tokenID
required
string

The token's unique identifier

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "error": "string"
}

Token

Operations to get Roll token information

Get tokens

Retrieve information about tokens.

Authorizations:
None
query Parameters
symbol
string

Filter tokens by symbol.

limit
integer <int32>

Limit the number of tokens to be retrieved.

offset
integer <int32>

Offset for the tokens to be retrieved.

contractAddress
string

Filter tokens by contract address.

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "errors": "string"
}

Get token creator information

Retrieve information about the creator of a specific token.

Authorizations:
None
path Parameters
tokenID
required
string

The ID of the token.

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "error": "string"
}

Transaction

Operations to perform transactions on Roll

Get a transaction by ID

Authorizations:
oauth2_authorization_code
path Parameters
transactionID
required
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "error": null
}

Send a transaction

Authorizations:
oauth2_authorization_code
Request Body schema: application/json
toUsername
required
string
tokenID
required
string
amount
required
string
message
string

Responses

Request samples

Content type
application/json
{
  • "toUsername": "rollusername",
  • "tokenID": "aaa-aaa",
  • "amount": "100",
  • "message": "some message"
}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "error": null
}

User

Operations to get Roll user information

Get a user by ID

Authorizations:
oauth2_client_credentials
path Parameters
userID
required
string

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "error": null
}

Get current logged-in user information

Authorizations:
oauth2_client_credentials

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "error": null
}