www.eater.fish

wyatt's wacky website

featured art: "contact pigeon" by fisheater

fishcoins api

• responses are in JSON
• the base url is /fishcoin/api (PHP implementation in backend/fishcoin-api.php)

endpoints

✎ generate your wallet

?genwallet&name=<wallet holder name>

• each wallet begins with no fishcoin, a wallet name, and a wallet key. do not lose it!
• names are 20 char max, letters only, and must be original
• success response:

 "wallet_key": "<key>" 

• fail response:

   "error": "invalid_name" 

↙ collect payment

?collect&key=<your wallet key>&code=<code>

• collect payments using codes
• success response:

  
    "new_balance": <amount>,
    "amount_received": <value>,
    "receipt_message": "<optional receipt message>",
    "receipt_img": "<optional receipt image>"
  

• fail responses:

   "error": "code_not_found" 

   "error": "code_yields_no_coins" 

   "error": "wallet_not_found" 

   "error": "code_already_used" 

↗ generate payment code

?genpaycode&key=<your wallet key>&amount=<amount>&receipt-message=<receipt-msg>&receipt-img=<img-id>&equation=<equation>

• equations determine the final amount that each code brings. see the equation documentation for more info.
• if not using the wrapper, the images must be uploaded beforehand using the image upload tool
• success response:

   "code": "<code>" 

• fail responses:

   "error": "invalid_amount_or_equation" 

   "error": "invalid_key" 

   "error": "invalid_image_id" 

? gather information

?inquire&search=<search>

• enter a name to see their amount and rank, enter a wallet key to see your receipts, or enter a code to see what it's worth.
• search wallet name

  
    "wallet": "<name>",
    "fishcoins": <amount>,
    "rank": <rank>,
    "total_wallets": <total>
  

• search wallet key

  
    "name": "<wallet_name>",
    "receipts": [
        
            "receipt_message": "<optional_message>",
            "receipt_img": "<optional_image>",
            "timestamp": "<timestamp>",
            "peer": "<peer_wallet>",
            "amount": <value>
        
    ]
  
  

• search payment code

  
    "creator": "<creator wallet>",
    "value": <value>
  

• fail response:

   "error": "not found" 

x remove payment code

?deletecode&code=<code>&key=<creator_wallet_key>

• deletes a payment code, useful for keeping the systems efficient.
• if you're creating an application that utilizes this api, consider deleting codes when they're no longer useful.
• success response:

   "success": "code deleted successfully" 

• fail responses:

   "error": "missing parameters. required: code, wallet_key." 

   "error": "code not found." 

   "error": "unauthorized. invalid wallet key." 

extras (gambling, screensaver, …)

?extra&type=<name>&…params…

• same URL shape as the old site (extra with an empty value, then type and game params)
• slots: key, bet (min 300), spins (1–20) → ❴ "multipliers": [ … ] ❵
• plinko: key, bet, balls (1–50), risk (low | medium | high) → ❴ "multipliers": [ … ] ❵
• screensaver: action = start | pos | end (plus wallet, auth on start; id, sec on pos; id on end)
• implementation: backend/fishcoin/gambling/ (called from backend/fishcoin-api.php)

other (useful?) general info

• every payment code is a 9-character alpha-numeric string
• each wallet key is a 20-character alpha-numeric string
• the equations to determine amount are very powerful. you can use them to distribute things like freebies
• there are some freebie codes located around the website. they can be used once per wallet and will come from the mint until it runs dry.
• each wallet maintains a list of receipts for every transaction. you can see what each receipt includes in the example in gather information

^{thanks for visiting}

click here to write out some good comments

• page last edited 5/22/26
• site last updated 5/24/26 - commit #50 - revert

what are those?

they are called 88x31 buttons, they used to be a staple of the old web. now, they are used to promote various things on cool persons (including me) websites.

• hover over them to see some explanation

comments for FISHCOIN—api (0)

sort: newest top oldest

fishcoin members only! enter your key

send key what's a fishcoin?

⚠ important security warning from fisheater

NEVER give your wallet key to wilfred!

he made this whole comments thing as a ruse....

by sending him your key he will remember it...

no comments yet. be the first!