Fan 票系统

fan 票列表

  • GET /token/all
  • 参数:
    • page 默认值 1
    • pagesize 默认值 20
    • sort 排序方式,可选值:
      • general:综合排序
      • unit-price-(desc|asc):单价排序
      • liquidity-(desc|asc):流动金排序
      • exchange-(desc|asc):24h 成交量排序
      • name-(desc|asc):首字母排序
      • time-(desc|asc):时间排序
  • 返回数据
{
    "code": 0,
    "message": "成功",
    "data": {
        "count": 38,
        "list": [
            {
                "id": 22,
                "uid": 526,
                "name": "岛岛币",
                "symbol": "DAO",
                "decimals": 4,
                "total_supply": 260000000,
                "create_time": "2019-09-30T10:37:15.000Z",
                "status": 1,
                "logo": "/image/2019/09/30/f6bb15a48c91bb872045c471bf45af07.png",
                "brief": "xxx",
                "introduction": "xxxx",
                "contract_address": "0x280Be10b609F95f70E82c0D7151543f59102f47D",
                "username": "lychees",
                "nickname": "xiaodao",
                "avatar": "/avatar/2019/07/12/d0c1f59b794f1dd9437c84af8cc57b6e.png",
                "amount": 81577552,
                "liquidity": 137933397,
                "exchange_amount": 245069,
                "member": "0"
            }
        ]
    }
}

Fan 票的信息

  • GET /minetoken/{tokenId}

  • 参数:

    • tokenId
  • 返回数据:

    • token 总发行量:token.total_supply / (10^token.decimals)

    • token 合约地址:token.contract_address

    • token 现价:exchange.price(单位 cny)

    • 流动金池:

      • CNY 流动金:exchange.cny_reserve /(10^token.decimals)
      • token 流动金:exchange.token_reserve / (10^token.decimals)
    • 24h 成交量

      • token 成交量:exchange.volume_24h / (10^token.decimals)
      • cny 成交额:exchange.amount_24h / (10^token.decimals)
    • 24h 成交量涨跌幅:exchange.change_24h

{
    "code": 0,
    "message": "成功",
    "data": {
        "user": {
            "id": 526,
            "username": "lychees",
            "platform": "github",
            "password_hash": null,
            "email": "",
            "nickname": "xiaodao",
            "avatar": "/avatar/2019/07/12/d0c1f59b794f1dd9437c84af8cc57b6e.png",
            "create_time": "2019-07-05T12:59:41.000Z",
            "introduction": "一個弱菜。",
            "accept": 1,
            "source": "ss",
            "reg_ip": null,
            "last_login_time": "2020-06-10T23:59:36.000Z",
            "is_recommend": 1,
            "referral_uid": 0,
            "last_login_ip": "127.0.0.1",
            "level": 1,
            "status": 3,
            "banner": "/banner/2019/12/06/cb68b9c2f06b5390cdbc8d32db0d1e57.jpeg"
        },
        "token": {
            "id": 22,
            "uid": 526,
            "name": "岛岛币",
            "symbol": "DAO",
            "decimals": 4,
            "total_supply": 260000000,
            "create_time": "2019-09-30T10:37:15.000Z",
            "status": 1,
            "logo": "/image/2019/09/30/f6bb15a48c91bb872045c471bf45af07.png",
            "brief": "和我签订契约,成为魔法少女。",
            "introduction": "韵文在整个安琪拉里流淌,穿过每一个波浪,\n穿过每一个生命,韵文使我们成为一个整体。\n韵文约束着我们,约束着叙述者和探险者。\n我的故事将(会)成为你自己的故事,同时你的也会成为我的。\n你会通过我的眼睛经历我的一生....\n你也会认识到真理。",
            "contract_address": "0x280Be10b609F95f70E82c0D7151543f59102f47D"
        },
        "exchange": {
            "id": 36,
            "token_id": 22,
            "total_supply": 33262079,
            "create_time": "2019-11-30T09:25:59.000Z",
            "exchange_uid": 1072,
            "token_reserve": 81577552,
            "cny_reserve": 137933397,
            "volume_24h": 144762,
            "change_24h": 0.001722173464399639,
            "price": 1.6908,
            "amount_24h": 245069
        }
    }
}

