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 }
- 持仓量 = data / (10^token_decimals)
Fan票转账
- 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转账
- 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 } ] } }