> ## Documentation Index
> Fetch the complete documentation index at: https://getequity.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Buy token

> Allows an api client purchase token on the GE platform

<ParamField path="id" type="string" required>
  The id of the token to buy
</ParamField>

<ParamField body="amount" type="integer" required>
  The quantity of token to buy
</ParamField>

<ParamField body="price" type="integer" required>
  The price per unit of each token
</ParamField>

<ParamField body="currency" type="string" required>
  The currency to use for the transaction. It must be one of the following: `USD`, `NGN`,`KES`
</ParamField>

<ParamField body="customer" type="object" required>
  Object containing customer details
</ParamField>

<ParamField body="meta" type="object">
  Object containing additional information like `tokens` and `amount`
</ParamField>

<RequestExample>
  ```json theme={null}
  {
      "amount": 20,
      "price": 10,
      "currency": "USD",
      "customer": {
          "name": "Rema divine1",
          "email": "rema2@yopmail.com"
      },
      "meta": {   
          "tokens": 2
      }
  }
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "status": "success",
    "message": "Buy order is being processed",
    "data": null
  }
  ```
</ResponseExample>