{"openapi":"3.0.3","info":{"title":"UAS Gold API","version":"1.0.0","description":"Offer gold-backed savings in your app: your users buy UAS (United Africa Shilling), a digital currency backed by physical gold and redeemable for gold, from their own wallets. You can earn up to 1% on each buy, paid to your wallet in the same transaction. Non-custodial: we never hold user funds.","termsOfService":"https://unitedafricashilling.com/gold-price/terms/","contact":{"email":"support@unitedafricashilling.com"}},"servers":[{"url":"https://unitedafricashilling.com/api/gold/v1"}],"paths":{"/prices":{"get":{"operationId":"goldPrices","summary":"Gold per gram in 24 currencies and the UAS redemption terms","responses":{"200":{"description":"prices"}}}},"/quote":{"get":{"operationId":"goldQuote","summary":"What a SOL amount buys, its gold value at today's rate, and your commission","parameters":[{"name":"sol","in":"query","required":true,"schema":{"type":"number"}},{"name":"partner","in":"query","schema":{"type":"string"}},{"name":"partnerFeeBps","in":"query","schema":{"type":"integer","minimum":0,"maximum":100,"description":"your commission in basis points (100 = 1%), paid by the buyer straight to your wallet"}}],"responses":{"200":{"description":"quote"}}}},"/buy/build":{"post":{"operationId":"goldBuyBuild","summary":"Unsigned transaction for the buyer's wallet (valid 120 s)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["sol","wallet"],"properties":{"sol":{"type":"number"},"wallet":{"type":"string"},"partner":{"type":"string"},"partnerFeeBps":{"type":"integer","minimum":0,"maximum":100,"description":"your commission in basis points (100 = 1%), paid by the buyer straight to your wallet"},"accept":{"type":"boolean"}}}}}},"responses":{"200":{"description":"{id, tx, quote}"}}}},"/buy/submit":{"post":{"operationId":"goldBuySubmit","summary":"Send the signed transaction","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["id","tx"],"properties":{"id":{"type":"string"},"tx":{"type":"string"}}}}}},"responses":{"200":{"description":"{signature}"}}}},"/buy/confirm":{"post":{"operationId":"goldBuyConfirm","summary":"Record an order the wallet sent itself","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["id","signature"],"properties":{"id":{"type":"string"},"signature":{"type":"string"}}}}}},"responses":{"200":{"description":"{signature}"}}}},"/balance":{"get":{"operationId":"goldBalance","summary":"UAS held and its gold value at today's redemption rate","parameters":[{"name":"wallet","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"balance"}}}},"/sell/quote":{"get":{"operationId":"goldSellQuote","summary":"Sell UAS for SOL (quote)","parameters":[{"name":"uas","in":"query","required":true,"schema":{"type":"number"}}],"responses":{"200":{"description":"quote"}}}},"/sell/build":{"post":{"operationId":"goldSellBuild","summary":"Sell UAS for SOL (unsigned transaction)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["uas","wallet"],"properties":{"uas":{"type":"number"},"wallet":{"type":"string"},"slippageBps":{"type":"integer"}}}}}},"responses":{"200":{"description":"{id, tx}"}}}},"/sell/submit":{"post":{"operationId":"goldSellSubmit","summary":"Send a signed sell","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["id","tx"],"properties":{"id":{"type":"string"},"tx":{"type":"string"}}}}}},"responses":{"200":{"description":"{signature}"}}}},"/partners":{"get":{"operationId":"goldPartners","summary":"Live public commission board","responses":{"200":{"description":"board"}}}}}}