查看用户发行的 fan 票

  • GET token/user/{userId}
  • 返回数据
{
    "code": 0,
    "message": "成功",
    "data": {
        "id": 44,
        "uid": 23,
        "name": "稳定币",
        "symbol": "DAI",
        "decimals": 4,
        "total_supply": 1000000000,
        "create_time": "2020-01-03T04:32:56.000Z",
        "status": 1,
        "logo": "/image/2020/01/03/882a27ba3e8a1b93a1ce66b05cdb6173.jpeg",
        "brief": "加油!奥力给!",
        "introduction": "",
        "contract_address": "0x4897835C0657A8d27b3Ab22AA3f09b49Ca4550d0"
    }
}

Fan 票持仓列表

  • GET /token/{tokenId}/balances
  • 参数:
    • pagesize 默认值 10
    • page 默认值 1
    • sort 排序方式
      • amount-(desc|asc) 持仓量排序
      • name-(desc|asc) 姓名排序
  • 返回数据
{
    "code": 0,
    "message": "成功",
    "data": {
        "count": 197,
        "list": [
            {
                "id": 506,
                "uid": 1072,
                "token_id": 22,
                "amount": 81577552,
                "total_supply": 260000000,
                "username": "exchange_DAO",
                "nickname": null,
                "avatar": "/avatar/exchange.png"
            }
        ]
    }
}

流动金持仓列表

  • GET /token/{tokenId}/liquidity/balances
  • 其他同【Fan 票持仓列表】

Fan 票流水列表

  • GET /token/{tokenId}/transactions
  • 参数:
    • pagesize 默认值 10
    • page 默认值 1
  • 返回数据
{
    "code": 0,
    "message": "成功",
    "data": {
        "count": 838,
        "list": [
            {
                "token_id": 22,
                "from_uid": 1072,
                "to_uid": 2331,
                "amount": 134762,
                "create_time": "2020-06-11T04:39:53.000Z",
                "type": "exchange_purchase",
                "tx_hash": "0x740ad9ec829513d583882441584374789175a1d4f332a39450e7eac50268c43b",
                "name": "岛岛币",
                "symbol": "DAO",
                "decimals": 4,
                "from_username": "exchange_DAO",
                "from_nickname": null,
                "from_avatar": "/avatar/exchange.png",
                "to_username": "pengan1987",
                "to_nickname": "pengan",
                "to_avatar": "/avatar/2020/06/06/50916d14ec93e5860129db6d17653a28.jpg"
            }
        ]
    }
}

流动金流水列表

  • GET /token/{tokenId}/liquidity/transactions
  • 其他同【Fan 票流水列表】

fan 票相关创作列表

  • GET /minetoken/{tokenId}/related
  • 参数:
    • page: 1
    • pagesize: 10
    • filter:
      • 1: 持票可见
      • 2: 付费可见
      • 3: 持票可见 + 付费可见
    • sort:
      • time-desc: 时间降序
      • popular-desc: 热度降序
  • 返回数据:
{
    "code": 0,
    "message": "成功",
    "data": {
        "count": 65,
        "list": [
            {
                "id": 4331,
                "uid": 526,
                "author": "lychees",
                "title": "Defi Billboard Design Doc",
                "hash": "QmTHs6vyZqPzE4SP6zpsNK8P7pzQUkibLeYgKiHd5NXmMn",
                "create_time": "2020-06-11T04:42:26.000Z",
                "cover": "/image/2020/06/11/357064a8ff7856c838e50dd7bbc5664d.png",
                "require_holdtokens": 1,
                "require_buy": 0,
                "short_content": "。",
                "nickname": "xiaodao",
                "avatar": "/avatar/2019/07/12/d0c1f59b794f1dd9437c84af8cc57b6e.png",
                "read": 4,
                "likes": 3,
                "pay_platform": null,
                "pay_symbol": null,
                "pay_price": null,
                "pay_decimals": null,
                "pay_stock_quantity": null,
                "token_id": 22,
                "token_amount": 1000000,
                "token_name": "岛岛币",
                "token_symbol": "DAO",
                "token_decimals": 4,
                "tags": []
            }
        ]
    }
}

查看我当前 token 的持仓

  • GET /minetoken/balance
  • 参数:
    • tokenId
  • Headers
    • x-access-token: 用户登录的 accessToken
  • 返回数据
    • 持仓量 = data / (10^token_decimals)
{
    "code": 0,
    "message": "成功",
    "data": 111434
}

Fan 票转账

2020-06-19-16-04-13

  • POST /minetoken/transfer
  • Headers
    • x-access-token: 用户登录的 accessToken
  • request body
    • tokenId:fan 票 id
    • to: 转给的用户 id
    • amount: 转账数量
    • memo: 转账留言
{
    "tokenId":14,
    "to":38,
    "amount":10000,
    "memo": "奥利给"
}
  • 返回数据 tx_hash 为交易成功的链上 hash
{
    "code":0,
    "message":"成功",
    "data":{
        "tx_hash":"0xebd43a6af34dea4004f75134d0a65db3f42a48104165b85e4bda552325cce0ca"
    }
}

CNY 转账

2020-06-19-16-05-54

  • POST /asset/transfer
  • Headers
    • x-access-token: 用户登录的 accessToken
  • request body
{"symbol":"CNY","to":38,"amount":100}
  • 返回数据
{"code":0,"message":"成功"}

查看我所有 fan 票的交易日志记录

  • GET /token/allLogs
  • 参数:
    • pagesize: 默认 10(可选)
    • page: 默认 1(可选)
    • type(可选)可选值如下
      • mint: 增发,
      • transfer: 转账,
      • exchange_purchase: 交易所购买,
      • exchange_addliquidity: 添加流动金',
      • exchange_removeliquidity: 删除流动金,
      • reward_article: 打赏文章,
      • pay_article: 支付文章,
  • Headers
    • x-access-token: 用户登录的 accessToken
  • 返回数据
    • post_id: 文章 id
    • title: 文章名
    • cover: 文章封面
    • memo: 交易 memo
{
    "code": 0,
    "message": "成功",
    "data": {
        "count": 125,
        "list": [
            {
                "token_id": 14,
                "from_uid": 1042,
                "to_uid": 1105,
                "amount": 10000,
                "create_time": "2020-07-07T20:13:52.000Z",
                "type": "reward_article",
                "tx_hash": "0x119676a8937866c9b45d0d1f4600f98eaf8c923bad306aa309d1b90027473d6d",
                "post_id": 102024,
                "memo": "测试冲冲冲",
                "name": "小田的空气币",
                "symbol": "XTB",
                "decimals": 4,
                "from_username": "sh****eo@163.com",
                "from_nickname": "天下第一",
                "from_avatar": "/avatar/2019/10/16/9eff045272a135e771b60f5bb3badd89.png",
                "to_username": "gu*****o71@hotmail.com",
                "to_nickname": "林可MATATAKI",
                "to_avatar": "/avatar/2019/11/07/740fd91594538dbe1f016bd301e7e234.jpg",
                "title": "123123",
                "cover": "/image/2020/06/29/e85a24054d5f4780d3bceca9748956de.jpg"
            },
        ]
    }
}

查看我所有 fan 票的流动金日志记录

  • GET /token/allLiquidityLogs
  • 参数:
    • pagesize: 默认 10(可选)
    • page: 默认 1(可选)
    • type(可选)可选值如下
      • exchange_addliquidity: 添加流动金',
      • exchange_removeliquidity: 删除流动金,
  • Headers
    • x-access-token: 用户登录的 accessToken
  • 返回数据
{
    "code": 0,
    "message": "成功",
    "data": {
        "count": 1,
        "list": [
            {   "id": 69,
                "uid": 1042,
                "token_id": 18,
                "cny_amount": 100,
                "token_amount": 3534,
                "liquidity": 9,
                "create_time": "2020-06-02T00:52:21.000Z",
                "name": "林小可",
                "symbol": "LLKT",
                "decimals": 4,
                "total_supply": 10000000,
                "logo": "/image/2019/10/11/d55345c66f1f620ba2418dd5f3f58964.jpg",
                "username": "gu*****o71@gmail.com",
                "nickname": "007"
            },
        ]
    }
}

查看 fan 票历史价格

  • GET /history/price?tokenId=14
  • 参数:
    • tokenId
  • 返回数据
    • obj: 价格的对象形式
    • arr: 价格的数组形式
{
    "code": 0,
    "message": "成功",
    "data": {
        "obj": {
            "2020-07-14": 0.4031
        },
        "arr": [
            {
                "time": "2020-07-14",
                "price": 0.4031
            }
        ]
    }
}
Last Updated:
Contributors: xiaotian